Класс AccessController

Класс AccessController используется для операций и решений по управлению доступом.

Более конкретно, класс AccessController используется для трёх целей:

• определение, разрешить или запретить доступ к критической системе ресурсов, основываясь на действующей политике безопасности,
• пометить код как «привилегированный», тем самым повлиять на последующие решения по доступу, и
• получение «моментального снимка» текущего контекста вызова для принятия решений о доступе из другого контекста с учётом сохранённого контекста.

Метод checkPermission определяет, должно ли быть предоставлено или отказано в доступе в соответствии с запросом, указанным заданной разрешительной строкой. Пример вызова показан ниже. В этом примере checkPermission определит, разрешить ли «чтение» файла с именем «testFile» в каталоге «/temp».

 FilePermission perm = new FilePermission("/temp/testFile", "read");
 AccessController.checkPermission(perm);

 

Если запрашиваемый доступ разрешён, checkPermission возвращается без действий. Если он запрещён, выбрасывается исключение AccessControlException. AccessControlException также может быть выброшено, если запрашиваемая разрешительная строка имеет неправильный тип или содержит недопустимое значение. Такая информация предоставляется всякий раз, когда это возможно. Предположим, что текущий поток прошёл через m вызывающих объектов в порядке от вызывающего объекта 1 до вызывающего объекта 2 до вызывающего объекта m. Затем вызывающий объект m вызвал метод checkPermission. Метод checkPermission определяет, предоставлен доступ или нет, на основании следующего алгоритма:

 
 for (int i = m; i > 0; i--) {

     if (caller i's domain does not have the permission)
         throw AccessControlException

     else if (caller i is marked as privileged) {
         if (a context was specified in the call to doPrivileged)
             context.checkPermission(permission)
         if (limited permissions were specified in the call to doPrivileged) {
             for (each limited permission) {
                 if (the limited permission implies the requested permission)
                     return;
             }
         } else
             return;
     }
 }

 // Next, check the context inherited when the thread was created.
 // Whenever a new thread is created, the AccessControlContext at
 // that time is stored and associated with the new thread, as the
 // "inherited" context.

 inheritedContext.checkPermission(permission);
 

Вызывающий объект может быть помечен как «привилегированный» (см. doPrivileged и ниже). При принятии решений о доступе метод checkPermission прекращает проверку, если достигает вызывающего объекта, который был помечен как «привилегированный» с помощью вызова doPrivileged без аргумента контекста (см. ниже информацию об аргументе контекста). Если область вызывающего объекта имеет указанную разрешительную строку и по крайней мере один аргумент ограничивающей разрешительной строки (если таковой имеется) подразумевает запрашиваемую разрешительную строку, дальнейшая проверка не выполняется и checkPermission возвращается без действий, указывая, что запрашиваемый доступ разрешён. Если у области вызывающего объекта нет указанной разрешительной строки, выбрасывается исключение, как обычно. Если у области вызывающего объекта была указанная разрешительная строка, но она не подразумевалась никакими аргументами ограничивающей разрешительной строки, переданными в вызов doPrivileged, проверка разрешений продолжается до тех пор, пока не останется больше вызывающих объектов или другой вызов doPrivileged не соответствует запрашиваемой разрешительной строке и не вернётся без ошибок.

Обычное использование функции «привилегий» следующее. Если вам не нужно возвращать значение из блока «привилегий», сделайте следующее:

 
 somemethod() {
     ...normal code here...
     AccessController.doPrivileged(new PrivilegedAction<Void>() {
         public Void run() {
             // privileged code goes here, for example:
             System.loadLibrary("awt");
             return null; // nothing to return
         }
     });
     ...normal code here...
 }

PrivilegedAction — это интерфейс с одним методом с именем run. Приведённый пример демонстрирует создание реализации этого интерфейса; конкретная реализация метода run предоставляется. При выполнении вызова doPrivileged передаётся экземпляр реализации PrivilegedAction. Метод doPrivileged вызывает метод run из реализации PrivilegedAction после включения привилегий и возвращает возвращаемое значение метода run в качестве возвращаемого значения doPrivileged (которое игнорируется в этом примере).

Если вам нужно вернуть значение, вы можете сделать что-то вроде следующего:

 
 somemethod() {
     ...normal code here...
     String user = AccessController.doPrivileged(
         new PrivilegedAction<String>() {
         public String run() {
             return System.getProperty("user.name");
             }
         });
     ...normal code here...
 }

Если действие, выполняемое в методе run, может вызвать «проверяемое» исключение (те, которые перечислены в пункте throws метода), тогда вам нужно использовать интерфейс PrivilegedExceptionAction вместо интерфейса PrivilegedAction.

 
 somemethod() throws FileNotFoundException {
     ...normal code here...
     try {
         FileInputStream fis = AccessController.doPrivileged(
         new PrivilegedExceptionAction<FileInputStream>() {
             public FileInputStream run() throws FileNotFoundException {
                 return new FileInputStream("someFile");
             }
         });
     } catch (PrivilegedActionException e) {
         // e.getException() should be an instance of FileNotFoundException,
         // as only "checked" exceptions will be "wrapped" in a
         // PrivilegedActionException.
         throw (FileNotFoundException) e.getException();
     }
     ...normal code here...
  }

Будьте *очень* внимательны при использовании конструкции «привилегии» и всегда помните, чтобы сделать раздел привилегированного кода как можно меньше. Вы можете передать Permission аргументы, чтобы дополнительно ограничить область «привилегии» (см. ниже).

Обратите внимание, что checkPermission всегда выполняет проверки безопасности в контексте текущего потока. Иногда проверка безопасности, которая должна выполняться в заданном контексте, фактически должна выполняться в другом контексте (например, в потоке обработки). Для этой ситуации предоставляются метод getContext и класс AccessControlContext. Метод getContext создаёт «моментальный снимок» текущего контекста вызова и помещает его в объект AccessControlContext, который он возвращает. Пример вызова:

 AccessControlContext acc = AccessController.getContext()

 

Сам AccessControlContext имеет метод checkPermission, который принимает решения о доступе, основанные на контексте, который он оборачивает, а не на контексте текущего потока. Код в другом контексте может, таким образом, вызвать этот метод в объекте ранее сохранённого AccessControlContext. Пример вызова:

 acc.checkPermission(permission)

 

Иногда вы не знаете заранее, какие разрешения следует проверить в контексте. В таких случаях вы можете использовать метод doPrivileged, который принимает контекст. Вы также можете ограничить область привилегированного кода, передавая дополнительные Permission параметры.

 
 somemethod() {
     AccessController.doPrivileged(new PrivilegedAction<Object>() {
         public Object run() {
             // Code goes here. Any permission checks within this
             // run method will require that the intersection of the
             // caller's protection domain and the snapshot's
             // context have the desired permission. If a requested
             // permission is not implied by the limiting FilePermission
             // argument then checking of the thread continues beyond the
             // caller of doPrivileged.
         }
     }, acc, new FilePermission("/temp/*", read));
     ...normal code here...
 }

Передача ограничивающего Permission аргумента экземпляра AllPermission эквивалентна вызову эквивалентного метода doPrivileged без ограничивающих Permission аргументов. Передача массива нулевой длины Permission отключает привилегии кода, так что проверка всегда продолжается за пределами вызывающего объекта данного метода doPrivileged.