java.security
Class Identity

java.lang.Object
  |
  +--java.security.Identity

All Implemented Interfaces:

Principal, Serializable

Direct Known Subclasses:

IdentityScope, Signer

Deprecated. This class is no longer used. Its functionality has been replaced by java.security.KeyStore, the java.security.cert package, and java.security.Principal.

public abstract class Identity

extends Object

implements Principal, Serializable

Untamed:

This class represents identities: real-world objects such as people, companies or organizations whose identities can be authenticated using their public keys. Identities may also be more abstract (or concrete) constructs, such as daemon threads or smart cards.

All Identity objects have a name and a public key. Names are immutable. Identities may also be scoped. That is, if an Identity is specified to have a particular scope, then the name and public key of the Identity are unique within that scope.

An Identity also has a set of certificates (all certifying its own public key). The Principal names specified in these certificates need not be the same, only the key.

An Identity can be subclassed, to include postal and email addresses, telephone numbers, images of faces and logos, and so on.

Version:

1.58

Author:

Benjamin Renaud

See Also:

IdentityScope, Signer, Principal, Serialized Form

Field Summary

(package private) Vector	certificates Deprecated. The certificates for this identity.
(package private) String	info Deprecated. Generic, descriptive information about the identity.
private String	name Deprecated. The name for this identity.
private PublicKey	publicKey Deprecated. The public key for this identity.
(package private) IdentityScope	scope Deprecated. The scope of the identity.
private static long	serialVersionUID Deprecated. use serialVersionUID from JDK 1.1.x for interoperability

Constructor Summary

protected	Identity() Deprecated. Constructor for serialization only.
	Identity(String name) Deprecated. Enabled: Constructs an identity with the specified name and no scope.
	Identity(String name, IdentityScope scope) Deprecated. Enabled: Constructs an identity with the specified name and scope.

Method Summary

void	addCertificate(Certificate certificate) Deprecated. Enabled: Adds a certificate for this identity.
Certificate[]	certificates() Deprecated. Enabled: Returns a copy of all the certificates for this identity.
private static void	check(String directive) Deprecated.
boolean	equals(Object identity) Deprecated. Suppressed: Tests for equality between the specified object and this identity.
(package private) String	fullName() Deprecated. Returns a parsable name for identity: identityName.scopeName
String	getInfo() Deprecated. Enabled: Returns general information previously specified for this identity.
String	getName() Deprecated. Enabled: Returns this identity's name.
PublicKey	getPublicKey() Deprecated. Enabled: Returns this identity's public key.
IdentityScope	getScope() Deprecated. Enabled: Returns this identity's scope.
int	hashCode() Deprecated. Suppressed: Returns a hashcode for this identity.
protected boolean	identityEquals(Identity identity) Deprecated. Tests for equality between the specified identity and this identity.
private boolean	keyEquals(Key aKey, Key anotherKey) Deprecated.
(package private) String	printCertificates() Deprecated.
(package private) String	printKeys() Deprecated.
void	removeCertificate(Certificate certificate) Deprecated. Enabled: Removes a certificate from this identity.
void	setInfo(String info) Deprecated. Enabled: Specifies a general information string for this identity.
void	setPublicKey(PublicKey key) Deprecated. Enabled: Sets this identity's public key.
String	toString() Deprecated. Suppressed: Returns a short string describing this identity, telling its name and its scope (if any).
String	toString(boolean detailed) Deprecated. Enabled: Returns a string representation of this identity, with optionally more details than that provided by the toString method without any arguments.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

Deprecated.

use serialVersionUID from JDK 1.1.x for interoperability

name

private String name

Deprecated.

The name for this identity.

publicKey

private PublicKey publicKey

Deprecated.

The public key for this identity.

info

String info

Deprecated.

Generic, descriptive information about the identity.

scope

IdentityScope scope

Deprecated.

The scope of the identity.

certificates

Vector certificates

Deprecated.

The certificates for this identity.

Constructor Detail

Identity

protected Identity()

Deprecated.

Constructor for serialization only.

Identity

public Identity(String name,
                IdentityScope scope)
         throws KeyManagementException

Deprecated.

Enabled: Constructs an identity with the specified name and scope.

Parameters:

name - the identity name.

scope - the scope of the identity.

Identity

public Identity(String name)

Deprecated.

Enabled: Constructs an identity with the specified name and no scope.

Parameters:

name - the identity name.

Method Detail

getName

public final String getName()

Deprecated.

Enabled: Returns this identity's name.

Specified by:

getName in interface Principal

Returns:

the name of this identity.

getScope

public final IdentityScope getScope()

Deprecated.

Enabled: Returns this identity's scope.

Returns:

the scope of this identity.

getPublicKey

public PublicKey getPublicKey()

Deprecated.

Enabled: Returns this identity's public key.

Returns:

the public key for this identity.

See Also:

setPublicKey(java.security.PublicKey)

setPublicKey

public void setPublicKey(PublicKey key)
                  throws KeyManagementException

Deprecated.

Enabled: Sets this identity's public key. The old key and all of this identity's certificates are removed by this operation.

First, if there is a security manager, its checkSecurityAccess method is called with "setIdentityPublicKey" as its argument to see if it's ok to set the public key.

Parameters:

key - the public key for this identity.

KeyManagementException

See Also:

getPublicKey(), SecurityManager.checkSecurityAccess(java.lang.String)

setInfo

public void setInfo(String info)

Deprecated.

Enabled: Specifies a general information string for this identity.

First, if there is a security manager, its checkSecurityAccess method is called with "setIdentityInfo" as its argument to see if it's ok to specify the information string.

Parameters:

info - the information string.

See Also:

getInfo(), SecurityManager.checkSecurityAccess(java.lang.String)

getInfo

public String getInfo()

Deprecated.

Enabled: Returns general information previously specified for this identity.

Returns:

general information about this identity.

See Also:

setInfo(java.lang.String)

addCertificate

public void addCertificate(Certificate certificate)
                    throws KeyManagementException

Deprecated.

Enabled: Adds a certificate for this identity. If the identity has a public key, the public key in the certificate must be the same, and if the identity does not have a public key, the identity's public key is set to be that specified in the certificate.

First, if there is a security manager, its checkSecurityAccess method is called with "addIdentityCertificate" as its argument to see if it's ok to add a certificate.

Parameters:

certificate - the certificate to be added.

KeyManagementException

See Also:

SecurityManager.checkSecurityAccess(java.lang.String)

keyEquals

private boolean keyEquals(Key aKey,
                          Key anotherKey)

Deprecated.

removeCertificate

public void removeCertificate(Certificate certificate)
                       throws KeyManagementException

Deprecated.

Enabled: Removes a certificate from this identity.

First, if there is a security manager, its checkSecurityAccess method is called with "removeIdentityCertificate" as its argument to see if it's ok to remove a certificate.

Parameters:

certificate - the certificate to be removed.

KeyManagementException

See Also:

SecurityManager.checkSecurityAccess(java.lang.String)

certificates

public Certificate[] certificates()

Deprecated.

Enabled: Returns a copy of all the certificates for this identity.

Returns:

a copy of all the certificates for this identity.

equals

public final boolean equals(Object identity)

Deprecated.

Suppressed: Tests for equality between the specified object and this identity. This first tests to see if the entities actually refer to the same object, in which case it returns true. Next, it checks to see if the entities have the same name and the same scope. If they do, the method returns true. Otherwise, it calls identityEquals, which subclasses should override.

Specified by:

equals in interface Principal

Overrides:

equals in class Object

Parameters:

identity - the object to test for equality with this identity.

Returns:

true if the objects are considered equal, false otherwise.

See Also:

identityEquals(java.security.Identity)

identityEquals

protected boolean identityEquals(Identity identity)

Deprecated.

Tests for equality between the specified identity and this identity. This method should be overriden by subclasses to test for equality. The default behavior is to return true if the names and public keys are equal.

Parameters:

identity - the identity to test for equality with this identity.

Returns:

true if the identities are considered equal, false otherwise.

See Also:

equals(java.lang.Object)

fullName

String fullName()

Deprecated.

Returns a parsable name for identity: identityName.scopeName

toString

public String toString()

Deprecated.

Suppressed: Returns a short string describing this identity, telling its name and its scope (if any).

First, if there is a security manager, its checkSecurityAccess method is called with "printIdentity" as its argument to see if it's ok to return the string.

Specified by:

toString in interface Principal

Overrides:

toString in class Object

Returns:

information about this identity, such as its name and the name of its scope (if any).

See Also:

SecurityManager.checkSecurityAccess(java.lang.String)

toString

public String toString(boolean detailed)

Deprecated.

Enabled: Returns a string representation of this identity, with optionally more details than that provided by the toString method without any arguments.

First, if there is a security manager, its checkSecurityAccess method is called with "printIdentity" as its argument to see if it's ok to return the string.

Parameters:

detailed - whether or not to provide detailed information.

Returns:

information about this identity. If detailed is true, then this method returns more information than that provided by the toString method without any arguments.

See Also:

toString(), SecurityManager.checkSecurityAccess(java.lang.String)

printKeys

String printKeys()

Deprecated.

printCertificates

String printCertificates()

Deprecated.

hashCode

public int hashCode()

Deprecated.

Suppressed: Returns a hashcode for this identity.

Specified by:

hashCode in interface Principal

Overrides:

hashCode in class Object

Returns:

a hashcode for this identity.

check

private static void check(String directive)

Deprecated.