Adding a user through SSO
Open the customer account you wish to integrate with SSO.
Locate "SSO +"
In the modal opened, click on "Add new" button to add domain details (If SSO is not already added you'll be able access all fields directly)
Register a new app on your Azure portal . Copy fields such as Client ID, Issuer URL, Secret Key Value from new registered application and update them in respective fields.
Copy Redirect URLs from SSO modal and paste them over Azure portal to enable SSO for IT-Connect. ( NB: Refer the Adding Redirect URL section below for more details)
Add domain name and save the same.
Start Registering new app on Azure Entra portal
The following are the steps to find your application's Client ID.
Step 1: Open the Azure portal: https://portal.azure.com
Step 2: On the opened screen, select "App registrations" from the Azure services.
Step 3: Click on the option "New registration" from the Menu at the top left corner of the screen. On the screen that appears, enter the name you wish to display in the "Name" field. For example, the user can use "DeskDay" as the name.
Step 4: In the same screen, for setting "Who can use this Application or Access this API?", select the 1st option: "Account in this organizational directory only."
Step 5: Click on Register to complete the registration
Follow the steps to get each values.
Client ID:
A new screen with your input name as the display name opens. Copy "Application (client) ID" from the list inside the "Essentials" tab and paste it to the "Client ID" field of the DeskDay SSO window.
Issuer URL:
The following are the steps to find your application's Issuer URL.
Click “Endpoints” in the Menu at the top-left side of the screen, and copy the “OpenID Connect metadata document” link from the secondary screen that appears from the right. Paste this link to the “Issuer URL” field of the DeskDay SSO window.
Secret Key Value:
The following are the steps to find your application's Secret Key Value.
Step 1: Click the “Add a certificate or secret“ option in Client credentials inside the “Essentials” Tab. In the opened screen, click “New client secret” under the Client secrets tab.
Step 2: In the secondary window that opens from the right, enter the description for the Client secret in the “Description” field. Set a preferred duration when it should expire, and then click on “Add”.
Step 3: A secret value will be generated in the Main window now. Copy the ”Value” from the Client secret tab and paste it to the “Secret Key Value” field.
Step 4: Copy the ”Secret ID” from the Client secret tab and paste it to the “Secret Key Value” field.
Step 5: Update the expiry details on concern field.
Adding Redirect URL
After completing the above steps;
Click on "Redirect URLs" option.
Locate "Add a platform" & click on it. A side-drawer opens, inside that, Choose the option web.
Enter the URL: https://auth-api.deskday.ai/sso/redirect and click on "Configure."
For enabling SSO for IT-Connect Teams add redirect URL https://auth-api.deskday.ai/sso/redirect/team
by clicking on Add URL:
You have successfully added users through SSO after completing these steps.
Now, users can log in to IT-Connect using their email address on that domain. They will be redirected to default browser, where they can login with their domain password and click 'Open IT-Connect' and enjoy a seamless ticketing experience.
If choose the 'Stay signed in to all your apps' option during the installation of the Office application on your device, they can seamlessly access IT-Connect without encountering any pop-up to enter password.
