Merge pull request #252517 from valindrae/connect-cognitive-service-acs

Update azure-communication-services-azure-cognitive-services-integrat…

Author: Jill Grant

articles/communication-services/concepts/call-automation/azure-communication-services-azure-cognitive-services-integration.md

@@ -59,7 +59,7 @@ You can configure and bind your Communication Services and Azure AI services thr
    2.3. Enable system assigned identity. This action begins the creation of the identity; A pop-up notification appears notifying you that the request is being processed.
   [![Screen shot of enable managed identiy.](./media/enable-system-identity.png)](./media/enable-system-identity.png#lightbox)
 
-   2.4. Once the identity is enabled you should see something similar.
+   2.4. Once the identity is enabled, you should see something similar.
    [![Screenshot of enabled identity.](./media/identity-saved.png)](./media/identity-saved.png#lightbox)
 
 3. When managed identity is enabled the Cognitive Service tab should show a button 'Connect cognitive service' to connect the two services.
@@ -74,6 +74,44 @@ You can configure and bind your Communication Services and Azure AI services thr
 6. Now in the Cognitive Service tab you should see your connected services showing up. 
 [![Screenshot of connected cognitive service on main page.](./media/new-entry-created.png)](./media/new-entry-created.png#lightbox)
 
+### Manually adding Managed Identity to Azure Communication Services resource
+Alternatively if you would like to go through the manual process of connecting your resources you can follow these steps.
+
+#### Enable system assigned identity
+1. Navigate to your Azure Communication Services resource in the Azure portal.
+2. Select the Identity tab.
+3. Enable system assigned identity. This action begins the creation of the identity. A pop-up notification appears notifying you that the request is being processed.
+[![Screenshot of enable system identity.](./media/enable-system-identity.png)](./media/enable-system-identity.png#lightbox)
+
+#### Option 1: Add role from Azure Cognitive Services in the Azure portal
+1. Navigate to your Azure Cognitive Services resource.
+2. Select the "Access control (IAM)" tab.
+3. Click the "+ Add" button.
+4. Select "Add role assignments" from the menu.
+[![Screenshot of adding a role assignment.](./media/add-role.png)](./media/add-role.png#lightbox)
+5. Choose the "Cognitive Services User" role to assign, then click "Next."
+[![Screenshot of Cognitive Services User.](./media/cognitive-service-user.png)](media/cognitive-service-user.png#lightbox)
+6. For the field "Assign access to" choose the "User, group or service principal."
+7. Press "+ Select members" and a side tab opens.
+8. Search for your Azure Communication Services resource name in the text box and click it when it shows up, then click "Select."
+[![Screenshot of Azure Communication Services resource side panel.](./media/select-acs-resource.png)](./media/select-acs-resource.png#lightbox)
+9. Click "Review + assign," this assigns the role to the managed identity.
+
+#### Option 2: Add role through Azure Communication Services Identity tab
+1. Navigate to your Azure Communication Services resource in the Azure portal.
+2. Select Identity tab.
+3. Click on "Azure role assignments."
+[![Screenshot of the role assignment screen.](./media/add-role-acs.png)](./media/add-role-acs.png#lightbox)
+4. Click the "Add role assignment (Preview)" button, which opens the "Add role assignment (Preview)" tab.
+5. Select the "Resource group" for "Scope."
+6. Select the "Subscription."
+7. Select the "Resource Group" containing the Cognitive Service.
+8. Select the Role "Cognitive Services User."
+[![Screenshot of filled in role assignment tab.](./media/acs-roles-cognitive-services.png)](./media/acs-roles-cognitive-services.png#lightbox)
+9. Click Save.
+
+Your Azure Communication Service has now been linked to your Azure Cognitive Service resource.
+
 ## Azure AI services regions supported
 
 This integration between Azure Communication Services and Azure AI services is only supported in the following regions:
@@ -89,6 +127,6 @@ This integration between Azure Communication Services and Azure AI services is o
 - westeu
 - uksouth
 
-## Next Steps
+## Next steps
 - Learn about [playing audio](../../concepts/call-automation/play-action.md) to callers using Text-to-Speech.
 - Learn about [gathering user input](../../concepts/call-automation/recognize-action.md) with Speech-to-Text.