Before you start in Entra
Where a step differs between the two ways Connectly hands over the values, it says Setup link or Manual. With a setup link, keep the wizard open next to Entra: its Single Sign-On part belongs to Step 1 and its Provisioning part to Step 3.
1
Create the Entra application and set up sign-in
- In the Microsoft Entra admin center (or the Azure portal), open Enterprise applications and click New application.
- Click Create your own application, name it (for example
Connectly), choose Integrate any other application you don’t find in the gallery (Non-gallery) and click Create. - Open Single sign-on and choose SAML.
- In Basic SAML Configuration, click Edit and enter the Identifier (Entity ID), Reply URL and Sign on URL. Leave Relay State and Logout URL empty, then Save.
- In Attributes & Claims, keep Unique User Identifier (Name ID) as
user.userprincipalname. Theemailaddressclaim defaults touser.mail: keep it if every person has an Email in Entra, otherwise change its source attribute touser.userprincipalname. - In SAML Certificates, give Connectly your application’s metadata (below).
- In Properties, set Assignment required to Yes, so only people you assign can sign in. With Visible to users set to Yes, people also get a Connectly tile in My Apps that opens the Sign on URL.
- Setup link
- Manual
- The Identifier is the wizard’s Service Provider Entity ID and the Reply URL is its Single Sign-On URL, both on the wizard’s Create Application page. The Sign on URL comes from Connectly.
- Copy Entra’s App Federation Metadata Url into Metadata URL on the wizard’s Configure Connection page, Automatic tab. Leave Advanced Settings as they are, click Create Connection and confirm with Proceed.
- Keep Attribute Mapping as it is. On Test SSO you can click Enable Connection, then Proceed, without testing: Step 4 tests the sign-in end to end.
2
Assign people and confirm your domain
- In the application, open Users and groups, click Add user/group, select the people who will use Connectly and click Assign. Only assigned people can sign in, and only assigned people are provisioned.
- If you prove your domain by DNS, publish the TXT record Connectly sent you at your DNS provider and tell Connectly when it is live. Connectly looks it up itself; nothing needs to be uploaded.
- Connectly verifies the domain and links your connection to your Connectly business. You hear back when sign-in is switched on.
3
Set up provisioning (SCIM)
Skip this step if you do not use SCIM; see SSO without SCIM.
- In the application, open Provisioning. In the classic view, click Get started and set Provisioning Mode to Automatic; in the new view, open Connectivity.
- Under Admin Credentials, choose Bearer authentication. Paste the SCIM endpoint into Tenant URL and add
?aadOptscim062020at its end, which turns on Microsoft’s SCIM 2.0 compliance fixes. Paste the SCIM token into Secret Token. Click Test Connection, wait for Entra to confirm the credentials are authorized, then Save. - Open Attribute mapping (classic view: Provision Microsoft Entra ID Users; new view: the Users tab) and check the mappings against the table below. If you assign groups, turn off provisioning of the groups themselves (classic view: Provision Microsoft Entra ID Groups, Enabled No). Their members are still provisioned.
- Under Settings, set Scope to Sync only assigned users and groups.
- Do not start provisioning yet. Test with one person first (Step 4).
- Setup link
- Manual
The endpoint and the token are on the wizard’s Provisioning page. The SCIM endpoint is its Provisioning Endpoint URL without the final slash. Generate Token shows the token once: click Copy And Close and paste it into Entra right away. The attributes the wizard lists are already in Entra’s default mapping. When Entra has saved the credentials, click Done on that page.
4
Test with one person, then turn provisioning on
- In Provisioning, open Provision on demand, pick one assigned person and click Provision. Entra should report that the user was created, and list the values it sent.
- Tell Connectly. We confirm the person is in your Connectly business with the agreed role.
- That person opens the Sign on URL in a private browser window and signs in with their Microsoft account. They land in your Connectly business. A first Microsoft sign-in may ask them to change a temporary password or register MFA.
- When the test works, open the provisioning Overview and click Start provisioning. Entra provisions everyone assigned, then repeats on its own schedule (Microsoft runs an incremental cycle roughly every 40 minutes). Provision on demand stays available for anyone who cannot wait.
