Merge pull request #216613 from spelluru/egridsap1031

Include files

Author: 19BMG00

articles/event-grid/auth0-how-to.md

@@ -2,7 +2,7 @@
 title: How to send events from Auth0 to Azure using Azure Event Grid
 description: How to end events from Auth0 to Azure services with Azure Event Grid.
 ms.topic: conceptual
-ms.date: 03/29/2022
+ms.date: 11/07/2022
 ---
 
 # Integrate Azure Event Grid with Auth0
@@ -14,13 +14,16 @@ This article describes how to connect your Auth0 and Azure accounts by creating
 ## Send events from Auth0 to Azure Event Grid
 To send Auth0 events to Azure:
 
-1. [Register the Event Grid resource provider](subscribe-to-partner-events.md#register-the-event-grid-resource-provider) with your Azure subscription.
-2. [Authorize Auth0](subscribe-to-partner-events.md#authorize-partner-to-create-a-partner-topic) to create a partner topic in your resource group.
+1. [Register the Event Grid resource provider](#register-the-event-grid-resource-provider) with your Azure subscription.
+1. [Authorize partner](#authorize-partner-to-create-a-partner-topic) to create a partner topic in your resource group.
 3. Request Auth0 to enable events flow to a partner topic by [setting up an Auth0 partner topic](#set-up-an-auth0-partner-topic) in the Auth0 Dashboard.
-4. [Activate partner topic](subscribe-to-partner-events.md#activate-a-partner-topic) so that your events start flowing to your partner topic.
-5. [Subscribe to events](subscribe-to-partner-events.md#subscribe-to-events).
+4. [Activate partner topic](#activate-a-partner-topic) so that your events start flowing to your partner topic.
+5. [Subscribe to events](#subscribe-to-events).
 
-This article provides steps for doing the task #3 from the above list. All other tasks are documented in the [Subscribe to partner events](subscribe-to-partner-events.md) article. 
+
+[!INCLUDE [register-event-grid-provider](includes/register-event-grid-provider.md)]
+
+[!INCLUDE [authorize-verified-partner-to-create-topic](includes/authorize-verified-partner-to-create-topic.md)]
 
 ## Set up an Auth0 partner topic
 Part of the integration process is to set up Auth0 for use as an event source by using the [Auth0 Dashboard](https://manage.auth0.com/).
@@ -37,21 +40,28 @@ Part of the integration process is to set up Auth0 for use as an event source by
 1. Click **Save**.
 
 You should see the partner topic in the resource group you specified. [Activate the partner topic](subscribe-to-partner-events.md#activate-a-partner-topic) so that your events start flowing to your partner topic. Then, [subscribe to events](subscribe-to-partner-events.md#subscribe-to-events).
+
+
+:::image type="content" source="./media/auth0-how-to/partner-topic.png" alt-text="Screenshot showing the partner topic in the list.":::
 
+[!INCLUDE [activate-partner-topic](includes/activate-partner-topic.md)]
+
+[!INCLUDE [subscribe-to-events](includes/subscribe-to-events.md)]
+
+Try [invoking any of the Auth0 actions that trigger an event to be published](https://auth0.com/docs/logs/references/log-event-type-codes) to see events flow.
 
 ## Verify the integration
 To verify that the integration is working as expected:
 
 1. Log in to the Auth0 Dashboard.
-1. Navigate to **Logs** > **Streams**.
+1. Navigate to **Monitoring** > **Streams**.
 1. Click on your **Event Grid stream**.
 1. Once on the stream, click on the **Health** tab. The stream should be active and as long as you don't see any errors, the stream is working.
 
-Try [invoking any of the Auth0 actions that trigger an event to be published](https://auth0.com/docs/logs/references/log-event-type-codes) to see events flow.
-
 ## Delivery attempts and retries
 Auth0 events are delivered to Azure via a streaming mechanism. Each event is sent as it's triggered in Auth0. If Event Grid is unable to receive the event, Auth0 will retry up to three times to deliver the event. Otherwise, Auth0 will log the failure to deliver in its system.
 
+
 ## Next steps
 
 - [Auth0 Partner Topic](auth0-overview.md)

articles/event-grid/includes/activate-partner-topic.md

@@ -0,0 +1,24 @@
+---
+ title: include file
+ description: include file
+ services: event-grid
+ author: spelluru
+ ms.service: event-grid
+ ms.topic: include
+ ms.date: 10/31/2022
+ ms.author: spelluru
+ ms.custom: include file
+---
+
+## Activate a partner topic
+
+1. In the search bar of the Azure portal, search for and select **Event Grid Partner Topics**.
+1. On the **Event Grid Partner Topics** page, select the partner topic in the list. 
+
+    :::image type="content" source="./media/onboard-partner/select-partner-topic.png" lightbox="./media/onboard-partner/select-partner-topic.png" alt-text="Screenshot that shows selection a partner topic in the Event Grid Partner Topics page.":::    
+1. Review the activate message, and select **Activate** on the page or on the command bar to activate the partner topic before the expiration time mentioned on the page. 
+
+    :::image type="content" source="./media/onboard-partner/activate-partner-topic-button.png" lightbox="./media/onboard-partner/activate-partner-topic-button.png" alt-text="Screenshot showing the selection of the Activate button on the command bar or on the page.":::    
+1. Confirm that the activation status is set to **Activated** and then create event subscriptions for the partner topic by selecting **+ Event Subscription** on the command bar. 
+
+    :::image type="content" source="./media/onboard-partner/partner-topic-activation-status.png" lightbox="./media/onboard-partner/partner-topic-activation-status.png" alt-text="Screenshot showing the activation state of a partner topic as **Activated**.":::   

articles/event-grid/includes/authorize-partner-to-create-topic.md

@@ -0,0 +1,64 @@
+---
+ title: include file
+ description: include file
+ services: event-grid
+ author: spelluru
+ ms.service: event-grid
+ ms.topic: include
+ ms.date: 10/31/2022
+ ms.author: spelluru
+ ms.custom: include file
+---
+
+## Authorize partner to create a partner topic
+
+You must grant your consent to the partner to create partner topics in a resource group that you designate. This authorization has an expiration time. It's effective for the time period you specify between 1 to 365 days. 
+
+> [!IMPORTANT]
+> For a greater security stance, specify the minimum expiration time that offers the partner enough time to configure your events to flow to Event Grid and to provision your partner topic. Your partner won't be able to create resources (partner topics) in your Azure subscription after the authorization expiration time. 
+
+> [!NOTE]
+> Event Grid started enforcing authorization checks to create partner topics around June 30th, 2022. 
+
+Following example shows the way to create a partner configuration resource that contains the partner authorization. You must identify the partner by providing either its **partner registration ID** or the **partner name**. Both can be obtained from your partner, but only one of them is required. For your convenience, the following examples leave a sample expiration time in the UTC format.
+
+### Azure portal
+
+1. Sign in to the [Azure portal](https://portal.azure.com).
+1. In the search bar at the top, enter **Partner Configurations**, and select **Event Grid Partner Configurations** under **Services** in the results. 
+1. On the **Event Grid Partner Configurations** page, select **Create Event Grid partner configuration** button on the page (or) select **+ Create** on the command bar. 
+
+    :::image type="content" source="./media/subscribe-to-partner-events/partner-configurations.png" alt-text="Screenshot showing the Event Grid Partner Configurations with the list of partner configurations and a link to create a partner registration.":::    
+1. On the **Create Partner Configuration** page, do the following steps: 
+    1. In the **Project Details** section, select the **Azure subscription** and the **resource group** where you want to allow the partner to create a partner topic. 
+    1. In the **Partner Authorizations** section, specify a default expiration time for partner authorizations defined in this configuration. 
+    1. To provide your authorization for a partner to create partner topics in the specified resource group, select **+ Partner Authorization** link. 
+    
+        :::image type="content" source="./media/subscribe-to-partner-events/partner-authorization-configuration.png" alt-text="Screenshot showing the Create Partner Configuration page with the Partner Authorization link selected.":::
+        
+1. On the **Add partner authorization to create resources** page, you see a list of **verified partners**. A verified partner is a partner whose identity has been validated by Microsoft. You can select a verified partner, and select **Add** button at the bottom to give the partner the authorization to add a partner topic in your resource group. This authorization is effective up to the expiration time. 
+
+    You also have an option to authorize a **non-verified partner.** Unless the partner is an entity that you know well, for example, an organization within your company, it's strongly encouraged that you only work with verified partners. If the partner isn't yet verified, encourage them to get verified by asking them to contact the Event Grid team at [email protected]. 
+
+    1. To authorize a **verified partner**:
+        1. Select the partner from the list.
+        1. Specify **authorization expiration time**.
+        1. select **Add**. 
+    
+            :::image type="content" source="./media/subscribe-to-partner-events/add-verified-partner.png" alt-text="Screenshot for granting a verified partner the authorization to create resources in your resource group.":::        
+    1. To authorize a non-verified partner, select **Authorize non-verified partner**, and follow these steps:
+        1. Enter the **partner registration ID**. You need to ask your partner for this ID. 
+        1. Specify authorization expiration time. 
+        1. Select **Add**. 
+        
+            :::image type="content" source="./media/subscribe-to-partner-events/add-non-verified-partner.png" alt-text="Screenshot for granting a non-verified partner the authorization to create resources in your resource group.":::       
+
+            > [!IMPORTANT]          
+            > Your partner won't be able to create resources (partner topics) in your Azure subscription after the authorization expiration time. 
+1. Back on the **Create Partner Configuration** page, verify that the partner is added to the partner authorization list at the bottom. 
+1. Select **Review + create** at the bottom of the page. 
+
+    :::image type="content" source="./media/subscribe-to-partner-events/create-partner-registration.png" alt-text="Screenshot showing the Create Partner Configuration page with the partner authorization you just added.":::                    
+1. On the **Review** page, review all settings, and then select **Create** to create the partner registration. 
+
+

articles/event-grid/includes/authorize-verified-partner-to-create-topic.md

@@ -0,0 +1,48 @@
+---
+ title: include file
+ description: include file
+ services: event-grid
+ author: spelluru
+ ms.service: event-grid
+ ms.topic: include
+ ms.date: 10/31/2022
+ ms.author: spelluru
+ ms.custom: include file
+---
+
+## Authorize partner to create a partner topic
+
+You must grant your consent to the partner to create partner topics in a resource group that you designate. This authorization has an expiration time. It's effective for the time period you specify between 1 to 365 days. 
+
+> [!IMPORTANT]
+> For a greater security stance, specify the minimum expiration time that offers the partner enough time to configure your events to flow to Event Grid and to provision your partner topic. Your partner won't be able to create resources (partner topics) in your Azure subscription after the authorization expiration time. 
+
+> [!NOTE]
+> Event Grid started enforcing authorization checks to create partner topics around June 30th, 2022. 
+
+
+1. Sign in to the [Azure portal](https://portal.azure.com).
+1. In the search bar at the top, enter **Partner Configurations**, and select **Event Grid Partner Configurations** under **Services** in the results. 
+1. On the **Event Grid Partner Configurations** page, select **Create Event Grid partner configuration** button on the page (or) select **+ Create** on the command bar. 
+
+    :::image type="content" source="./media/subscribe-to-partner-events/partner-configurations.png" alt-text="Screenshot showing the Event Grid Partner Configurations page with the list of partner configurations and the link to create a partner registration.":::    
+1. On the **Create Partner Configuration** page, do the following steps: 
+    1. In the **Project Details** section, select the **Azure subscription** and the **resource group** where you want to allow the partner to create a partner topic. 
+    1. In the **Partner Authorizations** section, specify a default expiration time for partner authorizations defined in this configuration. 
+    1. To provide your authorization for a partner to create partner topics in the specified resource group, select **+ Partner Authorization** link. 
+    
+        :::image type="content" source="./media/subscribe-to-partner-events/partner-authorization-configuration.png" alt-text="Screenshot showing the Create Partner Configuration page with the Partner Authorization link selected.":::
+1. On the **Add partner authorization to create resources** page, you see a list of **verified partners**. A verified partner is a partner whose identity has been validated by Microsoft. Follow these steps to authorize **Auth0** to create a partner topic. 
+    1. Select the **verified partner** (Auth0, SAP, or Microsoft Graph API)  from the list of verified partners.
+    1. Specify **authorization expiration time**.
+    1. select **Add**. 
+
+        :::image type="content" source="./media/authorize-verified-partner-to-create-topic/add-verified-partner.png" alt-text="Screenshot showing the page that allows you to grant a verified partner the authorization to create resources in your resource group.":::        
+
+        > [!IMPORTANT]          
+        > Your partner won't be able to create resources (partner topics) in your Azure subscription after the authorization expiration time.         
+1. Back on the **Create Partner Configuration** page, verify that the partner is added to the partner authorization list at the bottom. 
+1. Select **Review + create** at the bottom of the page. 
+1. On the **Review** page, review all settings, and then select **Create** to create the partner registration. 
+
+