介面 java.security.Principal
的使用

使用 Principal 的軟體套件

java.net	為實作網路應用程序提供類別。
java.security	為安全框架提供類別和介面。
java.security.acl	此套件中的類別和介面已經被 java.security 套件中的類別取代。
java.security.cert	提供用於解析和管理證書、證書撤消列表 (CRL) 和證書路徑的類別和介面。
javax.management.remote	對 JMX MBean 伺服器進行遠端存取使用的介面。
javax.net.ssl	提供用於安全Socket層(SSL)套件的類別。
javax.security.auth	此套件提供用於進行驗證和授權的框架。
javax.security.auth.kerberos	此套件包含與 Kerberos 網路驗證協議相關的實用工具類別。
javax.security.auth.x500	此套件包含應該用來在 Subject 中存儲 X500 Principal 和 X500 Private Crendentials 的類別。
javax.security.cert	為公鑰證書提供類別。
javax.xml.ws	此套件包含核心 JAX-WS API。

java.net 中 Principal 的使用

返回 Principal 的 java.net 中的方法

abstract Principal	SecureCacheResponse.getLocalPrincipal() 返回在獲得了網路資源的初始連接中的聯絡期間發送到伺服器的主體。
abstract Principal	SecureCacheResponse.getPeerPrincipal() 返回伺服器的主體，該主體是作為在獲得了網路資源的初始連接期間定義Session的一部分建立的。

java.security 中 Principal 的使用

實作 Principal 的 java.security 中的類別

class	Identity 已過時。 不再使用此類別。其功能已經由 java.security.KeyStore、java.security.cert 套件和 java.security.Principal 取代。
class	IdentityScope 已過時。 此類別不再被使用。其功能已經由 java.security.KeyStore、java.security.cert 套件和 java.security.Principal 取代。
class	Signer 已過時。 將不再使用此類別。其功能已由 java.security.KeyStore、java.security.cert 套件和 java.security.Principal 所取代。

返回 Principal 的 java.security 中的方法

Principal	Certificate.getGuarantor() 已過時。 返回證書的保證人，即某個主體，其保證與此證書關聯的公鑰是與此證書關聯的主體的公鑰。
Principal	Certificate.getPrincipal() 已過時。 返回保證人所保證的主體密鑰對的主體。
Principal[]	ProtectionDomain.getPrincipals() 返回此域的 principals 陣列。

參數型別為 Principal 的 java.security 中的方法

Identity

IdentityScope.getIdentity(Principal principal) 已過時。 獲取名稱與指定的主體相同的身份。

參數型別為 Principal 的 java.security 中的建構子

ProtectionDomain(CodeSource codesource, PermissionCollection permissions, ClassLoader classloader, Principal[] principals)
創建由給定的 CodeSource、Permissions、ClassLoader 和 Principal 陣列限定的新 ProtectionDomain。

java.security.acl 中 Principal 的使用

java.security.acl 中 Principal 的子介面

interface

Group 此介面用於表示一個主體組。

返回 Principal 的 java.security.acl 中的方法

Principal

AclEntry.getPrincipal() 返回此 ACL 項將為其授予或拒絕權限的主體。

返回變數型別為 Principal 的型別的 java.security.acl 中的方法

Enumeration<? extends Principal>

Group.members() 返回此組中成員的列舉。

參數型別為 Principal 的 java.security.acl 中的方法

boolean	Acl.addEntry(Principal caller, AclEntry entry) 向此 ACL 中添加 ACL 項。
boolean	Group.addMember(Principal user) 向組中添加指定的成員。
boolean	Owner.addOwner(Principal caller, Principal owner) 添加一個所有者。
boolean	Acl.checkPermission(Principal principal, Permission permission) 檢查指定的主體是否具有指定的權限。
boolean	Owner.deleteOwner(Principal caller, Principal owner) 刪除一個所有者。
Enumeration<Permission>	Acl.getPermissions(Principal user) 返回一個指定主體（表示一個實體，如個體或組）的許可權限集合的列舉。
boolean	Group.isMember(Principal member) 如果傳遞的主體是組的一個成員，則返回 true。
boolean	Owner.isOwner(Principal owner) 如果給定的主體是該 ACL 的所有者，則返回 true。
boolean	Acl.removeEntry(Principal caller, AclEntry entry) 從此 ACL 中移除 ACL 項。
boolean	Group.removeMember(Principal user) 從組中移除指定的成員。
void	Acl.setName(Principal caller, String name) 設置此 ACL 的名稱。
boolean	AclEntry.setPrincipal(Principal user) 指定此 ACL 項要為其授予或拒絕權限的主體。

java.security.cert 中 Principal 的使用

返回 Principal 的 java.security.cert 中的方法

abstract Principal	X509CRL.getIssuerDN() 已過時，由 X509CRL.getIssuerX500Principal() 替代。
abstract Principal	X509Certificate.getIssuerDN() 已過時，由 X509Certificate.getIssuerX500Principal() 替代。
abstract Principal	X509Certificate.getSubjectDN() 已過時，由 X509Certificate.getSubjectX500Principal() 替代。

javax.management.remote 中 Principal 的使用

實作 Principal 的 javax.management.remote 中的類別

class

JMXPrincipal JMX Remote API 的遠端客戶端的身份。

javax.net.ssl 中 Principal 的使用

返回 Principal 的 javax.net.ssl 中的方法

Principal	HandshakeCompletedEvent.getLocalPrincipal() 返回連繫交換期間發送到同位體的主體。
Principal	SSLSession.getLocalPrincipal() 返回連繫交換期間發送給同位體的主體。
Principal	HttpsURLConnection.getLocalPrincipal() 返回連繫交換期間發送到伺服器的主體。
Principal	HandshakeCompletedEvent.getPeerPrincipal() 返回同位體的標識，同位體是作為定義Session的一部分而建立的。
Principal	SSLSession.getPeerPrincipal() 返回同級身份，該同級身份是作為定義Session的一部分而建立的。
Principal	HttpsURLConnection.getPeerPrincipal() 返回伺服器的主體，它是作為定義Session的一部分而建立的。

參數型別為 Principal 的 javax.net.ssl 中的方法

String	X509KeyManager.chooseClientAlias(String[] keyType, Principal[] issuers, Socket socket) 根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），選擇用於驗證安全Socket客戶端的別名。
String	X509ExtendedKeyManager.chooseEngineClientAlias(String[] keyType, Principal[] issuers, SSLEngine engine) 選擇別名，對給出公鑰型別的 SSLEngine 連接的客戶端和由同位體（如果有)識別的證書發行者授權列表進行驗證。
String	X509ExtendedKeyManager.chooseEngineServerAlias(String keyType, Principal[] issuers, SSLEngine engine) 選擇別名，對給出公鑰型別的 SSLEngine 連接的伺服器和由同位體（如果有)識別的證書發行者授權列表進行驗證。
String	X509KeyManager.chooseServerAlias(String keyType, Principal[] issuers, Socket socket) 根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），選擇用於驗證安全Socket伺服器端的別名。
String[]	X509KeyManager.getClientAliases(String keyType, Principal[] issuers) 根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），獲取用於驗證安全Socket客戶端的比對別名。
String[]	X509KeyManager.getServerAliases(String keyType, Principal[] issuers) 根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），獲取用於驗證安全Socket伺服器端的別名。

javax.security.auth 中 Principal 的使用

型別參數型別為 Principal 的 javax.security.auth 中的方法

<T extends Principal> Set<T>

Subject.getPrincipals(Class<T> c) 返回與此 Subject 關聯的 Principal Set，它是指定的 Class 的實例或子類別。

返回變數型別為 Principal 的型別的 javax.security.auth 中的方法

Set<Principal>

Subject.getPrincipals() 返回與此 Subject 關聯的 Principal Set。

型別變數型別為 Principal 的 javax.security.auth 中的建構子參數

Subject(boolean readOnly, Set<? extends Principal> principals, Set<?> pubCredentials, Set<?> privCredentials)
創建帶有 Principal 和證書的 Subject 的實例。

javax.security.auth.kerberos 中 Principal 的使用

實作 Principal 的 javax.security.auth.kerberos 中的類別

class

KerberosPrincipal 此類別封裝 Kerberos 主體。

javax.security.auth.x500 中 Principal 的使用

實作 Principal 的 javax.security.auth.x500 中的類別

class

X500Principal 此類別表示一個 X.500 Principal。

javax.security.cert 中 Principal 的使用

返回 Principal 的 javax.security.cert 中的方法

abstract Principal	X509Certificate.getIssuerDN() 獲取證書的 issuer（發佈方的標識名）值。
abstract Principal	X509Certificate.getSubjectDN() 獲取證書的 subject（主體的標識名）值。

javax.xml.ws 中 Principal 的使用

返回 Principal 的 javax.xml.ws 中的方法

Principal

WebServiceContext.getUserPrincipal() 返回標識當前正服務請求發送方的 Principal。