# SAML

This section includes a general guide for configuring a SAML provider and guides for specific SAML providers in Immuta. The getting started section below provides best practices for setup and configuration.

## Getting started with SAML

1. **Start by creating a few initial** [**subscription**](https://documentation.immuta.com/latest/governance/author-policies-for-data-access-control/authoring-policies-in-secure/section-contents) **and** [**data policies**](https://documentation.immuta.com/latest/governance/author-policies-for-data-access-control/authoring-policies-in-secure/data-policies) **so that you know the user metadata you will need from your IAM.** For example, will user attributes be used to author policies, or will groups also be needed? The subscription and data policies below illustrate the need for both groups and attributes to be imported from the IAM to enforce appropriate access controls:
   1. **Subscription policy**: Allow all users in the `Marketing` group to access data sources tagged `Marketing`.
   2. **Data policy**: Mask all columns tagged `Location` except for users with the attribute `AccessLevel.Gold`.
2. [**Validate that your provider is supported by Immuta and supports SCIM.**](https://documentation.immuta.com/latest/releases/support-matrix#iam-providers) If your provider is not listed or does not support SCIM, reach out to your Immuta representative for guidance.
3. [**Configure your SAML provider in Immuta**](https://documentation.immuta.com/latest/configuration/people/section-contents/how-to-guides/saml/enable-saml) **with SCIM enabled.** Guides for specific providers are linked below.
   1. [Microsoft Entra ID](https://documentation.immuta.com/latest/configuration/people/section-contents/how-to-guides/saml/microsoft-entra-id)
   2. [Okta SAML SCIM](https://documentation.immuta.com/latest/configuration/people/section-contents/how-to-guides/saml/okta-saml-scim)

## Next steps <a href="#what-next" id="what-next"></a>

Once your IAM is configured, complete one of the following tasks:

* [Register data in Immuta](https://documentation.immuta.com/latest/configuration/integrations/registering-metadata)
* [Author policies](https://documentation.immuta.com/latest/governance/author-policies-for-data-access-control/authoring-policies-in-secure)


---

# Agent Instructions: 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://documentation.immuta.com/latest/configuration/people/section-contents/how-to-guides/saml.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.