Purpose
This article explains how to set up the Microsoft Entra ID Authentication needed to connect your apps to your Microsoft account (e.g., mail, calendar).
Before you begin
Before using the chat interface, make sure that:
- the agentic system has already been configured and deployed
- the deployment job has completed successfully
- the serving layer is active in Ray
If the system is not yet deployed, the chat interface may not be able to route requests correctly.
Note: You need admin permissions to complete all the following steps.
Setting up Microsoft Entra ID Authentication
Go to https://portal.azure.com/#home -> Manage Microsoft Entra ID. Entra ID manages the user identities and the apps connecting to Microsoft.
In App Registration, you can access and create new applications. For example, we created the email and the calendar. Register the app by clicking "New Registration" specifying the name and selecting Web under Redirect UI.
Then Register. You will now have these IDs in the overview section: the Client ID and the Tenant ID. These will need to be inserted in Giotto OS.
Then you have to create a new Secret. Here, in the Certificates & secrets section -> New client secret with description and expiring date. Remember to copy the secret once created, as you won't have access to it again. This secret has to be stored in Giotto OS.
Now you have to customize the permissions for this app. When we register the app, what permission do we give it? Examples:
- User.Read if we want only read permission, which is the minimum we can provide
- User.Read, Mail.ReadWrite, Mail.Read, Mail.Send, offline_access for the Giotto Email app
- User.Read, Calendar.ReadWrite, offline_access for the Giotto Calendar app
So, in Add a permission, -> Delegated permissions.
Once you are done, make sure to click on the "Grant Admin Consent for XXX". This will activate all these permissions.
Now the setup of Microsoft Entra ID Authentication should be completed: you can share the tenant ID, the client ID and the Client Secret with the users that need to connect their MS tools with Giotto OS.
Comments
0 comments
Please sign in to leave a comment.