整合 Azure 事件方格與 Auth0

本文說明如何藉由建立事件方格合作夥伴主題來連接您的 Auth0 與 Azure 帳戶。

注意

如需 Auth0 支援之事件的完整清單,請參閱 Auth0 事件類型代碼

將事件從 Auth0 傳送至 Azure 事件方格

若要將 Auth0 事件傳送至 Azure:

  1. 使用您的 Azure 訂用帳戶註冊事件方格資源提供者
  2. 授權合作夥伴在您的資源群組中建立合作夥伴主題。
  3. 在 Auth0 儀表板上設定 Auth0 合作夥伴主題,以要求 Auth0 允許事件流向合作夥伴主題。
  4. 啟動合作夥伴主題,以便您的事件開始流向您的合作夥伴主題。
  5. 訂閱事件

註冊事件方格資源提供者

若您先前未曾使用過事件方格,您將必須註冊事件方格資源提供者。 如果您先前曾使用過事件方格,請跳到下一節。

在 Azure 入口網站中,執行下列步驟:

  1. 選取左側功能表上的 [訂用帳戶]

  2. 從訂用帳戶清單中選取您要用於事件方格的訂用帳戶

  3. 在 [訂用帳戶] 頁面上,在左側功能表的 [設定] 下方選取 [資源提供者]

  4. 搜尋 Microsoft.EventGrid,並確認 [狀態] 為 [未註冊]

  5. 選取提供者清單中的 Microsoft.EventGrid

  6. 在命令列上選取 [註冊]

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. 重新整理以確定 Microsoft.EventGrid 的狀態已變更為已註冊

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

授權合作夥伴建立合作夥伴主題

您必須授權同意合作夥伴在您指定的資源群組中建立合作夥伴主題。 此授權有到期時間。 有效期間介於您所指定的 1 到 365 天之間。

重要

為了提高安全性態勢,請指定到期時間下限,讓合作夥伴有足夠的時間設定您的事件流向事件方格,以及佈建您的合作夥伴主題。 在授權到期時間之後,您的合作夥伴將無法在 Azure 訂用帳戶中建立資源 (合作夥伴主題)。

注意

事件方格在 2022 年 6 月 30 日左右開始強制執行授權檢查,以建立合作夥伴主題。

  1. 登入 Azure 入口網站

  2. 在頂端搜尋列中,輸入合作夥伴設定,然後在結果中的 [服務] 下選取 [事件方格合作夥伴設定]

  3. 在 [事件方格合作夥伴設定] 頁面上,選取頁面上的 [建立事件方格合作夥伴設定] 按鈕 (或) 在命令列上選取 [+ 建立]

    Screenshot showing the Event Grid Partner Configurations page with the list of partner configurations and the link to create a partner registration.

  4. 在 [建立合作夥伴設定] 頁面上,執行下列步驟:

    1. 在 [專案詳細資料] 區段中,選取您想要允許合作夥伴在其中建立合作夥伴主題的 Azure 訂用帳戶資源群組

    2. 在 [合作夥伴授權] 區段中,指定在此設定中為合作夥伴授權定義的預設到期時間。

    3. 若要提供您的授權,讓合作夥伴在指定的資源群組中建立合作夥伴主題,請選取 [+ 合作夥伴授權] 連結。

      Screenshot showing the Create Partner Configuration page with the Partner Authorization link selected.

  5. 在 [新增合作夥伴授權以建立資源] 頁面上,您會看到已驗證的合作夥伴清單。 已驗證的合作夥伴是已經由 Microsoft 驗證其身分識別的合作夥伴。 遵循下列步驟以授權 Auth0,以建立合作夥伴主題。

    1. 從已驗證合作夥伴清單中選取已驗證合作夥伴 (Auth0, SAP、Tribal Group 或 Microsoft Graph API)。

    2. 指定授權到期時間

    3. 選取 [新增]

      Screenshot showing the page that allows you to grant a verified partner the authorization to create resources in your resource group.

      重要

      在授權到期時間之後,您的合作夥伴將無法在 Azure 訂用帳戶中建立資源 (合作夥伴主題)。

  6. 回到 [建立合作夥伴設定] 頁面,確認合作夥伴已新增至底部的合作夥伴授權清單。

  7. 選取頁面底部的 [檢閱 + 建立] 。

  8. 在 [檢閱] 頁面上,檢閱所有設定,然後選取 [建立] 以建立合作夥伴註冊。

設定 Auth0 合作夥伴主題

在整合的過程中,您必須使用 Auth0 儀表板將 Auth0 設定為事件來源。

  1. 登入 Auth0 儀表板
  2. 瀏覽至 [監視]> [串流]
  3. 按一下 [+ 建立記錄串流]
  4. 選取 [Azure 事件方格],然後為新的串流輸入唯一的名稱。
  5. 在 [訂閱識別碼] 中輸入您的 Azure 訂閱識別碼。
  6. 在 [Azure 區域] 中選取資源群組所在的 Azure 區域。
  7. 在 [資源群組] 中輸入資源群組的名稱。
  8. 在 [依事件類別目錄篩選] 中選取 [全部] 或篩選特定類型的事件。
  9. 如果您想要在特定日期和時間開始串流,請選取 [使用特定日期和時間來開始串流] 選項。
  10. 按一下 [檔案] 。

您應該會在您指定的資源群組中看到合作夥伴主題。 啟動合作夥伴主題,以便您的事件開始流向您的合作夥伴主題。 然後請訂閱事件

Screenshot showing the partner topic in the list.

啟用合作夥伴主題

  1. 在 Azure 入口網站的搜尋列中,搜尋並選取 [事件方格合作夥伴主題]

  2. 在 [事件方格合作夥伴主題] 頁面上,選取清單中的合作夥伴主題。

    Screenshot that shows selection a partner topic in the Event Grid Partner Topics page.

  3. 檢閱啟用訊息,然後在頁面或命令列上選取 [啟用],以在頁面上提及的到期時間之前啟用合作夥伴主題。

    Screenshot showing the selection of the Activate button on the command bar or on the page.

  4. 確認啟用狀態設定為 [已啟用],然後在命令列上選取 [+ 事件訂閱],以建立合作夥伴主題的事件訂閱。

    Screenshot showing the activation state of a partner topic as **Activated**.

訂閱事件

首先,建立事件處理常式,以處理來自合作夥伴的事件。 例如,建立事件中樞、服務匯流排佇列或主題,或是 Azure 函式。 然後,使用您建立的事件處理常式,建立合作夥伴主題的事件訂閱。

建立事件處理常式

若要測試您的合作夥伴主題,您將需要事件處理常式。 請前往您的 Azure 訂閱,並啟動支援作為事件處理常式的服務,例如 Azure 函式。 如需範例,請參閱事件方格檢視器範例,您可以透過 Webhook 以此作為事件處理常式。

訂閱合作夥伴主題

訂閱合作夥伴主題會告訴事件方格您想要傳遞合作夥伴事件的位置。

  1. 在 Azure 入口網站的搜尋方塊中,鍵入事件方格合作夥伴主題,然後選取[事件方格合作夥伴主題]

  2. 在 [事件方格合作夥伴主題] 頁面上,選取清單中的合作夥伴主題。

    Screenshot showing the selection of a partner topic on the Event Grid Partner Topics page.

  3. 在合作夥伴主題的 [事件方格合作夥伴主題] 頁面上,選取命令列上的 [+ 事件訂閱]

    Screenshot showing the selection of Add Event Subscription button on the Event Grid Partner Topic page.

  4. 在 [建立事件訂用帳戶] 頁面上,執行下列步驟:

    1. 輸入事件訂閱的 [名稱]

    2. 針對 [篩選至事件類型],選取您的訂閱將接收的事件類型。

    3. 針對 [端點類型],選取 Azure 服務 (Azure 函式、儲存體佇列、事件中樞、服務匯流排佇列、服務匯流排主題、混合式連線等) 或 Webhook。

    4. 按一下 [選取端點] 連結。 在此範例中,讓我們使用 Azure 事件中樞目的地或端點。

      Screenshot showing the configuration of an endpoint for an event subscription.

    5. 在 [選取事件中樞] 頁面上,選取端點的設定,然後選取 [確認選取項目]

      Screenshot showing the configuration of an Event Hubs endpoint.

    6. 現在於 [建立事件訂閱] 頁面上,選取 [建立]

      Screenshot showing the Create Event Subscription page with example configurations.

嘗試叫用任何會觸發事件發佈的 Auth0 動作,以查看事件流程。

確認整合

若要確認整合是否如預期運作:

  1. 登入 Auth0 儀表板。
  2. 瀏覽至 [監視]> [串流]
  3. 按一下您的 [事件方格串流]
  4. 在串流上,按一下 [健康情況] 索引標籤。串流應處於作用中狀態,且只要未出現任何錯誤,即表示串流正在運作中。

傳遞嘗試和重試

Auth0 事件會透過串流機制傳遞至 Azure。 每個事件在 Auth0 中受到觸發時即會傳送。 如果事件方格無法接收事件,Auth0 將重試最多三次,以傳遞事件。 若仍無法傳遞,Auth0 會在其系統中記錄傳遞失敗。

下一步