This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Editing Claim Dialects

There are two ways to edit claim dialects in WSO2 Identity Server.

Using the management console

You can edit existing claim dialects by clicking on any available dialect link. Follow the instructions below to edit a claim dialect.

  1. Sign in. Enter your username and password to log on to the Management Console.
  2. Click Main to access the Main menu and click List under Claims.
  3. Click on any available dialect links.
  4. From the Claim Dialect view, you can view the claims defined for that particular dialect. If you need to edit a claim, click on the appropriate Edit link.
  5. Enter the new claim information in the required fields and click on the Update button.

    AttributeDescriptionSample value
    Display NameThe name of the claim value which is display to the user.Eg: Street Address
    DesciptionA small description of the claim to help the user to understand it easily.Eg. Address of the street
    Claim UriThe URI which defines the claimEg. http://schemas.xmlsoap.org/ws/2005/05//identity/claims/streetaddress
    Mapped AttributeThe attribute which mapped to the claimEg. streetAddress
    Regular ExpressionRegex which helps to verify the inputEg: A street address can be an integer or a string, therefore regex can be like "^\d{1,45}$ "
    Display OrderOrder to display claimsEg. 1
    Supported by DefaultWhether the claim is displayed in the profile of the userEnabled or disabled
    RequiredWhether the claim is mandatory.Enabled or disabled
    Read-onlyWhether the claim cannot be updated later. (Read only)Enabled or disabled

    Note

    When you are using more than one user store, you must map the attributes correctly using claim management. Under “Mapped Attribute(s)” you need to follow the pattern.

    {domain_name/attribute_Name};{domain_name/attribute_Name}; {domain_name/attribute_Name};

    However, for the default user store, you do not need to provide the domain name. As an example, if you have two user stores, one is the default and another one with domain “LDAP” then the pattern would be as follows for “http://wso2.org/claims/emailaddress".

    email;LDAP/mail

Using the configuration file

Alternatively, instead of editing the dialect using the management console, you can also edit the claim dialect by editing the claim-config.xml configuration file located in the <IS_HOME>/repository/conf folder. A sample claim dialect is given below.

<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>

Edits to the claim dialects configured in <IS_HOME>/repository/conf/claim-config.xml file get applied only when you start the product for the first time, or for any newly created tenants. With the first startup, claim dialects and claims will be loaded from the file and persisted in the database. Any consecutive updates to the file will not be picked up and claim dialects and claims will be loaded from the database.