Single sign-on (SAML and OIDC)
Let people on your company's email domains log in to EUrouter through your own identity provider, such as Microsoft Entra ID, with SAML 2.0 or OpenID Connect.
Single sign-on (SSO) lets people with an email address on your company's domains log in to EUrouter through your own identity provider. EUrouter talks to your identity provider directly. No third-party sign-in service sits in between.
- SAML 2.0 works with identity providers that publish SAML metadata and sign with SHA-256 or stronger. This page shows the setup for Microsoft Entra ID.
- OpenID Connect (OIDC) works with Microsoft Entra ID.
Single sign-on is part of the Pro plan. Only the owner of a team organization can set it up. You find it under Settings → Single sign-on in your organization's dashboard.
How log-in works
- Someone enters their work email on the log-in page.
- When the email's domain belongs to a verified connection, the page shows Continue with single sign-on and sends them to your identity provider.
- After they sign in there, they return to EUrouter. If they have two-factor authentication on their EUrouter account, EUrouter still asks for their code.
Single sign-on does not yet replace passwords. Use password instead stays available, and existing passwords and sessions keep working.
Someone who signs in for the first time gets an EUrouter account with a verified email. They join your organization when you invite them, as with any other member. An existing account with the same email is linked to single sign-on when its email is verified.
Sign-in always starts on the EUrouter log-in page. Starting from your identity provider's app list, such as Microsoft My Apps, is not supported, because EUrouter only accepts a response to a sign-in it started in the same browser.
When your organization leaves the Pro plan
Single sign-on keeps working until the end of the period you paid for. After that:
- The log-in page no longer sends people on your domains to your identity provider. They log in with their email and password. Someone who never set a password can set one with Forgot password? on the log-in page.
- Your connections stay in Settings → Single sign-on. You can remove them, but you cannot add or verify one.
- When you return to the Pro plan, single sign-on works again with the connections you kept.
Set up SAML with Microsoft Entra ID
- In the Microsoft Entra admin center, open Enterprise applications → New application → Create your own application. Name it "EUrouter" and choose Integrate any other application you don't find in the gallery.
- Open Single sign-on, choose SAML and download the Federation Metadata XML from the SAML Certificates section.
- In EUrouter, open Settings → Single sign-on → Add connection, choose SAML 2.0, enter your email domains, upload the metadata file and select Connect.
- EUrouter shows an Identifier (Entity ID) and a Reply URL. Back in Entra ID, edit Basic SAML Configuration and paste both values.
- Under Users and groups, assign the people or groups who may sign in to EUrouter.
EUrouter reads the email address from the emailaddress claim, or from the user's name identifier if that claim is missing. The signing certificate must use SHA-256 or stronger, which is Entra ID's default. EUrouter shows when the certificate expires. Before it does, remove the connection and add it again with the new metadata. The new connection has a new Identifier, Reply URL and TXT record: update both in Entra ID and at your DNS provider, then verify the domain again. Single sign-on for those domains is off until the new domain verification succeeds, so plan the change for a quiet moment.
EUrouter accepts a SAML response of up to 64 KiB in the base64 form your identity provider posts, about 48 KiB of XML, and up to 250 XML elements, so if you add a groups claim in Entra ID, choose Groups assigned to the application to send only the groups assigned to EUrouter.
Set up OIDC with Microsoft Entra ID
- In the Microsoft Entra admin center, open App registrations → New registration. Name it "EUrouter" and choose Accounts in this organizational directory only.
- Under Certificates & secrets, create a client secret and copy its Value.
- In EUrouter, open Settings → Single sign-on → Add connection, choose Entra ID (OIDC), enter your email domains, the issuer URL
https://login.microsoftonline.com/<tenant ID>/v2.0, the Application (client) ID and the secret, then select Connect. - EUrouter shows a Redirect URI. In Entra ID, open Authentication → Add a platform → Web and paste it.
- Make sure each person who signs in has an Email address on one of your domains in Entra ID.
Use your own tenant's issuer. Multi-tenant issuers such as common or organizations are refused, because they would let other tenants sign in with your domains. EUrouter stores the client secret encrypted and never shows it again.
Verify your domains
EUrouter only sends people to your identity provider after you prove that your organization owns the email domains.
- After you add a connection, EUrouter shows one TXT record per domain: a name such as
_eurouter-sso-<connection id>.example.comand a value. - Add each record at your DNS provider.
- Select Verify domain. DNS changes can take up to an hour to be visible.
A domain can belong to only one verified connection. Subdomains are included: verifying example.com also covers eu.example.com.
When single sign-on fails
The log-in page explains why a sign-in was refused:
| Message | What to do |
|---|---|
| Your identity provider can only sign in email addresses on verified domains | The person's email in your identity provider is on a domain this connection doesn't cover. |
| The attempt was not started in this browser | Start again from the EUrouter log-in page, not from your identity provider's app list. |
| Your identity provider signs with an algorithm EUrouter does not accept | Switch the signing algorithm to SHA-256 in your identity provider. |
| Your identity provider's response was too large for EUrouter | Limit the groups claim to the groups assigned to the application. |
| Too many sign-ins from your network right now | Wait a minute and try again. |
| An EUrouter account with this email already exists and could not be linked | Log in with the password, verify the email address, then try single sign-on again. |
To stop using single sign-on, remove the connection under Settings → Single sign-on. People with a password log in with it again. People who only ever used single sign-on set a password with Forgot password? on the log-in page.