> ## Documentation Index
> Fetch the complete documentation index at: https://anaconda.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Updating your SAML username attribute in Keycloak

This process requires a Security Assertion Markup Language (SAML) proxy to be previously set up. For more information about setting up a SAML proxy, see [Configuring a proxy for outgoing Keycloak HTTP requests](https://anaconda.com/docs/psm-on-prem/6.8.0/admin/advanced/saml_proxy.md).

When using SAML, you can update which attribute Keycloak pulls and displays for your users' names in Package Security Manager. To do so, follow these steps:

1. [Log in to the Keycloak administrative console](https://anaconda.com/docs/psm-on-prem/6.8.0/admin/user_config/user_roles.md#accessing-the-keycloak-administrative-console).

2. Select **Identity providers** from the left-hand navigation menu.

3. Select your SAML identity provider from the list.

4. Click the **Mappers** tab.

5. Click **Create**.

   ![](https://mintcdn.com/anaconda-29683c67/4YgHE0z28xHZ8yr8/images/psm-on-prem/keycloak_saml_mapper_create.png?fit=max\&auto=format\&n=4YgHE0z28xHZ8yr8\&q=85\&s=43eb7d07086a6aa5a01a17114120799a)

6. Enter a name for your mapper.

7. Open the **Synch Mode Override** dropdown and select **inherit**.

8. Open the **Mapper Type** dropdown and select **Username Template Importer**.

9. Enter the template to use to format the imported usernames. Hover your mouse over the  question mark icon beside the **Template** field for an example.

10. Click **Save**.

    ![](https://mintcdn.com/anaconda-29683c67/4YgHE0z28xHZ8yr8/images/psm-on-prem/keycloak_saml_username_id_mapper.png?fit=max\&auto=format\&n=4YgHE0z28xHZ8yr8\&q=85\&s=d24bfc7dc803e8dcd986bfa48fb25f37)