java.security

Class Identity

Inhoudsopgave
  • All Implemented Interfaces:
    Serializable, Principal
    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.

    @Deprecated
public abstract class Identity
extends Object
implements Principal, Serializable

    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.

    See Also:
    IdentityScope, Signer, Principal, Serialized Form

    • Constructor Detail

      • Identity

        protected Identity()
        Deprecated. 
        Constructor for serialization only.

      • Identity

        public Identity(String name,
        IdentityScope scope)
         throws KeyManagementException
        Deprecated. 
        Constructs an identity with the specified name and scope.
        Parameters:
        name - the identity name.
        scope - the scope of the identity.
        Throws:
        KeyManagementException - if there is already an identity with the same name in the scope.

      • Identity

        public Identity(String name)
        Deprecated. 
        Constructs an identity with the specified name and no scope.
        Parameters:
        name - the identity name.

    • Method Detail

      • getName

        public final String getName()
        Deprecated. 
        Returns this identity's name.
        Specified by:
        getName in interface Principal
        Returns:
        the name of this identity.

      • getScope

        public final IdentityScope getScope()
        Deprecated. 
        Returns this identity's scope.
        Returns:
        the scope of this identity.

      • setPublicKey

        public void setPublicKey(PublicKey key)
                  throws KeyManagementException
        Deprecated. 
        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.
        Throws:
        KeyManagementException - if another identity in the identity's scope has the same public key, or if another exception occurs.
        SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow setting the public key.
        See Also:
        getPublicKey(), SecurityManager.checkSecurityAccess(java.lang.String)

      • setInfo

        public void setInfo(String info)
        Deprecated. 
        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.
        Throws:
        SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow setting the information string.
        See Also:
        getInfo(), SecurityManager.checkSecurityAccess(java.lang.String)

      • getInfo

        public String getInfo()
        Deprecated. 
        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. 
        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.
        Throws:
        KeyManagementException - if the certificate is not valid, if the public key in the certificate being added conflicts with this identity's public key, or if another exception occurs.
        SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow adding a certificate.
        See Also:
        SecurityManager.checkSecurityAccess(java.lang.String)

      • removeCertificate

        public void removeCertificate(Certificate certificate)
                       throws KeyManagementException
        Deprecated. 
        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.
        Throws:
        KeyManagementException - if the certificate is missing, or if another exception occurs.
        SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow removing a certificate.
        See Also:
        SecurityManager.checkSecurityAccess(java.lang.String)

      • certificates

        public Certificate[] certificates()
        Deprecated. 
        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. 
        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)

      • toString

        public String toString()
        Deprecated. 
        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).
        Throws:
        SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow returning a string describing this identity.
        See Also:
        SecurityManager.checkSecurityAccess(java.lang.String)

      • toString

        public String toString(boolean detailed)
        Deprecated. 
        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.
        Throws:
        SecurityException - if a security manager exists and its checkSecurityAccess method doesn't allow returning a string describing this identity.
        See Also:
        toString(), SecurityManager.checkSecurityAccess(java.lang.String)

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-java/security/Identity.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Referenties

  1. Bekijk - html-document Taal van het document:fr Manuel PHP : https://docs.oracle.com

Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.

Inhoudsopgave Haut