Aligned

Plan: this feature is only accessible in the Enterprise Plan

This guide should assist you in setting up and configuring Microsoft Entra ID login for Aligned. If you encounter any issues or require further assistance, please reach out to Aligned support for help.

Step 1: Adding a New SAML Connection

Sign into the Entra (Azure AD) admin dashboard at <a href="https://entra.microsoft.com/" rel="nofollow noopener noreferrer" target="_blank">entra.microsoft.com</a>.

Navigate to Applications → Enterprise applications.

Click on New Application, then select Create your own application.

Provide a name for the app and select Integrate any other application you don’t find in the gallery (Non-gallery), then click Create.

Proceed to Manage → Properties.

Go to Manage → Users and groups to assign relevant users access to this application.

Access Manage → Single sign-on and select SAML.

- Identifier: <code>urn:auth0:alignedup:REPLACE_ME</code>
- Reply URL (Assertion Consumer Service URL): <code>https://auth.teamaligned.com/login/callback</code>

- Setup required claims for the integration:
 - <code>user.mail</code> → <code>email</code>
 - <code>user.surname</code> → <code>family_name</code>
 - <code>user.givenname</code> → <code>given_name</code>

1. Sign into the Entra (Azure AD) admin dashboard at <a href="https://entra.microsoft.com/" rel="nofollow noopener noreferrer" target="_blank">entra.microsoft.com</a>.
2. Navigate to Applications → Enterprise applications.
3. Click on New Application, then select Create your own application.
4. Provide a name for the app and select Integrate any other application you don’t find in the gallery (Non-gallery), then click Create.
5. Proceed to Manage → Properties.
6. Upload the Aligned logo as needed.
7. Go to Manage → Users and groups to assign relevant users access to this application.
8. Access Manage → Single sign-on and select SAML.
9. Edit Step 1:
 - Identifier: <code>urn:auth0:alignedup:REPLACE_ME</code>
 - Reply URL (Assertion Consumer Service URL): <code>https://auth.teamaligned.com/login/callback</code>
10. Edit Step 2:
 - Setup required claims for the integration:
 - <code>user.mail</code> → <code>email</code>
 - <code>user.surname</code> → <code>family_name</code>
 - <code>user.givenname</code> → <code>given_name</code>

Step 2: Configuring Microsoft Entra (Client)

Make sure you have created an app for the Microsoft Entra following the previous steps outlined.

Go to Certificates &amp; secrets → Client secrets.

Click on New client secret and copy the value of the secret.

Return to the Overview tab and copy the following:

Send the following details back to Aligned support:

- Secret value
- Tenant ID
- Application (client) ID

1. Sign into the Entra (Azure AD) admin dashboard at <a href="https://entra.microsoft.com/" rel="nofollow noopener noreferrer" target="_blank">entra.microsoft.com</a>.
2. Make sure you have created an app for the Microsoft Entra following the previous steps outlined.
3. Navigate to App Registrations.
4. Select the created Azure AD app.
5. Go to Certificates &amp; secrets → Client secrets.
6. Click on New client secret and copy the value of the secret.
7. Return to the Overview tab and copy the following:
 - Tenant ID
 - Application (client) ID
8. Send the following details back to Aligned support:
 - Secret value
 - Tenant ID
 - Application (client) ID