javax.net.ssl
介面 X509KeyManager

所有父級介面：

KeyManager

所有已知實作類別：

X509ExtendedKeyManager

public interface X509KeyManager
extends KeyManager

此介面的實例管理使用哪一個基於 X509 證書的密鑰對來驗證本地的安全Socket。

在安全Socket協商期間，實作調用此介面中的方法來完成下面的工作：

• 確定基於現有標準進行協商可以使用的別名集合，
• 選擇基於現有標準的最好的別名，和
• 為指定別名獲取相應的密鑰材料。

註：應該使用 X509ExtendedKeyManager 支持此類別。

從以下版本開始：

1.4

方法摘要

String	chooseClientAlias(String[] keyType, Principal[] issuers, Socket socket) 根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），選擇用於驗證安全Socket客戶端的別名。
String	chooseServerAlias(String keyType, Principal[] issuers, Socket socket) 根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），選擇用於驗證安全Socket伺服器端的別名。
X509Certificate[]	getCertificateChain(String alias) 返回與給定別名關聯的證書鏈。
String[]	getClientAliases(String keyType, Principal[] issuers) 根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），獲取用於驗證安全Socket客戶端的比對別名。
PrivateKey	getPrivateKey(String alias) 返回與給定別名關聯的密鑰。
String[]	getServerAliases(String keyType, Principal[] issuers) 根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），獲取用於驗證安全Socket伺服器端的別名。

方法詳細資訊

getClientAliases

String[] getClientAliases(String keyType,
                          Principal[] issuers)

根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），獲取用於驗證安全Socket客戶端的比對別名。

參數：

keyType - 密鑰演算法型別名稱

issuers - 可接受的 CA 發行者主體名稱列表，如果使用哪個發行者並不重要，則此參數為 null。

返回：

比對的別名陣列；如果沒有比對的，則返回 null。

chooseClientAlias

String chooseClientAlias(String[] keyType,
                         Principal[] issuers,
                         Socket socket)

根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），選擇用於驗證安全Socket客戶端的別名。

參數：

keyType - 密鑰演算法型別名稱，以首選的密鑰型別在前的順序。

issuers - 可接受的 CA 發行者主體名稱列表，如果使用哪個發行者並不重要，則此參數為 null。

socket - 將用於此連接的Socket。此參數可以為 null，這表示實作可以自由選擇適用於任何Socket的別名。

返回：

所需密鑰的別名；如果沒有比對項，則返回 null。

getServerAliases

String[] getServerAliases(String keyType,
                          Principal[] issuers)

根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），獲取用於驗證安全Socket伺服器端的別名。

參數：

keyType - 密鑰演算法型別名稱

issuers - 可接受的 CA 發行者主體名稱列表，如果使用哪個發行者並不重要，則此參數為 null。

返回：

比對的別名陣列；如果沒有比對的，則返回 null。

chooseServerAlias

String chooseServerAlias(String keyType,
                         Principal[] issuers,
                         Socket socket)

根據給定公鑰型別和同位體識別的證書發行者授權機構列表（如果有），選擇用於驗證安全Socket伺服器端的別名。

參數：

keyType - 密鑰演算法型別名稱。

issuers - 可接受的 CA 發行者主體名稱列表，如果使用哪個發行者並不重要，則此參數為 null。

socket - 將用於此連接的Socket。此參數可以為 null，這表示實作可以自由選擇適用於任何Socket的別名。

返回：

所需密鑰的別名；如果沒有比對項，則返回 null。

getCertificateChain

X509Certificate[] getCertificateChain(String alias)

返回與給定別名關聯的證書鏈。

參數：

alias - 別名

返回：

證書鏈（以使用者證書在前根證書授權在後的順序）；如果沒有找到別名，則返回 null。

getPrivateKey

PrivateKey getPrivateKey(String alias)

返回與給定別名關聯的密鑰。

參數：

alias - 別名

返回：

請求的密鑰；如果不能找到別名，則返回 null。