Adding Claim Dialects

In WSO2 Identity Server, there are two main ways of adding a claim dialect. They are,

Using the management console

Follow the instructions below to add a new claim dialect.

Sign in. Enter your username and password to log on to the Management Console.
From the Main menu, click Add under Claims.
Click Add Claim Dialect. Enter the Dialect URI.

The Dialect URI is a unique URI identifying the dialect (for example, http://schema.openid.net/2007/05/claims).
Click on the Add button. The claim dialect you added will appear on the list as follows.

Using the configuration file

Follow the instructions below to add a new claim dialect through the configuration file. Note that you can only do this before the first start up of the WSO2 Identity Server instance.

Open the claim-config.xml file found in the <IS_HOME>/repository/conf/ folder.

To add a new claim dialect, add the following configuration to the file along with the new claims you want to add under the dialect. For this example, the new claim dialect is named SampleAppClaims.

<Dialect dialectURI="http://wso2.org/SampleAppClaims">
    <Claim>
        <ClaimURI>http://wso2.org/SampleAppClaims/givenname</ClaimURI>
        <DisplayName>First Name</DisplayName>
        <MappedLocalClaim>http://wso2.org/claims/givenname</MappedLocalClaim>
    </Claim>
    <Claim>
        <ClaimURI>http://wso2.org/SampleAppClaims/nickName</ClaimURI>
        <DisplayName>Nick Name</DisplayName>
        <MappedLocalClaim>http://wso2.org/claims/nickname</MappedLocalClaim>
    </Claim>
</Dialect>

Once you have edited the claim-config.xml file, start WSO2 Identity Server. The configurations will be applied and you can view the new claim dialect via the management console.

Related Links

For information on how to add an external claim to this claim dialect, or add a local claim to the wso2 local claim dialect, see Adding Claim Mapping.