# Setup Microsoft Entra ID Integration

> Follow the steps below to successfully set up Microsoft Entra ID (formerly known as Azure Active Directory) with our product.

### Step 1: Configure Enterprise Applications in Microsoft Azure

1. Access Enterprise Applications : Log in to the Microsoft Azure portal and navigate to the ***Enterprise Applications*** section.
2. Create a New Application
   1. Click on the ***+ New Application*** button.
   2. Select ***+ Create your own application***.
3. Application Setup
   1. Enter a name for your application.
   2. Choose **Integrate any other application you don't find in the gallery (Non-gallery).**
   3. Finally, click on ***Create*** to complete the process

### Step 2: Set Up Single Sign-On (SSO)

1. Initiate Single Sign-On Configuration: In the application settings, click on ***Set up single sign-on***.
2. Basic SAML Configuration
   1. Add Identifier (Entity ID): Enter the Entity ID provided by the ASOL team (format: \`urn:amazon:cognito:sp:{cognito pool}\`).
   2. Add Reply URL: Enter the URL sent by the ASOL team (format: \`{cognate domain}/saml2/idpresponse\`).

### Step 3: Set up Attributes & Claims

1. \[Required] emailaddress = user.userprincipalname
2. \[Required] roles = user.assignedroles

### Step 4: Role Mapping

Set up the app roles value and provide the expected [user roles in amity bots plus](https://docs.amitysolutions.com/amity-solutions/amity-bots-platform/users#user-roles-and-permissions) to ASOL team

### Step 5: Provide Metadata to ASOL Team via Support Team

Once the above steps are completed, send the App Federation Metadata URL to the [ASOL supper team](https://ekoapp.atlassian.net/servicedesk/customer/portal/5/group/11) for further integration and testing.

1. Open the service request to ASOL support team [LINK](https://ekoapp.atlassian.net/servicedesk/customer/portal/5/group/11)
2. Select Service Request
3. Provide required information to the ASOL team
   1. App Federation Metadata Url
   2. Organization name (use for create the organization id in Amity Bot+)
   3. Attach the files of role mapping (download template [here](https://docs.google.com/spreadsheets/d/1f3wdY_EVdq4fgYvLlxjVlYLfpgNa8pp3Sj-oAKELvmw/edit?gid=0#gid=0))

:::note
For any assistance during this process, feel free to reach out to our support team. We are here to help ensure a smooth integration experience!
:::