> ## Documentation Index
> Fetch the complete documentation index at: https://docs.watchdog.no/llms.txt
> Use this file to discover all available pages before exploring further.

# Single sign-on (SSO)

> Let people sign in to Watchdog with their company account.

With single sign-on, everyone with an email address at your company domain signs in through your identity provider, such as Microsoft Entra ID. Your IT team decides who has access, and nobody needs an invitation.

## Set up SSO

1. Email [support@watchdog.no](mailto:support@watchdog.no) with your email domains and identity provider.
2. We reply with the values your IT team needs.
3. Your IT team follows the steps below and sends us the metadata link.
4. We turn on SSO. From then on, people at your domain sign in with their company account, without an invitation.

## Steps for Microsoft Entra ID

Using another provider? We include its steps in our reply.

1. In the [Microsoft Entra admin center](https://entra.microsoft.com/), go to **Enterprise applications → New application → Create your own application**. Name it `Watchdog` and choose **Non-gallery**.
2. Open **Single sign-on → SAML**. Under **Basic SAML Configuration**, enter the **Identifier (Entity ID)** and **Reply URL** we sent, and save.
3. Under **Attributes & Claims**, keep the defaults. **emailaddress** must hold the address people use in Watchdog. It uses `user.mail`; if that is empty or a different address, change it to `user.userprincipalname`.
4. Under **Users and groups**, add the people or groups who should have access.
5. Under **SAML Certificates**, copy the **App Federation Metadata Url** and send it to us.

The values we send start with `https://clerk.watchdog.no/` and are not secret.

## Good to know

* Existing users keep their account and data if their email address stays the same.
* New users join as members the first time they sign in.
* To remove someone, remove them in Entra and under **Settings → Members**.
* Let us know when you renew the SAML certificate.

## Troubleshooting

| Problem | Fix |
| - | - |
| Microsoft error AADSTS50105 | The user isn't added to the app. Add them under **Users and groups**. |
| The user gets a new account in Watchdog | Their email address in Entra differs from Watchdog. See step 3. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.