Use service principal authentication model for Azure Communications Gateway

Author: rcdun

.openpublishing.redirection.json

@@ -22440,6 +22440,11 @@
             "source_path": "articles/private-multi-access-edge-compute-mec/metaswitch-fusion-core-overview.md",
             "redirect_URL": "/azure/private-5g-core",
             "redirect_document_id": false
+        },
+        {
+            "source_path": "articles/communications-gateway/rotate-secrets.md",
+            "redirect_URL": "/azure/communications-gateway/whats-new",
+            "redirect_document_id": false
         }
     ]
 }

articles/communications-gateway/deploy.md

@@ -5,7 +5,7 @@ author: rcdun
 ms.author: rdunstan
 ms.service: communications-gateway
 ms.topic: how-to 
-ms.date: 03/16/2023
+ms.date: 03/17/2023
 ---
 
 # Deploy Azure Communications Gateway
@@ -29,11 +29,11 @@ In this step, you'll create the Azure Communications Gateway resource.
 
     :::image type="content" source="media/deploy/create.png" alt-text="Screenshot of the Azure portal. Shows the existing Azure Communications Gateway. A Create button allows you to create more Azure Communications Gateways.":::
 
-1. Use the information you collected in [Collect Azure Communications Gateway resource values](prepare-to-deploy.md#6-collect-basic-information-for-deploying-an-azure-communications-gateway) to fill out the fields in the **Basics** configuration section and then select **Next: Service Regions**.
+1. Use the information you collected in [Collect Azure Communications Gateway resource values](prepare-to-deploy.md#4-collect-basic-information-for-deploying-an-azure-communications-gateway) to fill out the fields in the **Basics** configuration section and then select **Next: Service Regions**.
 
     :::image type="content" source="media/deploy/basics.png" alt-text="Screenshot of the Create an Azure Communications Gateway portal, showing the Basics section.":::
 
-1. Use the information you collected in [Collect Service Regions configuration values](prepare-to-deploy.md#7-collect-service-regions-configuration-values) to fill out the fields in the **Service Regions** section and then select **Next: Tags**.
+1. Use the information you collected in [Collect Service Regions configuration values](prepare-to-deploy.md#5-collect-service-regions-configuration-values) to fill out the fields in the **Service Regions** section and then select **Next: Tags**.
 1. (Optional) Configure tags for your Azure Communications Gateway resource: enter a **Name** and **Value** for each tag you want to create.
 1. Select **Review + create**.
 

articles/communications-gateway/index.yml

@@ -10,7 +10,7 @@ metadata:
   ms.topic: landing-page
   author: rcdun
   ms.author: rdunstan
-  ms.date: 12/16/2022
+  ms.date: 03/17/2023
 
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | whats-new
 
@@ -64,6 +64,4 @@ landingContent:
           - text: Set up user roles
             url: provision-user-roles.md
           - text: Plan and manage costs
-            url: plan-and-manage-costs.md
-          - text: Rotate secrets
-            url: rotate-secrets.md
+            url: plan-and-manage-costs.md

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

@@ -6,6 +6,8 @@ items:
   items:
   - name: What is Azure Communications Gateway?
     href: overview.md
+  - name: What's new?
+    href: whats-new.md
 - name: Deployment
   items:
   - name: Prepare to deploy
@@ -38,8 +40,6 @@ items:
     href: provision-user-roles.md
   - name: Plan and manage costs
     href: plan-and-manage-costs.md
-  - name: Rotate deployment secrets
-    href: rotate-secrets.md
   - name: Get support or request changes
     href: request-changes.md
 - name: Reference

articles/communications-gateway/rotate-secrets.md

@@ -0,0 +1,26 @@
+---
+title: What's new in Azure Communications Gateway?
+description: Discover what's new in Azure Communications Gateway
+author: rcdun
+ms.author: rdunstan
+ms.service: communications-gateway
+ms.topic: whats-new
+ms.date: 03/16/2023
+---
+
+# What's new in Azure Communications Gateway?
+
+This article covers new features and improvements for Azure Communications Gateway.
+
+## March 2023: Simpler authentication for Operator Connect APIs
+
+Azure Communications Gateway contains services that need to access the Operator Connect API on your behalf. Azure Communications Gateway therefore needs to authenticate with your Operator Connect or Teams Phone Mobile environment.
+
+From March 2023, Azure Communications Gateway automatically provides a service principal for this authentication. You must set up specific permissions for this service principal and then add the service principal to your Operator Connect or Teams Phone Mobile environment. For more information, see [Prepare to deploy Azure Communications Gateway](prepare-to-deploy.md).
+
+This new authentication model replaces an earlier model that required you to create an App registration and manage secrets for it. With the new model, you no longer need to create, manage or rotate secrets.
+
+## Next steps
+
+- [Learn more about Azure Communications Gateway](overview.md).
+- [Prepare to deploy Azure Communications Gateway](prepare-to-deploy.md).