Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can configure the API Manager Identity Server instances to store access tokens in different tables according to their user store domain. This is referred to as user token partitioning and it ensures better security when there are multiple user stores configured in the system. For information on configuring user stores other than the default one, see Configuring Secondary User Stores.

To enable user token partitioning, you should change the <EnableAssertions> and <AccessTokenPartitioning> elements in <APIMthe <IS_HOME>/repository/conf/identity.xml file.

<EnableAssertions> 
Anchor
EnableAssertions
EnableAssertions

Assertions are used to embed parameters into tokens in order to generate a strong access token. You can also use these parameters later for various other processing functionality. At the moment, API Manager the Identity Server only supports UserName as an assertion.

By default, assertions are set to false in <APIMthe <IS_HOME>/repository/conf/identity.xml file.

Code Block
languagehtml/xml
<EnableAssertions>
        <UserName>false</UserName>
</EnableAssertions>

You can make it true by setting setting the <UserName> element to true. You can add a user name to an access token when generating the key, and verify it by Base64-decoding the retrieved access token.

...

This parameter implies whether you need to store the keys in different tables or not. It can be used only if <UserName> assertion is enabled. If it is, set the <EnableAccessTokenPartitioning> element to true in <APIM <IS_HOME>/repository/conf/identity.xml to store the keys in different tables.

...

  • if userId = foo.com/admin where 'foo.com' is the user store domain name, then a 'mapping:domain' combo can be defined as 'A:foo.com'.
  • 'A' is the mapping for the table that stores tokens relevant to users coming from 'foo.com' user store.

...

  • user

...

  • store

...

  • .

...

You can provide multiple mappings separated by commas as follows. Note that the domain names need to be specified in upper case.

...