Export (0) Print
Expand All

How to: Use Multiple Security Tokens of the Same Type

  • In .NET Framework 3.0, a client message only contained one token of any given type. Now client messages can contain multiple tokens of a type. This topic shows how to include multiple tokens of the same type in a client message.

  • Note that you cannot configure a service in this way: a service can contain only one supporting token.

To use multiple security tokens of the same type

  1. Create an empty binding element collection to be populated.

    
    // Create an empty BindingElementCollection to populate, 
    // then create a custom binding from it.
    BindingElementCollection bec = new BindingElementCollection();
    
    
    
  2. Create a SecurityBindingElement by calling CreateMutualCertificateBindingElement.

    
    SecurityBindingElement sbe = SecurityBindingElement.CreateMutualCertificateBindingElement();
    
    
    
  3. Create a SupportingTokenParameters collection.

    
    SupportingTokenParameters supportParams = new SupportingTokenParameters();
    
    
    
  4. Add SAML tokens to the collection.

    
    // Two supporting SAML tokens are being added.
    supportParams.SignedEndorsing.Add(new IssuedSecurityTokenParameters("samlTokenType", issuerEndpointAddress1, issuerBinding1));
    supportParams.SignedEndorsing.Add(new IssuedSecurityTokenParameters("samlTokenType", issuerEndpointAddress2, issuerBinding2));
    
    
    
  5. Add the collection to the SecurityBindingElement.

    
    ((SymmetricSecurityBindingElement)sbe).OperationSupportingTokenParameters.Add("*", supportParams);
    
    
    
  6. Add binding elements to the binding element collection.

    
    bec.Add(sbe);
    bec.Add(new TextMessageEncodingBindingElement());
    bec.Add(new HttpTransportBindingElement());
    
    
    
  7. Return a new custom binding created from the binding element collection.

    
    // Create a CustomBinding and return it; otherwise, return null.
    return new CustomBinding(bec);
    
    
    

The following is the entire method described by the preceding procedure.


// This method creates a CustomBinding that includes two tokens of a given type.
public static Binding CreateCustomBinding(EndpointAddress issuerEndpointAddress1, Binding issuerBinding1, EndpointAddress issuerEndpointAddress2, Binding issuerBinding2)
{
    // Create an empty BindingElementCollection to populate, 
    // then create a custom binding from it.
    BindingElementCollection bec = new BindingElementCollection();

    SecurityBindingElement sbe = SecurityBindingElement.CreateMutualCertificateBindingElement();

    SupportingTokenParameters supportParams = new SupportingTokenParameters();

    // Two supporting SAML tokens are being added.
    supportParams.SignedEndorsing.Add(new IssuedSecurityTokenParameters("samlTokenType", issuerEndpointAddress1, issuerBinding1));
    supportParams.SignedEndorsing.Add(new IssuedSecurityTokenParameters("samlTokenType", issuerEndpointAddress2, issuerBinding2));

    ((SymmetricSecurityBindingElement)sbe).OperationSupportingTokenParameters.Add("*", supportParams);

    bec.Add(sbe);
    bec.Add(new TextMessageEncodingBindingElement());
    bec.Add(new HttpTransportBindingElement());

    // Create a CustomBinding and return it; otherwise, return null.
    return new CustomBinding(bec);
}


Show:
© 2014 Microsoft