java.security
클래스 AccessController

java.lang.Object 
  java.security.AccessController

public final class AccessController
extends Object 

AccessController 클래스는 액세스 제어의 조작과 결정에 사용됩니다.

구체적으로는 AccessController 클래스를 다음의 3개의 목적으로 사용합니다.

• 현재 유효한 시큐러티 정책에 기반해 중요한 system resource에의 액세스가 허가되는지, 거부될까를 결정한다

• 코드를 「특권」이 주어진 것으로서 마크 해, 이후의 액세스의 결정에 영향을 준다

• 액세스 제어가 보존한 컨텍스트에 관해서 준비되는 다른 컨텍스트 으로부터 결정할 수 있도록, 현재의 호출측 컨텍스트 의 「snapshot」를 취득한다

checkPermission 메서드는 지정한 접근 권한에 의해 나타나는 액세스 요구가 허가되는지, 거부될까를 결정합니다. 호출의 예를 다음에 나타냅니다. 이 예에서는 checkPermission는 /temp 디렉토리의 testFile 라고 하는 파일에의 읽기 권을 허가할지 어떨지를 결정합니다.

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

요구된 액세스가 허가되는 경우에는 checkPermission는 아무것도 하지 않고 복귀합니다. 액세스가 거부되는 경우에는 AccessControlException가 발생 됩니다. AccessControlException는 요구된 접근 권한이 부정한 형태이거나 무효인 값을 포함해 있거나 했을 경우에도 Throw 될 가능성이 있습니다. 가능한 경우에는 그러한 정보가 제공됩니다. 여기서, 현재의 thread가 m개의 호출원을 호출원 1 으로부터 시작해 호출해 원 m 까지 처리해, 호출원 m가 checkPermission 메서드를 호출했다고 합니다. 이 때, checkPermission 메서드는 다음의 알고리즘에 기반해 액세스가 허가될까 거부될까를 결정합니다.

 i = m;
 
 while (i > 0) {
 
      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)
              return;
      }
      i = i - 1;
 };

    // 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는 아무것도 하지 않고 복귀해, 요구한 액세스가 허가된 것을 나타냅니다. 그 영역으로 지정된 접근 권한이 없는 경우에는 보통 대로 예외가 발생 됩니다.

이하에 특권 기능의 보통 의 사용법을 설명합니다. 특권 블록내로부터 값을 돌려줄 필요가 없는 경우에는 다음과 같이 기술합니다.

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

PrivilegedAction는 Object를 돌려주는 run 라고 하는 메서드를 가지는 인터페이스입니다. 상기의 예는 그 인터페이스의 구현의 작성 방법을 나타내고 있습니다. 즉, run 메서드의 고정 구현이 제공됩니다. doPrivileged가 불려가 면, 그 doPrivileged에 PrivilegedAction 구현의 인스턴스가 건네받습니다. doPrivileged 메서드는 특권을 유효하게 한 후에 PrivilegedAction 구현으로부터 run 메서드를 호출해, run 메서드의 반환값을 doPrivileged 반환값 (상기의 예에서는 무시되고 있다)으로서 리턴합니다.

값을 돌려줄 필요가 있는 경우에는 다음과 같이 기술합니다.

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

run 메서드로 실행한 액션이 「체크된다」예외 (메서드의 throws 절에 기재되어 있는 예외)를 Throw 할 가능성이 있는 경우에는 PrivilegedAction인터페이스 대신에 PrivilegedExceptionAction인터페이스를 사용할 필요가 있습니다.

   somemethod() throws FileNotFoundException {
        ...normal code here...
      try {
        FileInputStream fis = (FileInputStream) AccessController.doPrivileged(          new PrivilegedExceptionAction() {
            public Object 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...
  }
 

특권 구조의 사용에는 세심의 주위를 기울여, 특권 코드 섹션을 가능한 한 작게의해 주세요.

checkPermission는 항상 현재 실행하고 있는 thread의 컨텍스트 내에서 시큐러티 체크를 실시합니다. 그러나 실제로는 지정된 컨텍스트 내에서 실시하는 시큐러티 체크를, 「다른」컨텍스트 내로부터 (예를 들어 워크스 레드내로부터) 실시하지 않으면 안 되는 경우도 있습니다. 이 상황에 대응하기 위해서 getContext 메서드와 AccessControlContext 클래스가 제공되고 있습니다. getContext 메서드는 현재의 호출측 컨텍스트 의 「snapshot」를 취득해, 이 메서드가 돌려주는 AccessControlContext 객체에 그 컨텍스트를 넣습니다. 이하에 호출의 예를 나타냅니다.

 
   AccessControlContext acc = AccessController.getContext()
 
 

AccessControlContext 에는 현재 실행중의 thread의 컨텍스트은 아니고, AccessControlContext가 캡슐화하는 컨텍스트에 기반해 액세스를 결정하는 checkPermission 메서드가 있습니다. 따라서, 다른 컨텍스트 내의 코드는 이전에 보존한 AccessControlContext 객체의 checkPermission 메서드를 호출할 수 있습니다 . 이하에 호출의 예를 나타냅니다.

 
   acc.checkPermission(permission)
 
 

또, 컨텍스트를 어느 접근 권한으로 검사할지가 사전에는 불명한 경우가 있습니다. 이러한 경우에는 컨텍스트를 값으로 해서 받는 doPrivileged 메서드를 사용할 수 있습니다.

   somemethod() {
         AccessController.doPrivileged(new PrivilegedAction() {
              public Object run() {
                 // Code goes here.  Any permission checks within this
                 // run method will require that the intersection of the
                 // callers protection domain and the snapshot's
                 // context have the desired permission.
              }
         }, acc);
         ...normal code here...
   }
 

관련 항목:

AccessControlContext

메서드 개요

static void	checkPermission (Permission perm) 현재 유효한 시큐러티 정책에 기반해 지정된 접근 권한에 의해 나타나는 액세스 요구가 허가되는지, 거부될까를 결정합니다.
static <T> T	doPrivileged (PrivilegedAction <T> action) 유효하게 된 특권을 사용해, 지정된 PrivilegedAction을 실행합니다.
static <T> T	doPrivileged (PrivilegedAction <T> action, AccessControlContext context) 지정된 AccessControlContext에 의해 유효하게 되어, 한편 제한되는 특권을 사용해, 지정된 PrivilegedAction을 실행합니다.
static <T> T	doPrivileged (PrivilegedExceptionAction <T> action) 유효하게 된 특권을 사용해, 지정된 PrivilegedExceptionAction을 실행합니다.
static <T> T	doPrivileged (PrivilegedExceptionAction <T> action, AccessControlContext context) 지정된 AccessControlContext에 의해 유효하게 되어, 한편 제한되는 특권을 사용해, 지정된 PrivilegedExceptionAction을 실행합니다.
static AccessControlContext	getContext () 현재의 thread의 상속된 AccessControlContext를 포함한, 현재의 호출측 컨텍스트 의 「snapshot」를 취득해, AccessControlContext 객체에 배치합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

메서드의 상세

doPrivileged

public static <T> T doPrivileged(PrivilegedAction <T> action)

유효하게 된 특권을 사용해, 지정된 PrivilegedAction을 실행합니다. 액션은 호출측의 보호 영역에서 소유하고 있는 「모든」접근 권한을 사용해 실행됩니다.

액션의 run 메서드가 체크되지 않는 예외를 Throw 하면, 예외는 이 메서드를 사용해 보내집니다.

파라미터:

action - 실행되는 액션

반환값:

액션의 run 메서드에 의해 리턴된 값

예외:

NullPointerException - 액션이 null인 경우

관련 항목:

doPrivileged(PrivilegedAction, AccessControlContext), doPrivileged(PrivilegedExceptionAction)

doPrivileged

public static <T> T doPrivileged(PrivilegedAction <T> action,
                                 AccessControlContext  context)

지정된 AccessControlContext에 의해 유효하게 되어, 한편 제한되는 특권을 사용해, 지정된 PrivilegedAction을 실행합니다. 액션은 호출측의 보호 영역에서 소유하고 있는 접근 권한과 지정된 AccessControlContext에 의해 나타내지는 영역에서 소유하고 있는 접근 권한의 공통 부분을 사용해 실행됩니다.

액션의 run 메서드가 체크되지 않는 예외를 Throw 하면, 예외는 이 메서드를 사용해 보내집니다.

파라미터:

action - 실행되는 액션

context - 지정된 액션의 실행전에 호출해 옆의 영역의 특권에 적용해야 할 제한을 나타내는 「액세스 제어 컨텍스트 」. context가 null인 경우, 추가의 제한은 적용되지 않는다

반환값:

액션의 run 메서드에 의해 리턴된 값

예외:

NullPointerException - 액션이 null인 경우

관련 항목:

doPrivileged(PrivilegedAction), doPrivileged(PrivilegedExceptionAction, AccessControlContext)

doPrivileged

public static <T> T doPrivileged(PrivilegedExceptionAction <T> action)
                      throws PrivilegedActionException 

유효하게 된 특권을 사용해, 지정된 PrivilegedExceptionAction을 실행합니다. 액션은 호출측의 보호 영역에서 소유하고 있는 「모든」접근 권한을 사용해 실행됩니다.

액션의 run 메서드가 「체크되지 않는다」예외를 Throw 하면, 예외는 이 메서드를 사용해 보내집니다.

파라미터:

action - 실행되는 액션

반환값:

액션의 run 메서드에 의해 리턴된 값

예외:

PrivilegedActionException - 지정된 액션의 run 메서드가 「체크된다」예외를 Throw 했을 경우

NullPointerException - 액션이 null인 경우

관련 항목:

doPrivileged(PrivilegedAction), doPrivileged(PrivilegedExceptionAction, AccessControlContext)

doPrivileged

public static <T> T doPrivileged(PrivilegedExceptionAction <T> action,
                                 AccessControlContext  context)
                      throws PrivilegedActionException 

지정된 AccessControlContext에 의해 유효하게 되어, 한편 제한되는 특권을 사용해, 지정된 PrivilegedExceptionAction을 실행합니다. 액션은 호출측의 보호 영역에서 소유하고 있는 접근 권한과 지정된 AccessControlContext에 의해 나타내지는 영역에서 소유하고 있는 접근 권한의 공통 부분을 사용해 실행됩니다.

액션의 run 메서드가 「체크되지 않는다」예외를 Throw 하면, 예외는 이 메서드를 사용해 보내집니다.

파라미터:

action - 실행되는 액션

context - 지정된 액션의 실행전에 호출해 옆의 영역의 특권에 적용해야 할 제한을 나타내는 「액세스 제어 컨텍스트 」. context가 null인 경우, 추가의 제한은 적용되지 않는다

반환값:

액션의 run 메서드에 의해 리턴된 값

예외:

PrivilegedActionException - 지정된 액션의 run 메서드가 「체크된다」예외를 Throw 했을 경우

NullPointerException - 액션이 null인 경우

관련 항목:

doPrivileged(PrivilegedAction), doPrivileged(PrivilegedExceptionAction, AccessControlContext)

getContext

public static AccessControlContext  getContext()

현재의 thread의 상속된 AccessControlContext를 포함한, 현재의 호출측 컨텍스트 의 「snapshot」를 취득해, AccessControlContext 객체에 배치합니다. 이 컨텍스트은 나중에 다른 thread등으로 검사되는 경우가 있습니다.

반환값:

현재의 컨텍스트에 근거하는 AccessControlContext

관련 항목:

AccessControlContext

checkPermission

public static void checkPermission(Permission  perm)
                            throws AccessControlException 

현재 유효한 시큐러티 정책에 기반해 지정된 접근 권한에 의해 나타나는 액세스 요구가 허가되는지, 거부될까를 결정합니다. 이 메서드는 액세스 요구가 허가되는 경우에는 아무것도 하지 않고 복귀해, 그렇지 않은 경우에는 적절한 AccessControlException을 Throw 합니다.

파라미터:

perm - 요구 접근 권한

예외:

AccessControlException - 현재의 시큐러티 정책에 기반해 지정된 접근 권한이 허가되지 않는 경우

NullPointerException - 지정된 접근 권한이 null 이며, 그 접근 권한이 현재 유효한 시큐러티 정책에 근거해 체크되었을 경우