Azure Event Hubs へのデータ送信

このドキュメントは、Nexthink Webhooksを使用してAzure Event Hubsにデータを送信する方法の概要を説明します。

前提条件

開始する前に、以下のものを確認してください:

  • Azureアカウント

  • Postmanアカウント

  • Nexthinkのライセンス

Azure ポータル内

リソースグループを作成する

リソースグループは、Azureリソースの論理コンテナです。

  1. Azure ポータルにサインインします。

  2. メインメニューからリソース グループを選択し、作成をクリックします。

  1. 該当するサブスクリプションを選択し、リソースグループに対してユニークな名前を入力します。

  2. Region groupドロップダウンから該当する地域グループを選択し、レビュー + 作成をクリックします。

  1. 詳細を確認し、作成をクリックします。

イベントハブの名前空間を作成する

イベントハブを作成する前に、システムはイベントハブの名前空間を必要とします。

  1. Azureポータルですべてのサービスを選択します。

  2. 検索フィールドにイベントハブと入力します。

  3. Event Hubsにカーソルを合わせ、スターをクリックして、お気に入りリストにEvent Hubsを追加してください。

  1. FavoritesタブでEvent Hubsを選択し、作成をクリックします。

  1. 検索フィールドのドロップダウンメニューから、該当するサブスクリプションリソースグループを選択します。

  1. 名前空間がデプロイされた後、名前空間ページに移動します。

  • デプロイメントページで、リソースに移動を選択して名前空間のページに移動します。

  • 次のようなイベントハブの名前空間ページを確認してください:

イベントハブを作成する

  1. イベントハブのページで、概要 > + イベントハブを選択します。

  1. イベントハブの名前を入力し、レビュー + 作成をクリックします。

  1. イベントハブ情報をレビューし、作成をクリックします。

  1. エンティティタブで、Event Hubsを選択して、イベントハブの一覧を確認します。

アプリケーションをMicrosoft Entra IDで登録する

Azureに対して認証するには、Microsoft Entra ID(以前はAzure AD)を使用してアプリケーションを登録します。

  1. Azure ポータルにサインインします。

  2. 検索フィールドにMicrosoft Entra IDを入力して、ドロップダウンリストから選択します。

  3. メインメニューからアプリ登録を選択します。

  4. +新しい登録をクリックします。

  1. アプリケーションの名前を入力し、登録をクリックします。

  1. 概要ページで、アプリケーション(クライアント)IDディレクトリ(テナント)IDをコピーします。 これらの値を使用して、Microsoft Entra IDからトークンを取得します。

  1. メニューの証明書とシークレットを選択し、+ 新しいクライアントシークレットをクリックします。

  1. 説明フィールドに、クライアントシークレットの説明を追加します。

  2. Expiresドロップダウンからアプリケーションの有効期限を選択します。

  3. 追加をクリックします。

  1. クライアントシークレットタブで、ValueSecret IDフィールド横のコピーアイコンをクリックしてMicrosoft Entra IDからトークンを取得します。

アプリケーションをEvent Hubsデータ送信者に追加

アクセスを得るために、アプリケーションをAzure Event Hubs Data Senderロールに割り当てます。

  1. **アクセス制御(IAM)**を選択し、役割の割り当てを追加をクリックします。

  1. Azure Event Hubs Data Senderを役割として指定し、メンバーにアプリケーションを追加します。

  2. レビュー + 割り当てをクリックします。

Postman内で

Microsoft Entraトークンを取得するにはPostmanを使用します。 Webhookリクエストに対して認証を行うには次のいずれかを使用します:

  • Bearer token

  • OAuth 2.0

Bearer token

  1. Postmanにサインインして新しいリクエストを作成します。

  2. メソッドをGETに設定し、以下のURLを入力します: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token

  1. ヘッダタブで、キーContent-Typeの値をapplication/x-www-form-urlencodedとします。

  2. ボディタブで、フォームデータを選択し、次のキーと値のペアを追加します:

    • grant_type: client_credentials

    • client_id: 前述のクライアントIDをペーストします。

    • client_secret: クライアントシークレットをペーストします。

    • resource: https://eventhubs.azure.net

  3. 送信をクリックしてトークンを保存します。 これにより、200ステータスコードが返されます。

OAuth 2.0

  1. Postmanで新しいタブを開きます。

  2. メソッドをPOSTに選択します。

  3. 次の形式でURLを入力します:https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages. 置き換える:

    • <EVENT HUBS NAMESPACE NAME>をイベントハブの名前空間に置き換えてください。

    • <QUEUE NAME>をキューの名前に置き換えます—キュー名はイベントハブ名になります。

  4. ボディタブで、データ形式をrawに選択し、リクエストに送信するメッセージを追加します。

  1. 送信を選択します。 これは、画像に示されているように、201ステータスコードを返します。

メッセージはイベントハブの名前空間ページに投稿されます。

Nexthink内

Webhook認証情報を作成する

NexthinkのWebインターフェースから:

  1. メインメニューで管理 > コネクタ認証情報に移動します。

  2. 新しい認証情報をクリックし、次の詳細を入力します:

    • 名前: Webhookの名前。

    • 説明: Webhookが実行するアクションの意義的な説明。

    • プロトコル: **ハイパーテキストトランスファープロトコルセキュア(HTTPS)**を選択します。 詳細については、「コネクタ資格情報のHTTPS」セクションを「コネクタ資格情報」ドキュメントで参照してください。

    • HTTPSプロトコルのURL

      次の形式で、サードパーティツールのURLを入力します: https://<EVENT HUB NAMESPACE>.servicebus.windows.net/

    • 認証: ドロップダウンリストから認証タイプを選択します。

  1. 新しく作成した認証情報を保存し、Webhookの設定に戻ります。

NexthinkでWebhookを作成する

NexthinkのWebインターフェースから:

  1. 管理 > アウトバウンドコネクタ > Webhooksに進みます。

  2. 新しいWebhookをクリックし、フォームを完了します:

    • 名前: Webhookの名前を入力します。

    • NQL条件: Webhookをトリガーする条件を定義するNQLクエリを設定します。

    • リクエストメソッド: POST。

    • リソース: イベントハブのURLを次の形式で設定します: <EVENT HUB NAME>/messages

    • ペイロード: イベントハブに送信するJSONペイロード。

  3. 設定を検証するためにテスト送信をクリックします。

  4. 設定が検証されたら、Webhookの保存をクリックします。

Last updated

Was this helpful?