Share via

<serverToken> Element

  • Article

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

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

<serverToken>
    <KeyInfo>
    </KeyInfo> 
</serverToken>

Attributes and Elements

Attributes

None

Child Elements

Element Description

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

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

Parent Elements

Element Description

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

Specifies the settings for a security token service.

Remarks

Use the <serverToken> element when you issue security tokens, including SecurityContextToken security tokens. The <serverToken> element is used to sign the response for a security token request, so the target Web service can verify that the contents of the issued security token have not been tampered within since it was issued. For more details about issuing security tokens, see Issuing Security Tokens.

Before adding the <serverToken> 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

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

Other Resources

Issuing Security Tokens