# SSO

## Getting Here <a href="#getting-here" id="getting-here"></a>

**Settings > User Management > SSO**

## User Management - SSO Page <a href="#user-management---sso-page" id="user-management---sso-page"></a>

The **SSO Page** allows administrators to configure Single Sign-On (SSO) using SAML.

Additional password configuration options are on the [Password & Security](/settings/user-management/password-security.md) page.

### Identity Provider Configuration <a href="#identity-provider-configuration" id="identity-provider-configuration"></a>

Netography Fusion supports single sign-on (SSO) to any SAML 2.0 identity provider.

There are many identity providers on the market, and nearly all of them differ in how they configure SAML SSO integrations. Some example walkthroughs are available below, but consult your identity provider documentation for the most up-to-date information.

| Identity Provider         | Configuration Docs                                                                                |
| ------------------------- | ------------------------------------------------------------------------------------------------- |
| Auth0                     | [Configuring SSO with Auth0](/settings/user-management/index-2/configuring-sso-with-auth0.md)     |
| GSuite (Google Workspace) | [Configuring SSO with GSuite](/settings/user-management/index-2/configuring-sso-with-gsuite.md)   |
| Okta                      | [Configuring SSO with Okta](/settings/user-management/index-2/configuring-sso-with-okta.md)       |
| PingOne                   | [Configuring SSO with PingOne](/settings/user-management/index-2/configuring-sso-with-pingone.md) |

#### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

The following conditions must be met to successfully configure SSO with Netography:

* **Identity Provider Metadata File -** You must have an existing identity provider service that supports SAML 2.0 and provides an *Identity Provider Metadata File*. This file is required to be uploaded to Netography as part of the SSO/SAML integration.
* **Netography Administrator account -** When your original Netography account was created, an initial administrator user was also created. You may have also created additional users in this account. You are required to maintain at least 1 admin level user in the Netography account, which can be used as a fail-safe in case the SSO integration fails. This administrator access is required to configure/edit the SSO settings. The login for these users will remain the default Netography login page, whereas once SSO is configured, you will receive a custom login URL for your SSO-based users.

{% hint style="info" %}
**Disable Multi-Factor Authentication if enabling SSO.**

See: [Multi-Factor Authentication (MFA/2FA)](https://docs.netography.com/settings/user-management/password-security?q=mfa#multi-factor-authentication-mfa).
{% endhint %}

### Page Settings <a href="#page-settings" id="page-settings"></a>

#### **Single Sign-On (SSO)** <a href="#single-sign-on-sso" id="single-sign-on-sso"></a>

* **SAML Single Sign-On**
  * **Description**: Enables users to authenticate using the same identity provider (SAML) for internal and external services.
  * **Status**: `ENABLED` when SSO is active.
  * **Behavior**: Simplifies login for users by utilizing a centralized authentication service.


---

# 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.fusion.vectra.ai/settings/user-management/index-2.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.
