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