# Single Sign-On (SSO)

## How to Login to DecisionRules using Single Sign-On (SSO) <a href="#how-do-i-sign-into-contentful-with-my-corporate-credentials" id="how-do-i-sign-into-contentful-with-my-corporate-credentials"></a>

If your organization has the single sign-on (SSO) option enabled, on the Login page click on the “SSO” link at the bottom.

![How to login to DecisionRules using Single Sign-On (SSO)](/files/zVJ3fhWrci1o1w3gDVbg)

Next, provide your email address with the SSO of your organization.

![DecisionRules Single Sign-On (SSO) Login Form](/files/9v7KOv0RO4RpnVIHYOWk)

Enter your corporate email. You will be redirected to your provider's webpage to enter your credentials - **Username** and **Password**. After you have successfully entered them and logged in, will be redirected back to DecisionRules on your **Dashboard**.

{% hint style="info" %}
If you already have an account with corporate email, and the provider is in our database, there will be no change for you.
{% endhint %}

### Is the single sign-on feature available for all customers? <a href="#is-the-single-sign-on-feature-available-for-all-customers" id="is-the-single-sign-on-feature-available-for-all-customers"></a>

The single sign-on feature (SSO) is available for **on-premise**, **private cloud** and **public cloud** (large and higher) also for the current plans. To enable SSO for your organization, go to [organization settings](/doc/v1/organizations/structure/settings.md).

### What Identity Providers (IdP) does DecisionRules support?

DecisionRules SSO works with all Identity Providers that support the SAML 2.0 protocol.

* Microsoft Azure AD
* Okta
* OneLogin
* Ping Identity

### How do I set up a single sign-on access for my organization?

{% hint style="info" %}
The users can not set up the SSO by themselves, we need to add the underlying information into the database to make the SSO work.

For on-premise, you can refer to the [guide](/doc/v1/on-premise-docker/setting-up-sso.md).
{% endhint %}

| Variable                    | Description                                                                                                                                     |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **domain/ SSO name**        | domain in the email address - has to be unique                                                                                                  |
| **entryPoint**              | identity provider entry point                                                                                                                   |
| **issuer**                  | issuer string to supply to IdP                                                                                                                  |
| **callBackUrl / Reply URL** | It is the URL that which provider call with the callback. Need to be set up on the provider. Something like: api.decisionrules.io/saml/callback |
| **cert**                    | certificate                                                                                                                                     |

{% hint style="info" %}
For more information contact us at <mark style="color:green;">**<sales@decisionrules.io>**</mark>
{% endhint %}


---

# 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.decisionrules.io/doc/v1/other/single-sign-on-sso.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.