Класс 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.