1343456 Apply feedback

Author: rcdun

articles/communications-gateway/connect-operator-connect.md

@@ -97,7 +97,7 @@ To add the Project Synergy application:
 
 The user who sets up Azure Communications Gateway needs to have the Admin user role in the Project Synergy application. Assign them this role in the Azure portal.
 
-1. In the Azure portal, navigate to **Enterprise applications** using the left-hand side menu. Alternatively, you can search for it in the search bar; it's under the **Services** subheading.
+1. In the Azure portal, go to **Microsoft Entra ID** and then **Enterprise applications** using the left-hand side menu. Alternatively, you can search for **Enterprise applications** in the search bar; it's under the **Services** subheading.
 1. Set the **Application type** filter to **All applications** using the drop-down menu.
 1. Select **Apply**.
 1. Search for **Project Synergy** using the search bar. The application should appear.
@@ -110,22 +110,21 @@ The user who sets up Azure Communications Gateway needs to have the Admin user r
 
 ## Find the Application ID for your Azure Communication Gateway resource
 
-Each Azure Communications Gateway resource automatically receives a [system-assigned managed identity](../active-directory/managed-identities-azure-resources/overview.md), which Azure Communications Gateway uses to connect to the Operator Connect environment. You need to find the Object ID and Application ID of the managed identity, so that you can connect Azure Communications Gateway to the Operator Connect or Teams Phone Mobile environment in [Set up application roles for Azure Communications Gateway](#set-up-application-roles-for-azure-communications-gateway) and [Add the Application IDs for Azure Communications Gateway to Operator Connect](#add-the-application-ids-for-azure-communications-gateway-to-operator-connect).
+Each Azure Communications Gateway resource automatically receives a [system-assigned managed identity](../active-directory/managed-identities-azure-resources/overview.md), which Azure Communications Gateway uses to connect to the Operator Connect API. You need to find the  Application ID of the managed identity, so that you can connect Azure Communications Gateway to the Operator Connect API in [Set up application roles for Azure Communications Gateway](#set-up-application-roles-for-azure-communications-gateway) and [Add the Application IDs for Azure Communications Gateway to Operator Connect](#add-the-application-ids-for-azure-communications-gateway-to-operator-connect).
 
 1. Sign in to the [Azure portal](https://azure.microsoft.com/).
-1. In the search bar at the top of the page, search for your Communications Gateway resource.
-1. Select your Communications Gateway resource.
-1. Select **Identity**.
-1. In **System assigned**, copy the **Object (principal) ID**.
-1. Search for the value of **Object (principal) ID** with the search bar. You should see an enterprise application with that value under the **Microsoft Entra ID** subheading. You might need to select **Continue searching in Microsoft Entra ID** to find it.
+1. If you don't already know the name of your Communications Gateway resource, search for **Communications Gateways** and note the name of the resource.
+1. Search for the name of your Communications Resource. You should see an enterprise application with that value under the **Microsoft Entra ID** subheading. You might need to select **Continue searching in Microsoft Entra ID** to find it.
 1. Select the enterprise application.
-1. Check that the **Object ID** matches the **Object (principal) ID** value that you copied.
+1. Check that the **Name** matches the name of your Communications Gateway resource.
 1. Make a note of the **Application ID**.
 
 ## Set up application roles for Azure Communications Gateway
 
 Azure Communications Gateway contains services that need to access the Operator Connect API on your behalf. To enable this access, you must grant specific application roles to the system-assigned managed identity for Azure Communications Gateway under the Project Synergy Enterprise Application. You created the Project Synergy Enterprise Application in [Add the Project Synergy application to your Azure tenant](#add-the-project-synergy-application-to-your-azure-tenant).
 
+You must carry out this step once for each Azure Communications Gateway resource that you want to use for Operator Connect or Teams Phone Mobile.
+
 > [!IMPORTANT]
 > Granting permissions has two parts: configuring the system-assigned managed identity for Azure Communications Gateway with the appropriate roles (this step) and adding the application ID of the managed identity to the Operator Connect or Teams Phone Mobile environment. You'll add the application ID to the Operator Connect or Teams Phone Mobile environment later, in [Add the Application IDs for Azure Communications Gateway to Operator Connect](#add-the-application-ids-for-azure-communications-gateway-to-operator-connect).
 
@@ -154,6 +153,7 @@ Do the following steps in the tenant that contains your Project Synergy applicat
     ```powershell
     Connect-MgGraph -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All" -TenantId "<TenantID>"
     ```
+    If you're prompted to grant permissions for Microsoft Graph Command Line Tools, select **Accept** to grant permissions.
 1. Run the following cmdlet, replacing *`<CommunicationsGatewayName>`* with the name of your Azure Communications Gateway resource.
     ```powershell
     $acgName = "<CommunicationsGatewayName>"
@@ -194,6 +194,10 @@ Do the following steps in the tenant that contains your Project Synergy applicat
     # Check the assigned roles
     Get-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $acgServicePrincipal.Id
     ```
+1. To end your current session, disconnect from Microsoft Graph.
+    ```powershell
+    Disconnect-MgGraph
+    ```
 
 ## Provide additional information to your onboarding team
 

articles/communications-gateway/manage-enterprise-operator-connect.md

@@ -16,6 +16,13 @@ Azure Communications Gateway's Number Management Portal (preview) enables you to
 > [!IMPORTANT]
 > The Operator Connect and Teams Phone Mobile programs require that full API integration to your BSS is completed prior to launch in the Teams Admin Center. This can either be directly to the Operator Connect API or through the Azure Communications Gateway's Provisioning API (preview).
 
+You can:
+
+* Manage your agreement with an enterprise customer.
+* Manage numbers for the enterprise.
+* View civic addresses for an enterprise.
+* Configure a custom header for a number.
+
 ## Prerequisites
 
 Confirm that you have **Reader** access to the Azure Communications Gateway resource and appropriate permissions for the AzureCommunicationsGateway enterprise application:
@@ -60,22 +67,16 @@ Each number is automatically assigned to the Operator Connect or Teams Phone Mob
 
 ## Manage your agreement with an enterprise customer
 
-When an enterprise customer uses the Teams Admin Center to request service, the Operator Connect APIs create a *consent*. The consent represents the relationship between you and the enterprise.
-
-The Number Management Portal displays a consent as a *Request for Information* and allows you to update the status. Finding the Request for Information for an enterprise is also the easiest way to manage numbers for an enterprise.
+When an enterprise customer uses the Teams Admin Center to request service, the Operator Connect APIs create a *consent*. The consent represents the relationship between you and the enterprise. The Number Management Portal displays a consent as a *Request for Information* and allows you to update the status.
 
 1. From the overview page for your Communications Gateway resource, find the **Number Management (Preview)** section in the sidebar.
 1. Select **Requests for Information**.
 1. Find the enterprise that you want to manage. You can use the **Add filter** options to search for the enterprise.
 1. If you need to change the status of the relationship, select the enterprise **Tenant ID** then select **Update relationship status**. Use the drop-down to select the new status. For example, if you're agreeing to provide service to a customer, set the status to **Agreement signed**. If you set the status to **Consent declined** or **Contract terminated**, you must provide a reason.
 
-## Create an Account for the enterprise
+If you're providing service to an enterprise for the first time, you must also create an *Account* for the enterprise.
 
-You must create an *Account* for each enterprise that you manage with the Number Management Portal.
-
-1. From the overview page for your Communications Gateway resource, find the **Number Management (Preview)** section in the sidebar.
-1. Select **Accounts**.
-1. Select **Create account**.
+1. Select the enterprise, then select **Create account**.
 1. Fill in the enterprise **Account name**.
 1. Select the checkboxes for the services you want to enable for the enterprise.
 1. Fill in any additional information requested under the **Communications Services Settings** heading.

articles/communications-gateway/prepare-to-deploy.md

@@ -34,14 +34,13 @@ We strongly recommend that you have a support plan that includes technical suppo
 
 ## Choose the Azure tenant to use
 
-We recommend that you use an existing Microsoft Entra tenant for Azure Communications Gateway, because using an existing tenant uses your existing identities for fully integrated authentication. If you need to manage identities separately from the rest of your organization, create a new dedicated tenant first.
+We recommend that you use an existing Microsoft Entra tenant for Azure Communications Gateway, because using an existing tenant uses your existing identities for fully integrated authentication. If you need to manage identities separately from the rest of your organization, or to set up different permissions for the Number Management Portal for different Azure Communications Gateway resources, create a new dedicated tenant first.
 
 The Operator Connect and Teams Phone Mobile environments inherit identities and configuration permissions from your Microsoft Entra tenant through a Microsoft application called Project Synergy. You must add this application to your Microsoft Entra tenant as part of [Connect Azure Communications Gateway to Operator Connect or Teams Phone Mobile](connect-operator-connect.md) (if your tenant does not already contain this application).
 
 > [!IMPORTANT]
 > For Operator Connect and Teams Phone Mobile, production deployments and lab deployments must connect to the same Microsoft Entra tenant. Microsoft Teams configuration for your tenant shows configuration for your lab deployments and production deployments together.
 
-
 ## Get access to Azure Communications Gateway for your Azure subscription
 
 Access to Azure Communications Gateway is restricted. When you've completed the previous steps in this article:

articles/communications-gateway/provision-user-roles.md

@@ -36,6 +36,8 @@ Your staff might need different user roles, depending on the tasks they need to
 | Monitor logs and metrics. | **Reader** access to the Azure Communications Gateway resource. |
 | Use the Number Management Portal (preview) | **Reader** access to the Azure Communications Gateway resource and appropriate roles for the AzureCommunicationsGateway enterprise application: <!-- Must be kept in sync with step below for configuring and with manage-enterprise-operator-connect.md  --><br>- To view configuration: **ProvisioningAPI.ReadUser**.<br>- To add or make changes to configuration: **ProvisioningAPI.ReadUser** and **ProvisioningAPI.WriteUser**.<br>- To remove configuration: **ProvisioningAPI.ReadUser** and **ProvisioningAPI.DeleteUser**.<br>- To view, add, make changes to, or remove configuration: **ProvisioningAPI.AdminUser**. |
 
+> [!IMPORTANT]
+> The roles that you assign for the Number Management Portal apply to all Azure Communications Gateway resources in the same tenant.
 
 ## Configure user roles