java.security.acl
인터페이스 Acl

모든 슈퍼 인터페이스:

Owner

public interface Acl
extends Owner 

액세스 제어 리스트 (ACL: Access Control List)를 나타내는 인터페이스입니다. ACL는 자원에 대한 액세스를 보호하는 데이터 구조체입니다.

ACL는 복수의 ACL 엔트리를 가지는 데이터 구조체라고 볼 수가 있습니다. interface 형 AclEntry 각 ACL 엔트리에는 특정의 주체에 관련된 접근 권한세트가 포함됩니다 (주체와는 개인 사용자 나 그룹등의 엔티티를 나타낸다). 게다가 각 ACL 엔트리에는 정 또는 부의 부호를 붙여 지정합니다. 정의 경우는 관련된 주체에 접근 권한이 주어집니다. 부의 경우는 접근 권한은 거부됩니다.

각 ACL 중의 ACL 엔트리는 아래의 규칙에 따릅니다.

• 각 주체는 정과 부의 ACL 엔트리를 많아도 1개 씩 밖에 가질 수가 없다. 즉, 어느 주체도, 복수의 정 또는 부의 ACL 엔트리를 가지는 것은 용서되지 않았다. 각 엔트리는 (정부에의해 각각) 허가 또는 거부해야 할 접근 권한세트를 지정한다

• 엔트리가 없는 주체에 대해서는 null (비어있는) 접근 권한세트를 가지는 것이라고 본다

• 주체에 어느 접근 권한을 주는 정의 엔트리가 있어, 동시에 같은 접근 권한을 거부하는 부의 엔트리가 있는 경우, 결과적으로는 그 접근 권한은 허가도 거부도되어 있지 않게 된다

• 개인의 접근 권한은 항상, 그것이 속하고 있는 그룹의 (복수의 경우도 있다) 접근 권한에 우선한다. 즉, 개인의 부의 접근 권한 (특정의 접근 권한의 거부)은 그 그룹의 정의 접근 권한에 우선한다. 또, 개인 정의 접근 권한은 그 그룹의 부의 접근 권한보다 우선한다

java.security.acl 패키지는 ACL와 관련된 데이터 구조체 (ACL 엔트리, 그룹, 접근 권한등)에 대한 인터페이스를 제공해, sun.security.acl 클래스는 인터페이스의 디폴트의 구현을 제공합니다. 예를 들어, java.security.acl.Acl는 ACL에 대한 인터페이스를 제공해, sun.security.acl.AclImpl 클래스는 그 인터페이스의 디폴트의 구현을 제공합니다.

java.security.acl.Acl인터페이스는 java.security.acl.Owner인터페이스를 확장한 것입니다. Owner 인터페이스는 각 ACL 소유자의 리스트를 유지하기 위해서 사용합니다. 소유자 밖에 ACL 변경은 용서되지 않습니다. 예를 들어 ACL addEntry 메서드를 호출해, 새로운 ACL 엔트리를 ACL에 추가할 수 있는 것은 소유자만입니다.

관련 항목:

AclEntry, Owner, getPermissions(java.security.Principal)

메서드 개요

boolean	addEntry (Principal caller, AclEntry entry) ACL 엔트리를 이 ACL에 추가합니다.
boolean	checkPermission (Principal principal, Permission permission) 지정된 주체가 지정된 접근 권한을 가지고 있을지 어떨지를 판정합니다.
Enumeration <AclEntry >	entries () 이 ACL 내의 엔트리의 열거를 리턴합니다.
String	getName () 이 ACL 이름을 리턴합니다.
Enumeration <Permission >	getPermissions (Principal user) 지정된 주체 (개인 또는 그룹등의 엔티티를 나타낸다)에 대해서 허가된 접근 권한세트에 대한 열거를 리턴합니다.
boolean	removeEntry (Principal caller, AclEntry entry) 이 ACL 로부터 1개의 ACL를 삭제합니다.
void	setName (Principal caller, String name) ACL 엔트리를 이 ACL에 추가합니다.
String	toString () ACL 내용을 캐릭터 라인 표현으로 리턴합니다.

인터페이스 java.security.acl. Owner 로부터 상속된 메서드

addOwner, deleteOwner, isOwner

메서드의 상세

setName

void setName(Principal  caller,
             String  name)
             throws NotOwnerException 

ACL 엔트리를 이 ACL에 추가합니다.

파라미터:

caller - 이 메서드를 시작하는 주체. 이 ACL 소유자가 되어 있을 필요가 있는

name - 이 ACL 에게 주는 이름

예외:

NotOwnerException - 호출하는 주체가 이 ACL 소유자가 아닌 경우

관련 항목:

getName()

getName

String  getName()

이 ACL 이름을 리턴합니다.

반환값:

이 ACL 이름

관련 항목:

setName(java.security.Principal, java.lang.String)

addEntry

boolean addEntry(Principal  caller,
                 AclEntry  entry)
                 throws NotOwnerException 

ACL 엔트리를 이 ACL에 추가합니다. ACL 엔트리란 주체 (개인 또는 그룹등)를 접근 권한세트에 관련짓는 것입니다. 각 주체는 정의 ACL 엔트리 (주체에게 주는 접근 권한을 지정한다)와 부의 ACL 엔트리 (거부하는 접근 권한을 지정한다)를 많아도 1개 씩 밖에 가질 수 없습니다. ACL 내에 이미 같은 종류 (정, 부)의 ACL 엔트리가 존재하는 경우는 false가 리턴됩니다 .

파라미터:

caller - 이 메서드를 시작하는 주체. 이 ACL 소유자가 되어 있을 필요가 있는

entry - 이 ACL에 추가되는 ACL 엔트리

반환값:

성공했을 경우는 true. 같은 주체에 대해서 같은 종류 (정, 부)의 ACL 엔트리가 이 ACL에 이미 존재하는 경우는 false

예외:

NotOwnerException - 호출하는 주체가 이 ACL 소유자가 아닌 경우

removeEntry

boolean removeEntry(Principal  caller,
                    AclEntry  entry)
                    throws NotOwnerException 

이 ACL 로부터 1개의 ACL를 삭제합니다.

파라미터:

caller - 이 메서드를 시작하는 주체. 이 ACL 소유자가 되어 있을 필요가 있는

entry - 이 ACL 로부터 삭제하는 ACL 엔트리

반환값:

성공했을 경우는 true. 엔트리가 이 ACL가 일부에서 없는 경우는 false

예외:

NotOwnerException - 호출하는 주체가 이 ACL 소유자가 아닌 경우

getPermissions

Enumeration <Permission > getPermissions(Principal  user)

지정된 주체 (개인 또는 그룹등의 엔티티를 나타낸다)에 대해서 허가된 접근 권한세트에 대한 열거를 리턴합니다. 허가되는 접근 권한세트는 아래와 같이 결정됩니다.

• 지정된 주체에 대해서 이 ACL 중에 엔트리가 존재하지 않는 경우는 비어있는 접근 권한세트가 리턴된다

• 그 외의 경우는 지정된 주체의 그룹 접근 권한세트가 결정된다 (주체는 1개 이상의 그룹에 속할 수가 있다. 여기서, 그룹과는 주체의 그룹으로 Group 인터페이스에 의해 나타내진다). 그룹의 정의 접근 권한 세트는 주체가 속하는 각 그룹의, 정의 모든 접근 권한의 화집합이 된다. 그룹의 부의 접근 권한 세트는 주체가 속하는 각 그룹의, 부의 모든 접근 권한의 화집합이 된다. 정과 부의 양쪽 모두의 접근 권한 세트에 있는 접근 권한이 존재했을 경우는 그 접근 권한은 양쪽 모두로부터 삭제된다

  개인 정과 부의 접근 권한 세트도 결정된다. 정의 접근 권한 세트에는 그 주체에 대한 정의 ACL 엔트리로 (존재하는 경우) 가리키는 접근 권한이 포함된다. 같이 부의 접근 권한 세트에는 그 주체에 대한 부의 ACL 엔트리로 (존재하는 경우) 가리키는 접근 권한이 포함된다. 개인 정 (또는 부)의 접근 권한 세트는 이 ACL 내에 정 (또는 부)의 ACL 엔트리가 존재하지 않는 경우는 null 라고 보여진다

  이후에 주체에게 줄 수 있는 접근 권한세트가 개인의 접근 권한을 그룹의 접근 권한보다 항상 우선한다고 하는 단순한 규칙을 사용해 결정된다. 즉, 주체의 개인의 부의 접근 권한 세트 (있는 접근 권한의 거부)는 그룹의 정의 접근 권한 세트에 우선해, 주체의 개인 정의 접근 권한 세트는 그룹의 부의 접근 권한 세트에 우선한다

파라미터:

user - 그 접근 권한 세트를 돌려주는 주체

반환값:

주체에 허가되는 접근 권한을 지정하는 접근 권한 세트

entries

Enumeration <AclEntry > entries()

이 ACL 내의 엔트리의 열거를 리턴합니다. 열거중의 각 요소는 AclEntry 형입니다.

반환값:

이 ACL 내의 엔트리의 열거

checkPermission

boolean checkPermission(Principal  principal,
                        Permission  permission)

지정된 주체가 지정된 접근 권한을 가지고 있을지 어떨지를 판정합니다. 가지고 있는 경우는 true를 돌려주고, 그렇지 않은 경우는 false를 리턴합니다. 보다 자세하게 설명하면, 이 메서드는 지정된 접근 권한이 지정된 주체의 허가 접근 권한 세트의 멤버일지 어떨지를 확인합니다. 허가 접근 권한 세트는 getPermissions 메서드와 같은 알고리즘에 근거결정됩니다.

파라미터:

principal - 주체. 유효한 인증 끝난 주체를 전제로 하는

permission - 판정 대상의 접근 권한

반환값:

주체가 지정된 접근 권한을 가지는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

getPermissions(java.security.Principal)

toString

String  toString()

ACL 내용을 캐릭터 라인 표현으로 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

ACL 내용의 캐릭터 라인 표현