net.shibboleth.idp.saml.nameid.impl

Class StoredTransientIdGenerationStrategy

java.lang.Object

net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

net.shibboleth.idp.saml.nameid.impl.StoredTransientIdGenerationStrategy

All Implemented Interfaces:

TransientIdGenerationStrategy, Component, DestructableComponent, IdentifiableComponent, IdentifiedComponent, InitializableComponent

public class StoredTransientIdGenerationStrategy
extends AbstractIdentifiableInitializableComponent
implements TransientIdGenerationStrategy

Generates transients using a StorageService to manage the reverse mappings.

The identifier itself is the record key, and the value combines the principal name with the identifier of the recipient.

Field Summary

Fields

Modifier and Type	Field and Description
private IdentifierGenerationStrategy	idGenerator Generator of random, hex-encoded, identifiers.
private long	idLifetime Length, in milliseconds, identifiers are valid.
private int	idSize Size, in bytes, of the identifier.
private org.opensaml.storage.StorageService	idStore Store used to map identifiers to principals.
private org.slf4j.Logger	log Class logger.

Constructor Summary

Constructors

Constructor and Description
StoredTransientIdGenerationStrategy() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doInitialize()
String	generate(String relyingPartyId, String principalName) Generate a new Transient ID.
long	getIdLifetime() Get the time, in milliseconds, ids are valid.
int	getIdSize() Get the size, in bytes, of the id.
void	setIdGenerator(IdentifierGenerationStrategy generator) Set the ID generator we should use.
void	setIdLifetime(long lifetime) Set the time, in milliseconds, ids are valid.
void	setIdSize(int size) Set the size, in bytes, of the id.
void	setIdStore(org.opensaml.storage.StorageService store) Set the ID store we should use.

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiableInitializableComponent

setId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractIdentifiedInitializableComponent

getId

Methods inherited from class net.shibboleth.utilities.java.support.component.AbstractInitializableComponent

destroy, doDestroy, initialize, isDestroyed, isInitialized

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface net.shibboleth.utilities.java.support.component.IdentifiedComponent

getId

Field Detail

log

@Nonnull
private final org.slf4j.Logger log

Class logger.

idStore

@NonnullAfterInit
private org.opensaml.storage.StorageService idStore

Store used to map identifiers to principals.

idGenerator

@NonnullAfterInit
private IdentifierGenerationStrategy idGenerator

Generator of random, hex-encoded, identifiers.

idSize

private int idSize

Size, in bytes, of the identifier.

idLifetime

@Duration
@Positive
private long idLifetime

Length, in milliseconds, identifiers are valid.

Constructor Detail

StoredTransientIdGenerationStrategy

public StoredTransientIdGenerationStrategy()

Constructor.

Method Detail

setIdStore

public void setIdStore(@Nonnull
              org.opensaml.storage.StorageService store)

Set the ID store we should use.

Parameters:

store - the store to use.

setIdGenerator

public void setIdGenerator(@Nonnull
                  IdentifierGenerationStrategy generator)

Set the ID generator we should use.

Parameters:

generator - identifier generation strategy to use

getIdSize

@Positive
public int getIdSize()

Get the size, in bytes, of the id.

Returns:

id size, in bytes

setIdSize

public void setIdSize(@Positive
             int size)

Set the size, in bytes, of the id.

Parameters:

size - size, in bytes, of the id

getIdLifetime

@Positive
public long getIdLifetime()

Get the time, in milliseconds, ids are valid.

Returns:

time, in milliseconds, ids are valid

setIdLifetime

public void setIdLifetime(@Duration@Positive
                 long lifetime)

Set the time, in milliseconds, ids are valid.

Parameters:

lifetime - time, in milliseconds, ids are valid

doInitialize

protected void doInitialize()
                     throws ComponentInitializationException

Overrides:

doInitialize in class AbstractIdentifiedInitializableComponent

Throws:

ComponentInitializationException

generate

@Nonnull
@NotEmpty
public String generate(@Nonnull@NotEmpty
                               String relyingPartyId,
                               @Nonnull@NotEmpty
                               String principalName)
                throws org.opensaml.saml.common.SAMLException

Generate a new Transient ID.

Specified by:

generate in interface TransientIdGenerationStrategy

Parameters:

relyingPartyId - the relying party for whom we're generating

principalName - the principal to map to

Returns:

the new identifier

Throws:

org.opensaml.saml.common.SAMLException - if an error occurs generating the identifier