<tokenIssuer> Element (WSE for Microsoft .NET) (2)

  • Article

Specifies the settings for a security token service.

<microsoft.web.services2> Element

<tokenIssuer>
  <autoIssueSecurityContextToken enabled="true">
  <serverToken/>
  <ttlInSeconds/> 
</tokenIssuer>

Attributes and Elements

Attributes

None

Child Elements

Element Description

<autoIssueSecurityContextToken> Element

Optional element. Specifies whether a Web service automatically issues SecurityContextToken security tokens.

<serverToken> Element

Optional element. Specifies the security token used to sign the response for a security token request.

<ttlInSeconds> Element

Optional element. Specifes, in seconds, how long issued SecurityContextToken security tokens are valid.

Parent Elements

Element Description

<microsoft.web.services2> Element

Controls the configuration options defined by WSE.

Remarks

Use the <tokenIssuer> element when you issue security tokens. WSE allows you to issue SecurityContextToken security tokens just by adding configuration elements and to issue other security tokens by creating a class and adding configuration elements. When you issue SecurityContextToken security tokens, use the required <serverToken> Element element and the optional <autoIssueSecurityContextToken> Element and <ttlInSeconds> Element elements. For more details about issuing security tokens, see Issuing Security Tokens.

Before adding the <tokenIssuer> element to a configuration file, you must add the microsoft.web.services2 configuration section handler to the configuration file. For details about adding the microsoft.web.services2 configuration section handler, see <section> Element (WSE for Microsoft .NET).

Example

The following code example specifies an X509SecurityToken with a specific key to sign the responses for security token requests.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <microsoft.web.services2>
    <tokenIssuer>
      <serverToken>
        <KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">
          <wsse:SecurityTokenReference 
            xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
            <wsse:KeyIdentifier ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509SubjectKeyIdentifier">
              ZPGrPnuqATeSgVjLYcmiY/GSWWY=
            </wsse:KeyIdentifier>
          </wsse:SecurityTokenReference>
        </KeyInfo>
      </serverToken>
    </tokenIssuer>
  </microsoft.web.services2>
</configuration>

See Also

Reference

<autoIssueSecurityContextToken> Element
<serverToken> Element
<ttlInSeconds> Element

Other Resources

Issuing Security Tokens