Purpose
This guide explains how to let users from Microsoft Entra ID (formerly Azure AD) log in to Logsign USO with their Microsoft account. You register an application in Entra ID, give Logsign its Client ID, Tenant ID and Client Secret, sync the Entra ID users into Logsign and assign them a role. From then on, those users are sent to the Microsoft sign-in page when they log in, and their password never reaches Logsign.
The same Entra ID integration in Logsign is also used for identity and device sync and as a Response integration. This guide covers the login part; the credentials are shared.
If your users live in on-premises Active Directory instead, see LDAP Configuration and LDAP Users Login. For Google Workspace, see Google Workspace SSO Login Configuration.
How the Login Works
- The user opens Logsign, types their username and clicks Next.
- Logsign sees that the user was synced from Entra ID and redirects the browser to the Microsoft sign-in page of your tenant.
- The user signs in to Microsoft, including any Conditional Access or MFA your tenant enforces.
- Microsoft redirects the browser back to
https://<logsign-address>/loginwith an authorization code, and Logsign exchanges it for tokens directly with Microsoft. - Logsign takes the
preferred_usernamefrom the ID token (normally the UPN, such asjane.doe@contoso.com), uses the part before@, and matches it to a Logsign user synced from the same Entra ID integration. If Logsign two-factor authentication is enabled for that user, the 2FA step follows. The dashboard then opens.
The round trip must complete within 2 minutes of step 2. If it takes longer, the login fails and the user must start again from the username step.
Prerequisites
| Item | Requirement |
|---|---|
| Entra ID role | An account that can register applications and grant admin consent (Application Administrator or Cloud Application Administrator is enough; Global Administrator is not required). |
| Network from Logsign | Every Logsign node must reach login.microsoftonline.com and graph.microsoft.com on TCP 443. |
| Network from users | Users' browsers must reach login.microsoftonline.com. |
| Logsign address | The Logsign URI under Settings > System > Dns Settings must be the address users actually open in the browser. Behind a load balancer, use the load balancer address. This value is used to build the redirect URI. |
| Usernames | The part of each user's UPN before @ becomes their Logsign username. Two Entra ID users whose UPNs differ only after @ (for example on two verified domains) cannot both log in, because they map to the same Logsign username. |
Step 1: Register an Application in Microsoft Entra ID
- Sign in to the Microsoft Entra admin center and go to Identity > Applications > App registrations.
- Click New registration. Enter a name such as
Logsign USOand choose Accounts in this organizational directory only. - Under Redirect URI, choose platform Web and enter
https://<logsign-address>/login. Click Register. - On the Overview page, copy the Application (client) ID and the Directory (tenant) ID.
Important: the redirect URI must match exactly, including https:// and the /login path, and it must be registered under the Web platform, not Single-page application. Correct: https://siem.contoso.com/login. Wrong: https://siem.contoso.com. A mismatch makes Microsoft stop the login with error AADSTS50011.
Create a client secret
- Open Certificates & secrets and click New client secret.
- Enter a description, choose an expiry and click Add.
- Copy the secret Value (not the Secret ID) immediately. It is shown only once.
Note the expiry date. When the secret expires, Entra ID logins to Logsign and the identity sync stop until you create a new secret and enter it in Logsign.
Grant API permissions
Open API permissions, click Add a permission, choose Microsoft Graph and add the following, then click Grant admin consent:
| Permission | Type | Used for |
|---|---|---|
| User.Read | Delegated | Signing the user in to Logsign. |
| Directory.Read.All | Application | Syncing users and devices into Logsign Identities and Assets. |
| Directory.Read.All, Directory.AccessAsUser.All | Delegated | Requested by the existing setup for the Response integration. Not needed for login alone. |
Step 2: Configure Microsoft Entra ID in Logsign USO
- Go to Settings > Integrations > Responses, search for Microsoft Entra ID, click Configure and click +Device.
- Fill in the fields below and save.
| Field | Required | Description |
|---|---|---|
| Tenant ID | Yes | The Directory (tenant) ID from Step 1. |
| Client ID | Yes | The Application (client) ID from Step 1. |
| Client Secret | Yes | The client secret Value from Step 1. Stored encrypted by Logsign. |
| Sync Interval | No | How often identities are synced automatically: 1, 2, 4, 6 or 12 hours. Left empty or set to 24, the sync runs once a day at 02:00. |
Step 3: Add the Users to Logsign
SSO only logs in users who already exist in Logsign. It never creates users.
-
Go to Settings > Enrichment > Identities, click Sync Ldap, select the Microsoft Entra ID integration and sync.
- Select the users who should have access and click Apply Role Selected.
- In the Add Logsign User window choose the role and save.
Manual sync always works regardless of the Sync Interval, and a failure in one source does not stop the others from syncing. The added users can now log in as described in How the Login Works.
Behavior to Be Aware Of
- A user synced from Entra ID cannot log in to Logsign with a password. Logsign always redirects them to Microsoft.
- Entra ID Conditional Access and Microsoft MFA apply at the Microsoft sign-in step. Logsign two-factor authentication, if enabled for the user, applies in addition.
- Disabling a user in Entra ID stops their next Microsoft sign-in. Disabling the user in Logsign also blocks them regardless of Entra ID.
Troubleshooting
| Symptom | Likely cause | What to check |
|---|---|---|
Microsoft shows AADSTS50011 (redirect URI mismatch) |
The redirect URI in the app registration does not equal https://<logsign-address>/login, or it is registered under the wrong platform. |
The Web platform redirect URI and the Logsign URI under Settings > System > Dns Settings. |
Microsoft shows AADSTS700016 or AADSTS90002
|
The Client ID or Tenant ID entered in Logsign is wrong. | Copy both values again from the Overview page. |
Microsoft shows AADSTS65001 (consent required) |
Admin consent was not granted. | Click Grant admin consent on the API permissions page. |
| "Authentication Failed" after returning from Microsoft | The client secret is wrong or expired, the login took longer than 2 minutes, or the username before @ does not match a Logsign user synced from this integration. |
Secret expiry in Entra ID, and that the user was added in Step 3. Start again from the username step. |
| Identity sync returns no users | Directory.Read.All (Application) is missing or not consented, or the secret is invalid. | API permissions and admin consent status. |
For every failed login Logsign records the exact reason in its API service log. If the table above does not explain the problem, contact Logsign Support with the time of the failed attempt and the username.