# Single Sign On (SAML)

{% hint style="info" %}
**Note:** Starting from May 14, 2023, Aporia's SSO login url will be updated to \
[`https://platform.aporia.com?kc_idp_hint=`**`<ACCOUNT_NAME>`**](https://platform.aporia.com?kc_idp_hint=<ACCOUNT_NAME>)
{% endhint %}

You can easily give access to Aporia to your team using your favorite SAML Idp.

The integration status can be found on the "Integrations" page, accessible through the sidebar:

![All Integrations](/files/foKPx8DhxoLJ90eMhho4)

### Setting up the SAML integration

**STEP 1:** Contact your Aporia account representative to get your `{BASE URL}` and `{ALIAS}` info.

**STEP 2:** Login to your IdP and create a SAML app with the following configuration:

1. **Single Sign On URL / Application ACS URL** **-** should be in the following format `{BASE_URL}/keycloak/realms/aporia/broker/{ALIAS}/endpoint`
2. **Audience URI (SP Entity ID) -** should be in the following format `{BASE_URL}/keycloak/realms/aporia`
3. **Name ID format -** EmailAddress
4. **Application username -** Email
5. **Mapping (required for AWS) -** \
   User attribute in the application: Subject\
   Maps to this string value or user attribute in IAM Identity Center: ${user:email}\
   Format: emailAddress

**STEP 3:** Supply the IdP app metadata (file / url) to your Aporia account representative.

**Yay!** :tada: **You can now go and test your connection using the Idp-initiated login link.**


---

# 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.aporia.com/integrations/sso-saml-integration.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.