Azure Event Hubs へのデータ送信

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

前提条件

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

• Azure アカウント

• Postman アカウント

• Nexthink ライセンス

Azure ポータル内

リソースグループを作成

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

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

2. メインメニューから Resource groups を選択し、Create をクリックします。

1. 関連するサブスクリプションを選択し、リソースグループにユニークな名前を付けます。

2. Region group ドロップダウンから関連するリージョングループを選択し、Review + Create をクリックします。

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

Event Hubs 名前空間の作成

Event Hub を作成する前に、システムは Event Hubs 名前空間を必要とします。

1. Azure ポータルで、All services を選択します。

2. Event Hubs を検索フィールドに入力します。&#x20

3. Event Hubs をホバーして、星をクリックして Favorites リストに追加します。

1. Favorites タブの下で、Event Hubs を選択し、Create をクリックします。

1. 検索フィールドのドロップダウンメニューから、関連する Subscription と Resource group を選択します。

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

• Deployment ページで、Go to resource を選択して、名前空間のページに移動します。

• 以下の例のような Event Hubs Namespace ページが表示されていることを確認します。

Event Hub の作成

1. Event Hubs ページで、Overview > + Event Hub を選択します。

1. Event Hub に名前を入力し、Review + create をクリックします。&#x20

1. Event Hub の情報を確認して、Create をクリックします。

1. Entities タブの下で、Event Hubs を選択して、Event Hubs の一覧を確認します。

Microsoft Entra ID でのアプリケーションの登録

Azure を認証するために、Microsoft Entra ID (旧称 Azure AD) を使用してアプリケーションを登録します。&#x20

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

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

3. メインメニューから App registrations を選択します。

4. + New registration をクリックします。

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

1. Overview ページで、Application (client) ID と Directory (tenant) ID をコピーします。 これらの値を使用して Microsoft Entra ID からトークンを取得します。&#x20

1. メインメニューで Certificates & secrets を選択し、+ New client secret をクリックします。

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

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

3. Add をクリックします。

1. Client secrets タブで、Value と Secret ID フィールドの横のコピーアイコンをクリックして、Microsoft Entra ID からトークンを取得します。&#x20

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

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

1. Access control (IAM) を選択し、Add role assignment をクリックします。

1. Azure Event Hubs Data Sender をロールに選択し、Members の下にアプリケーションを選択します。&#x20

2. Review + assign をクリックします。

Postman で

Postman を使用して Microsoft Entra トークンを取得します。 次のいずれかを使用して webhook リクエストを認証します。

• bearer token

• OAuth 2.0

bearer token

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

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

1. Headers タブの下で、Content-Type キー application/x-www-form-urlencoded を値として追加します。

2. Body タブで form-data を選択し、以下のキー値ペアを追加します。

   • grant_type: client_credentials

   • client_id: 先ほどのクライアントIDを貼り付けます。

   • client_secret: クライアントシークレットを貼り付けます。

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

3. Send をクリックしてトークンを保存します。 これには 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> を Event Hubs 名前空間名で置き換えます。&#x20

   • &#x20<QUEUE NAME> をキューの名前に置き換えます—キュー名は Event Hub 名になります。

4. Body タブで raw をデータタイプに選択し、リクエストで送信したいメッセージを追加します。

1. Send を選択します。 これには 201 ステータスコードが返ります。画像に示されるように。

メッセージは Event Hubs Namespace ページに投稿されています。

Nexthink で

webhook 認証情報を作成

Nexthink web インターフェースから:

1. メインメニューで Administration > Connector Credentials に移動します。

2. New Credential をクリックし、以下の詳細を記入します。

   • Name: webhook の名前。

   • Description: webhook によって実行されるアクションの意味のある説明。

   • Protocol: Hypertext Transfer Protocol Secure (HTTPS) を選択します。 コネクタの HTTPS 認証情報セクションのコネクタの認証情報ドキュメントを参照してください。

   • URL for HTTPS protocol

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

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

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

Nexthink での webhook の作成

Nexthink web インターフェースから:

1. Administration > Outbound Connectors > Webhooks に移動します。

2. New Webhook をクリックし、フォームを記入します。

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

   • NQL Condition: webhook をトリガーする条件を定義する NQL クエリを構成します。

   • Request Method: POST。

   • Resource: Event Hub の URL 形式: <EVENT HUB NAME>/messages

   • Payload: Event Hub に送信する JSON ペイロード。

3. Send Test をクリックして設定を検証します。

4. 設定が検証されたら、Save webhook をクリックします。