javax.security.auth
클래스 PrivateCredentialPermission

java.lang.Object 
  java.security.Permission 
      javax.security.auth.PrivateCredentialPermission

모든 구현된 인터페이스:

Serializable, Guard

public final class PrivateCredentialPermission
extends Permission 

이 클래스는 특정의 Subject에 속하는 비공개 Credential를 액세스로부터 보호합니다. Subject는 Principal Set 로 나타내집니다.

이 Permission 타겟명은 Credential 클래스명 및 Principal Set를 지정합니다. 이 Permission 액션에 유효한 값은 read 뿐입니다. 타겟명은 다음의 구문에 따를 필요가 있습니다.

        CredentialClass {PrincipalClass "PrincipalName"}*
 

예를 들어 아래의 접근 권한은 com.sun.Principal를 이름 「duke」로 보관 유지하는 Subject가 소유하는 com.sun.PrivateCredential 에의 액세스를 허용합니다. 이하에 나타내는 예 모두같이, 이 예에서도 단순화 하기 위해서 Codebase, Signedby, Principal 정보를 grant 문에 포함하고 있지 않습니다만, 실제의 정책 구성에서는 필요에 따라서 지정할 필요가 있습니다.

    grant {
        permission javax.security.auth.PrivateCredentialPermission
                "com.sun.PrivateCredential com.sun.Principal \"duke\"",
                "read";
    };
 

CredentialClass가 「*」의 경우는 지정한 Subject에 속하는 모든 비공개 Credential 에의 액세스가 부여됩니다. 「PrincipalName」이 「*」의 경우는 실제의 PrincipalName에 관계없이, 지정한 Principal를 보관 유지하는 임의의 Subject이 소유하는 지정한 Credential 에의 액세스가 허가됩니다. 예를 들어 a.b.Principal를 보관 유지하는 임의의 Subject이 소유하는 a.b.Credential 에의 액세스를 허가하려면 다음과 같이 합니다.

    grant {
        permission javax.security.auth.PrivateCredentialPermission
                "a.b.Credential a.b.Principal "*"",
                "read";
    };
 

PrincipalClass와 「PrincipalName」의 양쪽 모두가 「*」인 경우는 임의의 Subject이 소유하는 지정한 Credential 에의 액세스가 허가됩니다.

게다가 PrincipalClass와 PrincipalName 페어는 반복할 수 있습니다 .

    grant {
        permission javax.security.auth.PrivateCredentialPermission
                "a.b.Credential a.b.Principal "duke" c.d.Principal "dukette"",
                "read";
    };
 

상기의 예에서는 비공개 Credential 인 a.b.Credential 에의 액세스가 허가되고 있습니다. 이 비공개 Credential는 이름 duke a.b.Principal 과 이름 dukette c.d.Principal가 적어도 2개의 관련된 Principal를 가지는 Subject에 속하고 있습니다.

관련 항목:

직렬화 된 형식

생성자 개요

PrivateCredentialPermission (String name, String actions)
지정한 name로 새로운 PrivateCredentialPermission을 작성합니다.

메서드 개요

boolean	equals (Object obj) 2개의 PrivateCredentialPermission 동일성을 판정합니다.
String	getActions () 이 액션의 「표준적인 캐릭터 라인 표현」을 리턴합니다.
String	getCredentialClass () 이 PrivateCredentialPermission에 관련한 Credential Class 명을 리턴합니다.
String [][]	getPrincipals () 이 PrivateCredentialPermission에 관련된 Principal 클래스와 이름을 리턴합니다.
int	hashCode () 이 객체의 해시 코드값을 리턴합니다.
boolean	implies (Permission p) 이 PrivateCredentialPermission 객체가 지정된 Permission을 나타낼지 어떨지를 판정합니다.
PermissionCollection	newPermissionCollection () PermissionCollection에 있는 PrivateCredentialPermissions 동종 컬렉션을 리턴합니다.

클래스 java.security. Permission 로부터 상속된 메서드

checkGuard, getName, toString

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

생성자 상세

PrivateCredentialPermission

public PrivateCredentialPermission(String  name,
                                   String  actions)

지정한 name로 새로운 PrivateCredentialPermission을 작성합니다. name에는 Credential 클래스와 Principal Set 양쪽 모두를 지정합니다.

파라미터:

name - Credential 클래스 및 Principal Set를 지정하는 이름

actions - Credential가 읽기 가능한 것을 지정하는 액션

예외:

IllegalArgumentException - name가 올바른 구문에 적합하지 않는 경우, 혹은 action가 read가 아닌 경우

메서드의 상세

getCredentialClass

public String  getCredentialClass()

이 PrivateCredentialPermission에 관련한 Credential Class 명을 리턴합니다.

반환값:

이 PrivateCredentialPermission에 관련된 Credential Class 명

getPrincipals

public String [][] getPrincipals()

이 PrivateCredentialPermission에 관련된 Principal 클래스와 이름을 리턴합니다. 정보는 2 차원 배열 (array[x][y])로 리턴됩니다 . x 값은, Principal 클래스와 이름의 페어의 수에 대응하고 있습니다. y==0 때 y는 Principal 클래스의 값에 대응해, y==1 때는 Principal 명의 값에 대응합니다. 예를 들어 array[0][0] 은 배열의 최초로 있는 Principal 클래스명에 대응합니다. array[0][1] 은 배열의 최초로 있는 Principal Principal 명에 대응합니다.

반환값:

PrivateCredentialPermission에 관련된 Principal 클래스와 이름

implies

public boolean implies(Permission  p)

이 PrivateCredentialPermission 객체가 지정된 Permission을 나타낼지 어떨지를 판정합니다.

이 메서드는 다음의 경우에 true를 리턴합니다.

• p가 PrivateCredentialPermission 인스턴스이며, 한편

• p 타겟명이, 이 객체의 타겟명에 포함되어 있다. 즉, 다음과 같은 경우

  
          [* P1 "duke"] implies [a.b.Credential P1 "duke"].
          [C1 P1 "duke"] implies [C1 P1 "duke" P2 "dukette"].
          [C1 P2 "dukette"] implies [C1 P1 "duke" P2 "dukette"].
   

정의:

클래스 Permission 내의 implies

파라미터:

p - 체크 대상의 Permission

반환값:

이 PrivateCredentialPermission 객체로 지정된 Permission가 포함되어 있는 경우는 true, 포함되지 않은 경우는 false

equals

public boolean equals(Object  obj)

2개의 PrivateCredentialPermission 동일성을 판정합니다. obj가 PrivateCredentialPermission 이며, 이 객체와 같은 자격 클래스 및 같은 Principal를 보관 유지하는 것을 확인합니다. 각 Permission 타겟명에서의 Principal 차례는 관계 없습니다.

정의:

클래스 Permission 내의 equals

파라미터:

obj - 이 객체와 동일한지 어떤지를 판정하는 객체

반환값:

obj가 PrivateCredentialPermission 이며, 한편, 이 객체와 같은 자격 클래스 및 같은 Principal를 보관 유지하는 경우는 true

관련 항목:

Object.hashCode(), Hashtable

hashCode

public int hashCode()

이 객체의 해시 코드값을 리턴합니다.

정의:

클래스 Permission 내의 hashCode

반환값:

이 객체의 해시 코드값

관련 항목:

Object.equals(java.lang.Object), Hashtable

getActions

public String  getActions()

이 액션의 「표준적인 캐릭터 라인 표현」을 리턴합니다. 이 메서드는 항상 「read」라고 하는 String 치를 리턴합니다.

정의:

클래스 Permission 내의 getActions

반환값:

액션 (항상 「read」를 돌려준다)

newPermissionCollection

public PermissionCollection  newPermissionCollection()

PermissionCollection에 있는 PrivateCredentialPermissions 동종 컬렉션을 리턴합니다. 그러한 PermissionCollection는 정의되어 있지 않기 때문에 이 메서드는 항상 null을 리턴합니다.

오버라이드(override):

클래스 Permission 내의 newPermissionCollection

반환값:

null (어떠한 경우에서도)