# SAML

## SAML Authorization for Spinnaker <a href="#saml-authorization-for-spinnaker" id="saml-authorization-for-spinnaker"></a>

### SAML Auth Overview <a href="#saml-auth-overview" id="saml-auth-overview"></a>

* SAML use case is a special one - it’s the only one where a user’s roles cannot be dynamically updated. This is because the user’s roles are sent in the initial authentication handshake between Gate and the SAML Identity Provider (IdP).

### Setup IdP on Spinnaker <a href="#setup-idp-on-spinnaker" id="setup-idp-on-spinnaker"></a>

* To enable SAML roles, configure IdP to include group membership in the assertion (not covered
* some providers may not offer this option). By default, Gate looks for the 'memberOf' attribute statement, but this can be reconfigured in Gate’s settings.
* When Fiat is enabled, SAML groups are automatically pushed to Fiat upon user login and cannot be updated until the user needs to reauthenticate.

### SAML Auth Configuration <a href="#saml-auth-configuration" id="saml-auth-configuration"></a>

* The Advantage of using SAML roles, is that the user roles are pushed to fiat automatically. Hence, no further configurational changes are required.


---

# 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://docs.opsmx.com/opsmx-1/opsmx-context-engine/additional-resources/previous-releases/isd-3.12/orchestration-module-opsmx-enterprise-for-spinnaker-oes/additional-feature-configuration/secure-spinnaker/authorization/user-role-providers/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.
