javax.security.auth
클래스 Policy

java.lang.Object 
  javax.security.auth.Policy

추천하지 않습니다. JDK 버전 1.4 로 java.security.Policy 로 옮겨졌습니다. java.security.Policy에는 다음의 메서드가 존재합니다.

        public PermissionCollection getPermissions
            (java.security.ProtectionDomain pd)
 
 

또, ProtectionDomain에는 다음의 생성자가 있습니다.

        public ProtectionDomain
            (CodeSource cs,
             PermissionCollection permissions,
             ClassLoader loader,
             Principal[] principals)
 

이것들 2개의 API는 호출 측에 Principal 베이스의 Permission 엔트리용 Policy 문의를 실행하는 수단을 제공합니다.

@Deprecated 
public abstract class Policy
extends Object 

Subject 베이스의 승인의 시스템 정책을 나타내는 abstract 클래스입니다. 이 클래스의 서브 클래스 구현에서는 Subject 베이스의 액세스 제어 Policy를 지정하는 방법을 제공합니다.

Policy객체는 다음의 방법으로Principal로 서 실행하고 있는 코드에 부여된 Permission 세트를 쿼리할 수 있습니다 .

        policy = Policy.getPolicy();
        PermissionCollection perms = policy.getPermissions(subject,
                                                        codeSource);
 

Policy 객체에서는 로컬 정책를 참조해, 적절한 Permissions 객체를 리턴합니다. 이 Permissions 객체에는 지정한 subject에 관련된 Principal에 부여되어 한편 codeSource 로 지정된 코드에 부여된 Permission가 있습니다.

Policy에는 다음에 나타내는 정보가 포함됩니다. 이 예에서는 단지 디폴트의 Policy 구현의 구문을 나타내고 있습니다. 이 클래스의 서브 클래스 구현에서는 다른 구문을 구현할 수도 있어 파일, 데이타베이스, 서버라고 하는 임의의 소스로부터 Policy를 취득할 수도 있습니다.

Policy 각 엔트리는 grant 엔트리로서 나타내집니다. 각 grant 엔트리에서는 코드 베이스, 코드의 서명자 및 Principal 로부터 완성되는 셋잇단음표, 그리고 그 셋잇단음표에 부여된 Permission을 지정합니다.

        grant CodeBase ["URL"], Signedby ["signers"],
              Principal [Principal_Class] "Principal_Name" {
            Permission Permission_Class ["Target_Name"]
                                        [, "Permission_Actions"]
                                        [, signedBy "SignerName"];
        };
 

이름/치 페어의 셋잇단음표 가운데, CodeBase 컴퍼넌트와 Signedby 컴퍼넌트는 생략 가능합니다. 존재하지 않는 경우는 임의의 코드 베이스가 일치해, 임의의 서명자 (서명 없음의 코드를 포함한다)가 일치합니다. 예를 들어 다음과 같이 됩니다.

        grant CodeBase "foo.com", Signedby "foo",
              Principal com.sun.security.auth.SolarisPrincipal "duke" {
            permission java.io.FilePermission "/home/duke", "read, write";
        };
 

이 grant 엔트리에서는 foo가 서명한, 이름 duke SolarisPrincipal로 실행하고 있는 foo.com 로부터의 코드에 Permission가 1개 있는 것을 지정하고 있습니다. 이 Permission에 서는 /home/duke 디렉토리에의 파일의 읽고 쓰기를, 실행하는 코드에 허용합니다.

어느 Principal로 「실행」하려면, 코드로 Subject.doAs(subject, ...) 메서드를 호출합니다. 이 메서드를 호출하면, 지정한 Subject에 관련된 모든 Principal 로 코드는 실행됩니다. 이 Policy 및 이 Policy에 부여된 Permission는 Subject.doAs 호출 후에 유효하게 됩니다.

1개의 grant 엔트리내에 복수의 Principal를 기술할 수 있습니다. grant 엔트리내로 지정된 모든 Principal가 Subject.doAs에 게 건네지는 Subject에 관련된 인 경우만, 지정된 Permissions가 그 Subject에 부여됩니다.

        grant Principal com.sun.security.auth.SolarisPrincipal "duke",
              Principal com.sun.security.auth.SolarisNumericUserPrincipal "0" {
            permission java.io.FilePermission "/home/duke", "read, write";
            permission java.net.SocketPermission "duke.com", "connect";
        };
 

이 엔트리에서는 duke와 0 양쪽 모두로 실행되는 코드에 duke 홈 디렉토리내의 파일에의 읽고 쓰기 접근 권한을 부여해, 또한 duke.com 에의 소켓 접속을 실시할 권리를 부여합니다.

Principal 베이스가 아닌 grant 엔트리는 이 Policy에 서는 허가되지 않습니다. 그 때문에 다음의 grant 엔트리는 거부됩니다.

        grant CodeBase "foo.com", Signedby "foo" {
            permission java.io.FilePermission "/tmp/scratch", "read, write";
        };
 

이러한 접근 권한은 java.security.Policy에 기술할 필요가 있습니다.

디폴트의 Policy 구현은 (Java 시큐러티 프로퍼티 파일의) auth.policy.provider 시큐러티 프로퍼티에 희망하는 Policy 구현 클래스의 완전 지정명을 설정하는 것으로써 변경할 수 있습니다. Java 시큐러티 프로퍼티 파일은 <JAVA_HOME>/lib/security/java.security 라는 이름의 파일에 포함되어 있습니다. 여기서, <JAVA_HOME>는 JDK 인스톨처 디렉토리를 나타냅니다.

생성자 개요

protected

Policy () 추천하지 않습니다. 유일한 생성자 입니다.

메서드 개요

abstract PermissionCollection	getPermissions (Subject subject, CodeSource cs) 추천하지 않습니다. 지정한 CodeSource에 관련된 Principal에 부여된 Permission를 취득합니다.
static Policy	getPolicy () 추천하지 않습니다. 인스톨 끝난 Policy 객체를 리턴합니다.
abstract void	refresh () 추천하지 않습니다. Policy 리프레쉬 및 재로드를 실행합니다.
static void	setPolicy (Policy policy) 추천하지 않습니다. 시스템 전체의 Policy 객체를 설정합니다.

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

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

생성자 상세

Policy

protected Policy()

추천하지 않습니다.

유일한 생성자 입니다. 서브 클래스의 생성자에 한 호출은 일반적으로 암묵적인 호출입니다.

메서드의 상세

getPolicy

public static Policy  getPolicy()

추천하지 않습니다.

인스톨 끝난 Policy 객체를 리턴합니다. 이 메서드는 최초로 AuthPermission("getPolicy") 접근 권한을 사용해 SecurityManager.checkPermission을 호출해, 호출 측에 Policy 객체를 취득할 수 있는 접근 권한이 있을지 어떨지를 확인합니다.

반환값:

인스톨 끝난 Policy. 반환값은 null이 되지 않는다

예외:

SecurityException - 현재의 thread가 Policy 객체를 얻는 접근 권한을 가지지 않는 경우

관련 항목:

setPolicy(javax.security.auth.Policy)

setPolicy

public static void setPolicy(Policy  policy)

추천하지 않습니다.

시스템 전체의 Policy 객체를 설정합니다. 이 메서드는 최초로 AuthPermission("setPolicy") 접근 권한을 사용해 SecurityManager.checkPermission을 호출해, 호출 측에 Policy를 설정하는 접근 권한이 있을지 어떨지를 확인합니다.

파라미터:

policy - 새로운 시스템 Policy 객체

예외:

SecurityException - 현재의 thread가 Policy를 설정하는 접근 권한을 가지지 않는 경우

관련 항목:

getPolicy()

getPermissions

public abstract PermissionCollection  getPermissions(Subject  subject,
                                                    CodeSource  cs)

추천하지 않습니다.

지정한 CodeSource에 관련된 Principal에 부여된 Permission를 취득합니다.

파라미터:

subject - Subject. Subject에 관련된 Principal는 지정한 CodeSource와 함께, 이 메서드가 돌려주는 Permission를 결정하기 위해서 사용된다. 이 파라미터는 null도 가능

cs - CodeSource가 지정한 코드. CodeSource는 지정한 Subject와 함께, 이 메서드가 돌려주는 Permission를 결정하기 위해서 사용된다. 이 파라미터는 null도 가능

반환값:

subject 및 cs 파라미터로 지정된 모든 Subject 및 코드에 부여된 Permission Collection

refresh

public abstract void refresh()

추천하지 않습니다.

Policy 리프레쉬 및 재로드를 실행합니다.

이 메서드는 이 객체에 현재의 정책 의 리프레쉬나 재로드를 실시하게 합니다. 이것은 구현에 의존합니다. 예를 들어 Policy 객체가 파일에 포함되고 있는 경우, refresh를 호출하면, 파일이 한번 더 읽어내지게 됩니다.

예외:

SecurityException - 호출 측에 Policy를 리프레쉬 하는 접근 권한이 없는 경우