> For the complete documentation index, see [llms.txt](https://docs.meterian.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meterian.io/the-meterian-webapp/advanced-functionalities/sso-configuration/generic-saml-2.0.md).

# Generic SAML 2.0

In this page you can find guidance on how to set up the SAML 2.0 tab in the [SSO configuration](/the-meterian-webapp/advanced-functionalities/sso-configuration.md). Before you start, you need to have a SAML 2.0 identity provider (IdP) configured to issue assertions to Meterian. The values to enter in the form come from that identity provider.

### Fields

**Name** — a label that identifies this configuration inside Meterian. Only letters, numbers, hyphens and underscores are allowed, and it cannot be changed once saved.

**Metadata URL** — the URL where your identity provider publishes its SAML metadata document. Meterian uses it to discover the IdP's SSO endpoint and signing certificate. Most identity providers expose this URL from the application or connection you created for Meterian.

<figure><img src="/files/sgMBB9teovgx12jBGczL" alt=""><figcaption></figcaption></figure>

### Attribute mapping

After saving, an "Attribute Mapping" section appears below the login URL. **Attribute mapping is required for this SSO configuration to work** — until it is set, users authenticated through your identity provider cannot be matched to a Meterian account.

For each field, enter the name of the SAML attribute (or claim) your identity provider sends in the assertion.

**Email** — the attribute that carries the user's email address. This is the value Meterian uses to identify the user.

**Name** — the attribute that carries the user's display name.

**User ID** — the attribute used as the stable unique identifier for the user. If left blank, the email address is used as the user ID.

Click "Save mapping" to apply. If you change the mapping later, simply update the values and click "Save mapping" again.

<figure><img src="/files/30xu7AIxMm9hqigzVqZZ" alt=""><figcaption></figcaption></figure>

### After saving

Once both the configuration and the attribute mapping have been saved, the "Login URL" section can be shared with the users who should log in via SAML. They will be redirected to your identity provider to sign in, and then back into Meterian.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.meterian.io/the-meterian-webapp/advanced-functionalities/sso-configuration/generic-saml-2.0.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.