- すべての実装されたインタフェース:
Serializable
,Principal
- 直系の既知のサブクラス:
IdentityScope
,Signer
このクラスは、アイデンティティを表します。アイデンティティは、人々、会社、組織などの実際の世界のオブジェクトで、そのアイデンティティがその公開キーを使用して認証できるものです。 アイデンティティはまた、デーモン・スレッドやスマート・カードのようなより抽象的、あるいはより具象的な構成概念であってもかまいません。
すべてのIdentity
オブジェクトには、名前と公開キーがあります。 名前は不変です。 Identityにはスコープを指定することもできます。 つまり、Identity
に特定のスコープが指定されている場合、Identity
の名前と公開キーはそのスコープ内で一意になります。
Identity
には、一連の証明書(自身の公開鍵を証明するすべて)もあります。 それらの証明書に指定されている主体名は同一でなくてもかまいませんが、キーだけは同一である必要があります。
Identity
をサブクラス化して、郵送先住所とEメール・アドレス、電話番号、顔とロゴのイメージなどを含めることができます。
- 導入されたバージョン:
- 1.1
- 関連項目:
-
コンストラクタのサマリー
修飾子コンストラクタ説明protected
Identity()
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。直列化専用のコンストラクタです。削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。指定された名前でスコープなしでIdentity
を構築します。Identity
(String name, IdentityScope scope) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。指定された名前とスコープでIdentity
を構築します。 -
メソッドのサマリー
修飾子と型メソッド説明void
addCertificate
(Certificate certificate) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
の証明書を追加します。削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
のすべての証明書のコピーを返します。final boolean
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。指定されたオブジェクトとこのIdentity
の間の等価性をテストします。getInfo()
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
に対して以前に指定された一般情報を返します。final String
getName()
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このアイデンティティの名前を返します。削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このアイデンティティの公開キーを返します。final IdentityScope
getScope()
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このアイデンティティのスコープを返します。int
hashCode()
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
のハッシュ・コードを返します。protected boolean
identityEquals
(Identity identity) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。指定されたIdentity
とこのIdentity
の間の等価性をテストします。void
removeCertificate
(Certificate certificate) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
から証明書を削除します。void
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
の一般情報文字列を指定します。void
setPublicKey
(PublicKey key) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このアイデンティティの公開キーを設定します。toString()
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
を記述する短い文字列を返し、名前とそのスコープ(もしあれば)を示します。toString
(boolean detailed) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
の文字列表現を返します。オプションで、引数なしのtoString
メソッドで提供されるものよりも詳細な情報を提供します。
-
コンストラクタの詳細
-
Identity
protected Identity()削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。直列化専用のコンストラクタです。 -
Identity
public Identity(String name, IdentityScope scope) throws KeyManagementException 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。指定された名前とスコープでIdentity
を構築します。- パラメータ:
name
-Identity
名。scope
-Identity
のスコープ。- 例外:
KeyManagementException
- スコープに同じ名前のIdentity
がすでに存在する場合。
-
Identity
public Identity(String name) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。指定された名前でスコープなしでIdentity
を構築します。- パラメータ:
name
- アイデンティティ名。
-
-
メソッドの詳細
-
getName
public final String getName()削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このアイデンティティの名前を返します。 -
getScope
public final IdentityScope getScope()削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このアイデンティティのスコープを返します。- 戻り値:
- この
Identity
のスコープ。
-
getPublicKey
public PublicKey getPublicKey()削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このアイデンティティの公開キーを返します。- 戻り値:
- この
Identity
の公開キー。 - 関連項目:
-
setPublicKey
public void setPublicKey(PublicKey key) throws KeyManagementException 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このアイデンティティの公開キーを設定します。 元のキーとこのアイデンティティのすべての証明書は、この操作によって削除されます。セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャの
checkSecurityAccess
メソッドが引数として"setIdentityPublicKey"
を指定して呼び出され、公開キーの設定をしてもよいかどうかを確認します。- パラメータ:
key
- このIdentity
の公開キー。- 例外:
KeyManagementException
- アイデンティティのスコープ内に同じ公開キーを持つ別のアイデンティティが存在する場合、または別の例外が発生した場合。SecurityException
- セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccess
メソッドが公開キーの設定を許可しない場合。- 関連項目:
-
setInfo
public void setInfo(String info) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
の一般情報文字列を指定します。セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャの
checkSecurityAccess
メソッドが引数として"setIdentityInfo"
を指定して呼び出され、情報文字列の設定をしてもよいかどうかを確認します。- パラメータ:
info
- 情報文字列。- 例外:
SecurityException
- セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccess
メソッドが情報文字列の設定を許可しない場合。- 関連項目:
-
getInfo
public String getInfo()削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
に対して以前に指定された一般情報を返します。- 戻り値:
- この
Identity
に関する一般情報。 - 関連項目:
-
addCertificate
public void addCertificate(Certificate certificate) throws KeyManagementException 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
の証明書を追加します。Identity
に公開キーがある場合、証明書内の公開キーは同じである必要があり、Identity
に公開キーがない場合、アイデンティティの公開キーは証明書で指定されたものに設定されます。セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャの
checkSecurityAccess
メソッドが引数として"addIdentityCertificate"
を指定して呼び出され、証明書を追加してもよいかどうかを確認します。- パラメータ:
certificate
- 追加される証明書。- 例外:
KeyManagementException
- 証明書が有効でない場合、追加される証明書中の公開キーがこのアイデンティティの公開キーと重複する場合、あるいはほかの例外が発生した場合。SecurityException
- セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccess
メソッドが証明書の追加を許可しない場合。- 関連項目:
-
removeCertificate
public void removeCertificate(Certificate certificate) throws KeyManagementException 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
から証明書を削除します。セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャの
checkSecurityAccess
メソッドが引数として"removeIdentityCertificate"
を指定して呼び出され、証明書を削除してもよいかどうかを確認します。- パラメータ:
certificate
- 削除される証明書。- 例外:
KeyManagementException
- 証明書がない場合、またはほかの例外が発生した場合。SecurityException
- セキュリティ・マネージャが存在し、セキュリティ・マネージャのcheckSecurityAccess
メソッドが証明書の削除を許可しない場合。- 関連項目:
-
certificates
public Certificate[] certificates()削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
のすべての証明書のコピーを返します。- 戻り値:
- この
Identity
のすべての証明書のコピー。
-
equals
public final boolean equals(Object identity) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。指定されたオブジェクトとこのIdentity
の間の等価性をテストします。 最初に、エンティティが同じオブジェクトを参照しているかどうかがテストされ、その場合はtrue
が返されます。 次に、各エンティティの名前とスコープが等しいかどうかを調べます。 その場合、メソッドはtrue
を返します。 それ以外の場合は、サブクラスがオーバーライドする必要があるidentityEquals
を呼び出します。 -
identityEquals
protected boolean identityEquals(Identity identity) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。指定されたIdentity
とこのIdentity
の間の等価性をテストします。 このメソッドは、等価性をテストするためにサブクラスによってオーバーライドされる必要があります。 デフォルトの動作では、名前と公開キーが等しい場合にtrue
が返されます。- パラメータ:
identity
- このidentity
と等しいかどうかをテストするアイデンティティ。- 戻り値:
- IDが等しいとみなされる場合は
true
、そうでない場合はfalse
。 - 関連項目:
-
toString
public String toString()削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
を記述する短い文字列を返し、名前とそのスコープ(もしあれば)を示します。セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャの
checkSecurityAccess
メソッドが引数として"printIdentity"
を指定して呼び出され、文字列を返してもよいかどうかを確認します。- 定義:
toString
、インタフェースPrincipal
- オーバーライド:
toString
、クラスObject
- 戻り値:
- この
Identity
に関する情報(スコープの名前や(もしあれば)の名前など)。 - 例外:
SecurityException
- セキュリティ・マネージャが存在し、そのcheckSecurityAccess
メソッドがこのIdentity
を記述する文字列を返さない場合。- 関連項目:
-
toString
public String toString(boolean detailed) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
の文字列表現を返します。オプションで、引数なしのtoString
メソッドで提供されるものよりも詳細な情報を提供します。セキュリティ・マネージャが存在する場合、最初にセキュリティ・マネージャの
checkSecurityAccess
メソッドが引数として"printIdentity"
を指定して呼び出され、文字列を返してもよいかどうかを確認します。- パラメータ:
detailed
- 詳細情報を提供するかどうか。- 戻り値:
- この
Identity
に関する情報。detailed
がtrue
の場合、このメソッドは、引数なしでtoString
メソッドによって提供されるより多くの情報を返します。 - 例外:
SecurityException
- セキュリティ・マネージャが存在し、そのcheckSecurityAccess
メソッドがこのIdentity
を記述する文字列を返さない場合。- 関連項目:
-
hashCode
public int hashCode()削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このIdentity
のハッシュ・コードを返します。
-
java.security.KeyStore
、java.security.cert
パッケージ、およびjava.security.Principal
に置き換えられています。