# Single Sign On

{% hint style="info" %}
Atfinity only officially supports SAML via Azure Active Directory. Other providers may work, but have not been tested.
{% endhint %}

Atfinity can use SAML-based Single Sign on interfaces to authenticate users. To set up Single Sign On, you need access to the Server itself, so this is only available for Enterprise customers or customers using Atfinity deployed on their own premises using our Kubernetes Helm Chart.

In general, you need a url to your **identification providers federation metadata** to get started

## Getting Started

If you are running Atfinity using **Docker Compose**, you need to set up these environment variables:

<table><thead><tr><th width="243.71010617981818"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td>SSO_ENABLED</td><td>Boolean</td><td></td></tr><tr><td>SSO_NAME</td><td>String</td><td>The name displayed to users when logging in, e.g. "MyBank Active Directory"</td></tr><tr><td>SSO_METADATA_URL</td><td>String</td><td>The url to your identification provers federation metadata. This should point to a hosted .xml file containing the service metadata. Usually, these urls end in "federationmetadata.xml"</td></tr></tbody></table>

If you are running Atfinity using our **Kubernetes Helm Chart**, you have to configure the same values, but provide them as extra Values in the helm chart. The values are called `sso.enabled`, `sso.name` and `sso.metadataUrl`.


---

# 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.atfinity.io/deploying/single-sign-on.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.