PicketLink Federation Core 2.1.6.Final-redhat-2

org.picketlink.identity.federation.core.interfaces
Interface SecurityTokenProvider

All Known Implementing Classes:
AbstractSecurityTokenProvider, SAML11AssertionTokenProvider, SAML11TokenProvider, SAML20AssertionTokenProvider, SAML20TokenProvider

public interface SecurityTokenProvider

This interface defines the methods that must be implemented by security token providers.

Author:
Stefan Guilhen

Nested Class Summary
static class SecurityTokenProvider.FAMILY_TYPE
          An enumeration that identifies the family to which the security token provider belongs
 
Method Summary
 void cancelToken(ProtocolContext context)
           Cancels the token contained in the specified request context.
 String family()
          The family where this security token provider belongs
 QName getSupportedQName()
          Provide an optional QName for configuration
 void initialize(Map<String,String> properties)
           Initializes the SecurityTokenProvider using the specified properties map.
 void issueToken(ProtocolContext context)
           Generates a security token using the information contained in the specified request context and stores the newly-created token in the context itself.
 void renewToken(ProtocolContext context)
           Renews the security token contained in the specified request context.
 boolean supports(String namespace)
          Specify whether this token provider supports a particular namespace
 String tokenType()
          Token Type
 void validateToken(ProtocolContext context)
           Evaluates the validity of the token contained in the specified request context and sets the result in the context itself.
 

Method Detail

initialize

void initialize(Map<String,String> properties)

Initializes the SecurityTokenProvider using the specified properties map.

Parameters:
properties - a Map<String, String> that contains the properties that have been configured for this SecurityTokenProvider.

supports

boolean supports(String namespace)
Specify whether this token provider supports a particular namespace

Parameters:
namespace - a string value representing a namespace
Returns:

tokenType

String tokenType()
Token Type

Returns:

getSupportedQName

QName getSupportedQName()
Provide an optional QName for configuration

Returns:

family

String family()
The family where this security token provider belongs

Returns:
See Also:
FAMILY_TYPE}

issueToken

void issueToken(ProtocolContext context)
                throws ProcessingException

Generates a security token using the information contained in the specified request context and stores the newly-created token in the context itself.

Parameters:
context - the ProtocolContext to be used when generating the token.
Throws:
WSTrustException - if an error occurs while creating the security token.
ProcessingException

renewToken

void renewToken(ProtocolContext context)
                throws ProcessingException

Renews the security token contained in the specified request context. This method is used when a previously generated token has expired, generating a new version of the same token with different expiration semantics.

Parameters:
context - the ProtocolContext that contains the token to be renewed.
Throws:
WSTrustException - if an error occurs while renewing the security token.
ProcessingException

cancelToken

void cancelToken(ProtocolContext context)
                 throws ProcessingException

Cancels the token contained in the specified request context. A security token is usually canceled when one wants to make sure that the token will not be used anymore. A security token can't be renewed once it has been canceled.

Parameters:
context - the ProtocolContext that contains the token to be canceled.
Throws:
WSTrustException - if an error occurs while canceling the security token.
ProcessingException

validateToken

void validateToken(ProtocolContext context)
                   throws ProcessingException

Evaluates the validity of the token contained in the specified request context and sets the result in the context itself. The result can be a status, a new token, or both.

Parameters:
context - the ProtocolContext that contains the token to be validated.
Throws:
WSTrustException - if an error occurs while validating the security token.
ProcessingException

PicketLink Federation Core 2.1.6.Final-redhat-2

Copyright © 2013 JBoss by Red Hat. All Rights Reserved.