Package com.tivoli.am.fim.trustserver.sts

Interface STSRequest

All Superinterfaces:
com.tivoli.am.fim.trustserver.sts.STSPrefixResolver, com.tivoli.am.fim.trustserver.sts.STSReqResp
public interface STSRequest extends com.tivoli.am.fim.trustserver.sts.STSReqResp
The STSRequest object encapsulates information specific to the current request including data from the requestor via the RequestSecurityToken. In addition, this object provides:
  1. module to module communication via the various attribute methods.
  2. access to the STSSession object which can be used to cache/store objects (like nonces) across multiple requests.
  3. access to services such as the kess service and alias service.
  4. access to partner/endpoint parameters that are specific to this request.
Version:
@VERSION@

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    STSRequest_java_copyright
     
    static final String
    STSRequest_java_sourceCodeID
     

    Fields inherited from interface com.tivoli.am.fim.trustserver.sts.STSPrefixResolver

    STSPrefixResolver_java_copyright, STSPrefixResolver_java_sourceCodeID

  • Method Summary

    Modifier and Type
    Method
    Description
    Object
    getAttribute(String name)
    Returns the value of the named attribute as an Object, or null if no attribute of the given name exists.
    Iterator
    getAttributeNames()
    Returns a java.util.Iterator containing the names of the attributes available to this request.
    String
    getAuditTrailID()
    Get the Audit trail ID This ID should be used on all audit related logging so that audit records for a request may be correlated across different logging destinations and sources.
    com.tivoli.am.fim.trustserver.sts.STSGroupMembership
    getRequestGroupMembership()
    Get the instance of the group membership appropriate for the current request to use as configuration to fulfill the request.
    RequestSecurityToken
    getRequestSecurityToken()
    Returns the WS-Trust RequestSecurityToken as a com.tivoli.am.fim.trustserver.types.RequestSecurityToken object.
    Object
    getServiceHandle(String serviceId)
    Returns a Service handle that belongs to the servideId specified.
    Element
    getSOAPEnvelope()
    Returns the SOAP envelop as a org.w3c.dom.Element sent in the client's request, if any.
    com.tivoli.am.fim.trustserver.sts.STSSession
    getSTSSession()
    Returns a session object to add attribute values that are maintained across multiple requests.
    Element
    getWsTrustMsg()
    Returns the WS-Trust message as a org.w3c.dom.Element sent in the client's request, if any.
    void
    setAttribute(String name, Object value)
    Stores an attribute in this request.

    Methods inherited from interface com.tivoli.am.fim.trustserver.sts.STSPrefixResolver

    addNamespaceMapping, createQName, getNamespacePrefix, getNamespacePrefixes, getNamespaceURI, getNamespaceURIs

  • Field Details

  • Method Details

    • getSTSSession

      com.tivoli.am.fim.trustserver.sts.STSSession getSTSSession()
      Returns a session object to add attribute values that are maintained across multiple requests.
      Returns:
      a STSSession object

    • getSOAPEnvelope

      Element getSOAPEnvelope()
      Returns the SOAP envelop as a org.w3c.dom.Element sent in the client's request, if any. This method exposes a leaky abstraction, and may not be available if the request was not sent via SOAP. It is recommended that this method be used only if it can be guaranteed that the request will be sent via SOAP.
      Returns:
      a org.w3c.dom.Element of the SOAP envelope that was sent in the client's request or null.

    • getWsTrustMsg

      Element getWsTrustMsg()
      Returns the WS-Trust message as a org.w3c.dom.Element sent in the client's request, if any. It must be the original unchanged DOM element. This method exposes a leaky abstraction, and may not be available if the request was not sent via SOAP. It is recommended that this method be used only if it can be guaranteed that the request will be sent via SOAP.
      Returns:
      a org.w3c.dom.Element of the SOAP envelope that was sent in the client's request or null.

    • getRequestSecurityToken

      RequestSecurityToken getRequestSecurityToken()
      Returns the WS-Trust RequestSecurityToken as a com.tivoli.am.fim.trustserver.types.RequestSecurityToken object.
      Returns:
      The RequestSecurityToken included with the request.

    • getAttribute

      Object getAttribute(String name)
      Returns the value of the named attribute as an Object, or null if no attribute of the given name exists.
      Parameters:
      name - a String specifying the name of the attribute.
      Returns:
      an Object containing the value of the attribute, or null if the attribute does not exist.

    • getAttributeNames

      Iterator getAttributeNames()
      Returns a java.util.Iterator containing the names of the attributes available to this request. This method returns an empty java.util.Iterator if the request has no attributes available to it.
      Returns:
      a java.util.Interator of strings containing the names of the request's attributes.

    • setAttribute

      void setAttribute(String name, Object value)
      Stores an attribute in this request. Attributes are reset between requests.
      Parameters:
      name - a String specifying the name of the attribute.
      value - the object to be stored.

    • getServiceHandle

      Object getServiceHandle(String serviceId)
      Returns a Service handle that belongs to the servideId specified.
      Parameters:
      serviceId - the name of the service to obtain.

    • getRequestGroupMembership

      com.tivoli.am.fim.trustserver.sts.STSGroupMembership getRequestGroupMembership()
      Get the instance of the group membership appropriate for the current request to use as configuration to fulfill the request. This method should be used to retrieve configuration parameters and endpoint/partner policy.
      Returns:
      An STSGroupMembership object.

    • getAuditTrailID

      String getAuditTrailID()
      Get the Audit trail ID This ID should be used on all audit related logging so that audit records for a request may be correlated across different logging destinations and sources.