- java.lang.Object
-
- java.security.Identity
-
- java.security.IdentityScope
-
- All Implemented Interfaces:
- Serializable, Principal
Deprecated.This class is no longer used. Its functionality has been replaced byjava.security.KeyStore
, thejava.security.cert
package, andjava.security.Principal
.
@Deprecated public abstract class IdentityScope extends Identity
This class represents a scope for identities. It is an Identity itself, and therefore has a name and can have a scope. It can also optionally have a public key and associated certificates.
An IdentityScope can contain Identity objects of all kinds, including Signers. All types of Identity objects can be retrieved, added, and removed using the same methods. Note that it is possible, and in fact expected, that different types of identity scopes will apply different policies for their various operations on the various types of Identities.
There is a one-to-one mapping between keys and identities, and there can only be one copy of one key per scope. For example, suppose Acme Software, Inc is a software publisher known to a user. Suppose it is an Identity, that is, it has a public key, and a set of associated certificates. It is named in the scope using the name "Acme Software". No other named Identity in the scope has the same public key. Of course, none has the same name as well.
- See Also:
Identity
,Signer
,Principal
,Key
, Serialized Form
-
-
Constructor Summary
Constructors Modifier Constructor and Description protected
IdentityScope()
Deprecated.This constructor is used for serialization only and should not be used by subclasses.IdentityScope(String name)
Deprecated.Constructs a new identity scope with the specified name.IdentityScope(String name, IdentityScope scope)
Deprecated.Constructs a new identity scope with the specified name and scope.
-
Method Summary
Methods Modifier and Type Method and Description abstract void
addIdentity(Identity identity)
Deprecated.Adds an identity to this identity scope.Identity
getIdentity(Principal principal)
Deprecated.Retrieves the identity whose name is the same as that of the specified principal.abstract Identity
getIdentity(PublicKey key)
Deprecated.Retrieves the identity with the specified public key.abstract Identity
getIdentity(String name)
Deprecated.Returns the identity in this scope with the specified name (if any).static IdentityScope
getSystemScope()
Deprecated.Returns the system's identity scope.abstract Enumeration<Identity>
identities()
Deprecated.Returns an enumeration of all identities in this identity scope.abstract void
removeIdentity(Identity identity)
Deprecated.Removes an identity from this identity scope.protected static void
setSystemScope(IdentityScope scope)
Deprecated.Sets the system's identity scope.abstract int
size()
Deprecated.Returns the number of identities within this identity scope.String
toString()
Deprecated.Returns a string representation of this identity scope, including its name, its scope name, and the number of identities in this identity scope.-
Methods inherited from class java.security.Identity
addCertificate, certificates, equals, getInfo, getName, getPublicKey, getScope, hashCode, identityEquals, removeCertificate, setInfo, setPublicKey, toString
-
-
-
-
Constructor Detail
-
IdentityScope
protected IdentityScope()
Deprecated.This constructor is used for serialization only and should not be used by subclasses.
-
IdentityScope
public IdentityScope(String name)
Deprecated.Constructs a new identity scope with the specified name.- Parameters:
name
- the scope name.
-
IdentityScope
public IdentityScope(String name, IdentityScope scope) throws KeyManagementException
Deprecated.Constructs a new identity scope with the specified name and scope.- Parameters:
name
- the scope name.scope
- the scope for the new identity scope.- Throws:
KeyManagementException
- if there is already an identity with the same name in the scope.
-
-
Method Detail
-
getSystemScope
public static IdentityScope getSystemScope()
Deprecated.Returns the system's identity scope.- Returns:
- the system's identity scope, or
null
if none has been set. - See Also:
setSystemScope(java.security.IdentityScope)
-
setSystemScope
protected static void setSystemScope(IdentityScope scope)
Deprecated.Sets the system's identity scope.First, if there is a security manager, its
checkSecurityAccess
method is called with"setSystemScope"
as its argument to see if it's ok to set the identity scope.- Parameters:
scope
- the scope to set.- Throws:
SecurityException
- if a security manager exists and itscheckSecurityAccess
method doesn't allow setting the identity scope.- See Also:
getSystemScope()
,SecurityManager.checkSecurityAccess(java.lang.String)
-
size
public abstract int size()
Deprecated.Returns the number of identities within this identity scope.- Returns:
- the number of identities within this identity scope.
-
getIdentity
public abstract Identity getIdentity(String name)
Deprecated.Returns the identity in this scope with the specified name (if any).- Parameters:
name
- the name of the identity to be retrieved.- Returns:
- the identity named
name
, or null if there are no identities namedname
in this scope.
-
getIdentity
public Identity getIdentity(Principal principal)
Deprecated.Retrieves the identity whose name is the same as that of the specified principal. (Note: Identity implements Principal.)- Parameters:
principal
- the principal corresponding to the identity to be retrieved.- Returns:
- the identity whose name is the same as that of the principal, or null if there are no identities of the same name in this scope.
-
getIdentity
public abstract Identity getIdentity(PublicKey key)
Deprecated.Retrieves the identity with the specified public key.- Parameters:
key
- the public key for the identity to be returned.- Returns:
- the identity with the given key, or null if there are no identities in this scope with that key.
-
addIdentity
public abstract void addIdentity(Identity identity) throws KeyManagementException
Deprecated.Adds an identity to this identity scope.- Parameters:
identity
- the identity to be added.- Throws:
KeyManagementException
- if the identity is not valid, a name conflict occurs, another identity has the same public key as the identity being added, or another exception occurs.
-
removeIdentity
public abstract void removeIdentity(Identity identity) throws KeyManagementException
Deprecated.Removes an identity from this identity scope.- Parameters:
identity
- the identity to be removed.- Throws:
KeyManagementException
- if the identity is missing, or another exception occurs.
-
identities
public abstract Enumeration<Identity> identities()
Deprecated.Returns an enumeration of all identities in this identity scope.- Returns:
- an enumeration of all identities in this identity scope.
-
toString
public String toString()
Deprecated.Returns a string representation of this identity scope, including its name, its scope name, and the number of identities in this identity scope.- Specified by:
toString
in interfacePrincipal
- Overrides:
toString
in classIdentity
- Returns:
- a string representation of this identity scope.
- See Also:
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/identityscope.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
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.