Skip to content

Commit bc31ee4

Browse files
committed
Give more explanation for the background to the initial onboarding steps
1 parent e8ec2b1 commit bc31ee4

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

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

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -23,17 +23,21 @@ You must ensure you've got two or more numbers that you own which are globally r
2323

2424
We strongly recommend that you have a support plan that includes technical support, such as [Microsoft Unified Support](https://www.microsoft.com/en-us/unifiedsupport/overview) or [Premier Support](https://www.microsoft.com/en-us/unifiedsupport/premier).
2525

26-
## 1. Configure Azure Active Directory in Operator Azure tenancy
26+
## 1. Add the Project Synergy application to your Azure tenancy
2727

2828
> [!NOTE]
2929
>This step is required to set you up as an Operator in the Teams Phone Mobile (TPM) and Operator Connect (OC) environments. Skip steps 1 and 2 if you have already onboarded to TPM or OC.
3030
31-
Operator Connect and Teams Phone Mobile inherit permissions and identities from the Azure Active Directory within the Azure tenant where the Project Synergy app is configured. As such, performing this step within an existing Azure tenant uses your existing identities for fully integrated authentication and is recommended. However, if you need to manage identities for Operator Connect separately from the rest of your organization, complete the following steps in a new dedicated tenant.
31+
The Operator Connect and Teams Phone Mobile programs require your Azure Active Directory tenant to contain a Microsoft application called Project Synergy. Operator Connect and Teams Phone Mobile inherit permissions and identities from your Azure Active Directory tenant through the Project Synergy application. The Project Synergy application also allows configuration of Operator Connect or Teams Phone Mobile and assigning users and groups to specific roles.
32+
33+
We recommend that you use an existing Azure Active Directory tenant for Azure Communications Gateway, because using an existing tenant uses your existing identities for fully integrated authentication. However, if you need to manage identities for Operator Connect separately from the rest of your organization, create a new dedicated tenant first.
34+
35+
To add the Project Synergy application:
3236

3337
1. Sign in to the [Azure portal](https://ms.portal.azure.com/) as an Azure Active Directory Global Admin.
3438
1. Select **Azure Active Directory**.
3539
1. Select **Properties**.
36-
1. Scroll down to the Tenant ID field. Your tenant ID will be in the box. Make a note of your tenant ID.
40+
1. Scroll down to the Tenant ID field. Your tenant ID is in the box. Make a note of your tenant ID.
3741
1. Open PowerShell.
3842
1. (If you don't have the Azure Active Directory module installed), run the cmdlet:
3943
```azurepowershell
@@ -45,9 +49,9 @@ Operator Connect and Teams Phone Mobile inherit permissions and identities from
4549
New-AzureADServicePrincipal -AppId eb63d611-525e-4a31-abd7-0cb33f679599 -DisplayName "Operator Connect"
4650
```
4751
48-
## 2. Allow the Project Synergy application
52+
## 2. Assign an Admin user to the Project Synergy application
4953
50-
Project Synergy allows Operator Connect to access your Azure Active Directory. It's required to allow configuration of Operator Connect or Teams Phone Mobile and to assign users and groups to app-roles for your application.
54+
The user who sets up Azure Communications Gateway needs to have the Admin user role in the Project Synergy application.
5155
5256
1. In your Azure portal, navigate to **Enterprise applications** using the left-hand side menu. Alternatively, you can search for it in the search bar, it will appear under the **Services** subheading.
5357
1. Set the **Application type** filter to **All applications** using the drop-down menu.
@@ -56,7 +60,7 @@ Project Synergy allows Operator Connect to access your Azure Active Directory. I
5660
1. Select your **Project Synergy** application.
5761
1. Select **Users and groups** from the left hand side menu.
5862
1. Select **Add user/group**.
59-
1. Specify the user you want to use for setting up Azure Communications Gateway and assign them the **Admin** role.
63+
1. Specify the user you want to use for setting up Azure Communications Gateway and give them the **Admin** role.
6064
6165
## 3. Create an App registration to provide Azure Communications Gateway access to the Operator Connect API
6266

0 commit comments

Comments
 (0)