Defining User Identification for SAML 1.1

Selecting a User Identification Method for SAML 1.1

Two methods exist for identifying users from an identity provider when using the SAML 1.1 protocol. You can specify that no account matching needs to occur, or you can configure a match method. You configure a match method when you want to use attributes from the identity provider to uniquely identify a user on the service provider.

  1. Click Devices > Identity Servers > Edit > SAML 1.1 > [Identity Provider] > User Identification.

  2. In Satisfies contract, specify the contract that can be used to satisfy the assertion received from the identity provider. Because SAML 1.1 does not use contracts and Identity Server is contract-based, this setting permits making an association between a contract and a SAML 1.1 assertion.

    Use caution when assigning a contract to associate with an assertion, because it is possible to imply that authentication has occurred, when it has not. For example, if a contract is assigned to an assertion, and the contract has two authentication methods (such as one for name/password and another for X.509), the server sending the assertion might use only name/password. But, the service provider might assume that X.509 took place and then incorrectly assert it to another server.

  3. Select one of the following options for user identification:

    • Do nothing: Specifies that an identity provider account is not matched with a service provider account. This option allows the user to authenticate the session without identifying a user account on the service provider.

    • Attribute matching: Authenticates a user by matching a user account on the identity provider with an account on the service provider. This option requires that you set up the match method.

      • Prompt for password on successful match: Specifies whether to prompt a user for the password when the user is matched to an account to ensure that the account matches.

  4. Select one of the following:

  5. You can also configure the assertion time manually.

    • Assertion Validity Window: You can manually set the assertion validity time for SAML Service Provider (SP) to accommodate clock skew between Service Provider and SAML Identity (IDP) Server.

  6. Click OK > OK > Apply.

  7. Update Identity Server.

Configuring the Attribute Matching Method for SAML 1.1

A user matching expression is a set of logic groups with attributes that uniquely identify a user. User matching expressions enable you to map Liberty attributes to the correct LDAP attributes during searches. You must know the LDAP attributes to identify unique users in the user store.

To use user matching, the Personal Profile must be enabled. It is enabled by default. If you have disabled it, you need to enable it. See Managing Web Services and Profiles.

  1. Click Devices > Identity Servers > Servers > Edit > SAML 1.1 > [Identity Provider] > User Identification.

  2. To configure the match method, click Attribute Matching settings.

  3. Select and arrange the user stores you want to use.

    Order is important. The user store at the top of the list is searched first. If a match is found, the other user stores are not searched.

  4. Select a matching expression, or click New to create a look-up expression. For information about creating a look-up expression, see Configuring User Matching Expressions.

  5. Click OK.

  6. Update Identity Server.