# SAML SSO

SAML SSO lets your organization manage EasyDesk login through an identity provider. Use it when access should follow central security rules such as enforced MFA, employee lifecycle management, and centralized login auditing.

## Before You Start

You need:

* Administrator access in EasyDesk.
* Administrator access in your identity provider.
* The EasyDesk SAML configuration values.
* A test user who can safely validate login.

Do not switch every user to SSO until one administrator has tested the full login flow.

## Setup Flow

Go to **Settings -> Security -> SAML**.

1. Create an application for EasyDesk in your identity provider.
2. Copy the required SAML values between EasyDesk and the provider.
3. Configure allowed domains or user assignment in the provider.
4. Save the EasyDesk SAML settings.
5. Test login in a private browser session.

## Rollout

Roll out SSO in stages:

1. Test administrator login.
2. Test one agent login.
3. Confirm role and account access.
4. Notify the team.
5. Monitor audit logs after rollout.

## Recovery Planning

Keep at least one recovery path documented before enforcing SSO. If your identity provider is unavailable or misconfigured, your team needs a known way to regain administrator access.

## Troubleshooting

Most SAML issues come from incorrect entity IDs, ACS URLs, certificate values, user assignment, or email mismatch. Compare values exactly and test with a user who exists in both systems.


---

# 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://developers.easydesk.live/saml-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.