partner topic overview

Author: banisadr

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

@@ -7,4 +7,65 @@ author: banisadr
 ms.service: event-grid
 ms.date: 05/18/2020
 ms.author: babanisa
----
+---
+
+Integrate Azure Event Grid with Auth0
+In this article
+Azure’s Event Grid is a serverless event bus that acts as an intermediary allowing you to send data from Auth0 into the Azure ecosystem.
+You can create an event-driven workflow using Event Grid to send your Auth0 tenant logs to the targets of your choice (e.g., Azure Functions, Event Hubs, Sentinel and Logic Apps).
+See the Auth0 event type codes for a full list of the events that Auth0 supports
+Send events from Auth0 to Azure Event Grid
+To send Auth0 events to Azure, you will need:
+Enable Event Grid resource provider
+Set up an event source (in this case, this is Auth0).
+Set up an event handler, the app or service where the event will be sent.
+For more information about these concepts, see Concepts in Azure Event Grid
+Enable Event Grid resource provider
+If you haven’t previously used Event Grid, you will need to register the Event Grid resource provider. If you’ve used Event Grid before, skip to the next section.
+
+In your Azure portal:
+Select Subscriptions on the left menu
+Select the subscription you’re using for Event Grid
+On the left menu, under Settings, select Resource providers
+Find Microsoft.EventGrid
+Select Register
+Refresh to make sure the status changes to Registered
+Set up an Auth0 event source
+Part of the integration process is to set Auth0 up for use as an event source (this step happens on your Dashboard).
+Log in to the Auth0 Dashboard.
+Navigate to Logs > Streams.
+Click + Create Stream.
+Select Azure Event Grid and enter a unique name for your new stream.
+Create the event source by providing your Azure Subscription ID, Azure Region and a Resource Group name. 
+Click Save.
+Go to the Azure Portal to complete the final steps of the integration.
+Set up an event handler
+Go to your Azure subscription and spin up a service that is supported as an event handler (for a full list of all supported event handlers go to this article).
+Activate your Auth0 Partner Topic in Azure
+Activating the Auth0 topic in Azure allows events to flow from Auth0 to Azure.
+Log in to the Azure Portal.
+Search `Partner Topics` at the top and click `Event Grid Partner Topics` under services.
+Click on the topic that matches the stream you created in your Auth0 Dashboard.
+Confirm the `Source` field matches your Auth0 account.
+Click Activate.
+
+Subscribe to your Auth0 Partner Topic
+You subscribe to an event grid topic to tell Event Grid which events to send to which event handler.
+On the Event Grid topic page, select + Event Subscription on the toolbar
+On the Create Event Subscription page:
+Enter a name for the event subscription.
+Select your desired Azure service or WebHook for the Endpoint type.
+Follow the instructions for the particular service.
+Back on the Create Event Subscription page, select Create.
+To send events to your topic, please follow the instructions on this article.
+Testing
+At this point, your Event Grid workflow should be complete. 
+Verify the integration
+To verify that the integration is working as expected:
+Log in to the Auth0 Dashboard.
+Navigate to Logs > Streams.
+Click on your Event Grid stream.
+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.
+Delivery attempts and retries
+Auth0 events are delivered to AWS via a streaming mechanism that sends each event as it is triggered in our system. If EventBridge is unable to receive the event, we will retry up to three times to deliver the event; otherwise, we will log the failure to deliver in our system.
+

articles/event-grid/auth0-overview.md

@@ -7,4 +7,40 @@ author: banisadr
 ms.service: event-grid
 ms.date: 05/18/2020
 ms.author: babanisa
----
+---
+
+Partner Topics Page
+
+Logo: We may just have to use the shield logo if our horizontal logo doesn’t fit since they use squares.
+https://cdn.auth0.com/website/media/auth0-assets-logos-2019.zip
+
+
+Blurb: Auth0, the identity platform for application builders, provides developers and enterprises with the building blocks they need to secure their applications.
+
+Description
+
+Partnering with Event Grid allows our customers to leverage events emitted by Auth0’s system to accomplish a number of use cases, from engaging with users in meaningful and custom ways after the authentication to automating security and infrastructure tasks.
+
+The Auth0 Partner Topic integration allows you to stream your Auth0 log events with high reliability into Azure for consumption with any of your favorite Azure resources. This will allow you to react to events, gain insights, monitor for security issues, and interact with other powerful data pipelines.
+
+For organizations using Auth0 and Azure, this integration will allow you to seamlessly integrate data across your entire stack. Here is a quick overview of the use cases this integration unlocks:
+ 
+
+Engage with Your Users
+Delivering a strong user experience is critical to reducing churn and retaining users. Using Auth0 log events and Azure Functions and Azure Logic Apps, you can deliver more customized application experiences. 
+Understand User Behavior
+Understanding when users access your product, where they are signed in from, and what devices they use are important pieces of information that can drive your product development. By keeping track of these signals, via the log events emitted by Auth0, you can develop an understanding of the product areas that you should be paying attention to. These signals can help you determine what browsers and devices to support, what languages to consider localizing your app in, and when your peak application traffic times are. 
+Manage User Data
+Retaining and auditing user actions is crucial for maintaining security and complying with industry regulations. Besides, the ability to edit, remove, or export user data upon request is becoming increasingly important to comply with various data privacy laws, such as the European Union’s General Data Protection Regulation (GDPR).
+Secure Your Application
+Consolidating security monitoring and incident response procedures is important when protecting a distributed system. For this reason it is important to keep all the data in one place and monitor the entire stack. 
+
+Creating an Auth0 Partner Topic
+
+Note the Azure Subscription and Resource Group you want the Partner Topic to be created in.
+Log in to your Auth0 account dashboard. Navigate to Logs > Streams, click “Create Stream” and select the “Azure Event Grid” event stream.
+Provide the Azure Subscription ID, Resource Group and other required information and click “Save”
+View your pending Partner Topics in Azure and activate the topic to allow events to flow.
+
+Go To Button Link: https://auth0.com/docs/logs/streams/azure-eventgrid
+

articles/event-grid/media/partner-onboarding-how-to/activatePartnerTopic.png

@@ -7,4 +7,41 @@ author: banisadr
 ms.service: event-grid
 ms.date: 05/18/2020
 ms.author: babanisa
----
+---
+
+
+## Prerequisites
+
+1. Please contact Azure Event Grid team ([email protected]) with a list of Azure subscriptions to be whitelisted in order to be allowed to try this feature. 
+1. As of 01/15/2020, partner topic support is available in centraluseuap only; hence this sample code can used in this region only.
+1. The following resources are expected to be pre-created and ready to be used:
+    * At least one valid Azure Subscription, although the scenario is designed for three different Azure Subscriptions to be used for partner registration, namespaces/eventchannels, and partner topics, respectively. The first two Azure subscriptions are expected to be owned by the partner and the last one is owned by the user/customer.
+    * At least one valid resource group. Similar to the Azure Subscriptions point above in 3.a, the scenario is also designed for three different resource groups, one for each Azure Subscription, to be used for partner registration, namespaces/eventchannels, and partner topics, respectively.
+
+    The first two Azure subscriptions/Resource Groups are expected to be owned by the partner and the last one is owned by the user/customer.
+1. Registrered App Id, and tenant Id. For simplicity, this console app assumes the same for both partner and customer but code can be updated to allow different values.
+1. Valid certificate which is associated with the AppId to be installed on the machine.
+1. Valid storage account and storage queue to be used as an event subscription destination. Here is a link for doing that using portal https://docs.microsoft.com/en-us/azure/storage/queues/storage-quickstart-queues-portal and cli https://docs.microsoft.com/en-us/cli/azure/storage/queue?view=azure-cli-latest
+1. Fill out these required information in the App.Config file. Each entry is marked with Placeholder in the comment in the App.Config file.
+1. Open the project using Visual Studio 2017 or higher. Build and run.
+## Scenario Flow
+
+The overall flow of the scenario demoed in the sample code is:
+
+1. Create Partner Topic (owner: Partner)
+
+![Create Partner Topic](./media/partner-onboarding-how-to/createPartnerRegistration.png)
+
+2. Create Partner Namespace (owner: Partner)
+
+![Create Partner Namespace](./media/partner-onboarding-how-to/createPartnerNamespace.png)
+
+3. Create Event Channel (owner: Partner)
+
+![Create Event Channel](./media/partner-onboarding-how-to/createEventTunnelPartnerTopic.png)
+
+4. Activate Partner Topic (owner: customer)
+
+![Activate Partner Topic](./media/partner-onboarding-how-to/activatePartnerTopic.png)
+
+5. Create Event Subscription on Partner Topic (owner: customer)

articles/event-grid/media/partner-onboarding-how-to/createEventTunnelPartnerTopic.png

@@ -7,4 +7,27 @@ author: banisadr
 ms.service: event-grid
 ms.date: 05/18/2020
 ms.author: babanisa
----
+---
+
+# Partner Topics in Azure Event Grid (Preview)
+Partner Topics allow you to connect 3rd party event sources, such as SaaS and PaaS solutions, directly to Event Grid. This allows you to subscribe to events from partners in the same way you are able to subscribe to events from other Azure services, such as Azure Storage and IoT Hub. 
+
+## Available Partners
+The first partner available through Event Grid Partner Topics is Auth0. The [Auth0 partner topic](auth0-overview.md) enables you to connect your Auth0 and Azure accounts in order to react to, log, and monitor Auth0 events in real time.
+
+[Try it out](auth0-how-to.md) today by logging in to your Auth0 account and creating an Event Grid integration. Once you click create in Auth0, you’ll see a pending Auth0 Topic in your Azure account. Click activate and you’ll be able to create Event Subscriptions, route, filter, and deliver your events just as you do any other event source.
+
+## Pricing
+Partner topics are charged at the same operation rate as system topics.
+
+## Limits
+Partner Topics are in Public Preview. During public preview, Partner topics are subject to the [same limits](https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/azure-subscription-service-limits#event-grid-limits) as system topics and custom topics.
+
+## How do I become an Event Grid partner?
+The infrastructure created to support this launch makes it easy and quick for new partners to integrate their eventing capabilities with Event Grid. Read the [partner onboarding documentation](partner-onboarding-how-to.md) for more.
+
+## Next steps
+
+- [Auth0 Partner Topic](auth0-overview.md)
+- [How to use the Auth0 Partner Topic](auth0-how-to.md)
+- [Become an Event Grid partner](partner-onboarding-how-to.md)