# Azure Event Hubsへのデータ送信

{% hint style="warning" %}
このドキュメントは外部ソースを参照しています。

Nexthink は、外部のドキュメントや更新による不一致の正確性を制御しません。

エラーや不一致があれば、[Nexthink サポート](https://support.nexthink.com/)に報告してください。
{% endhint %}

この文書では、Nexthink Webhooks を使用して Azure Event Hubs にデータを送信する方法を説明します。

## 前提条件

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

* Azure アカウント
* Postman アカウント
* Nexthink ライセンス

## Azure ポータルにおいて

### リソースグループの作成

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

1. [Azure ポータル](https://portal.azure.com/)にサインインします。
2. メインメニューから **リソースグループ** を選択し、**作成** をクリックします。

<figure><img src="/files/wUOeBSkGnqTZJ6KwG9cK" alt=""><figcaption></figcaption></figure>

2. 関連するサブスクリプションを選択し、リソースグループの一意の名前を入力します。
3. **リージョングループ** ドロップダウンから関連するリージョングループを選択し、**レビュー+作成** をクリックします。

<figure><img src="/files/i7cVVprqVRWytFj0DLv8" alt=""><figcaption></figcaption></figure>

4. 詳細をレビューし、**作成** をクリックします。

<figure><img src="/files/Q12zGdZ3khzEkHIAOVcu" alt=""><figcaption></figcaption></figure>

### Event Hubs 名前空間の作成

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

1. Azure ポータルで、**すべてのサービス** を選択します。
2. 検索フィールドに **Event Hubs** と入力します。
3. **Event Hubs** の上にカーソルを置き、スターをクリックして **お気に入り** リストに追加します。

<figure><img src="/files/EucAHfrWyBrtOE9PhqUI" alt=""><figcaption></figcaption></figure>

4. **お気に入り** タブの下で **Event Hubs** を選択し、**作成** をクリックします。

<figure><img src="/files/DGT4Rz8Ho6R62Y3neDK6" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/hEcJ9rearq1S0gTXeRM3" alt=""><figcaption></figcaption></figure>

6. 名前空間が展開されたら、**名前空間ページ** へ移動します。

* **デプロイメント** ページで **リソースに移動** を選択し、名前空間向けのページに移動します。
* **Event Hubs 名前空間** ページが以下の例のように表示されることを確認します。

<figure><img src="/files/5sRN7kbVFgd5vwDM5Vmc" alt=""><figcaption></figcaption></figure>

### Event Hub を作成

1. Event Hubs ページで **概要** > **+ Event Hub** を選択します。

<figure><img src="/files/KqLkl1mAp8FpeDs4WDjS" alt=""><figcaption></figcaption></figure>

2. Event Hub の名前を入力し、**レビュー+作成** をクリックします。

<figure><img src="/files/sL4Kwfhdpz50P66b2QtP" alt=""><figcaption></figcaption></figure>

3. Event Hub の情報を確認し、**作成** をクリックします。

<figure><img src="/files/yHFWH72fBV78GCH8cJwX" alt=""><figcaption></figcaption></figure>

4. **エンティティ** タブで **Event Hubs** を選択し、Event Hubs のリストをレビューします。

<figure><img src="/files/T9YCuEkaVEcas3rHvkgu" alt=""><figcaption></figcaption></figure>

### アプリケーションを Microsoft Entra ID に登録

Azure を認証するため、Microsoft Entra ID（旧 Azure AD）を使用してアプリケーションを登録します。

1. [Azure ポータル](https://portal.azure.com/)にサインインします。
2. 検索フィールドに **Microsoft Entra ID** を入力し、ドロップダウンリストから選択します。
3. メインメニューから **アプリ登録** を選択します。
4. **+ 新しい登録** をクリックします。

<figure><img src="/files/wpJ9hiotJOlQ2Qs158R3" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/KxQ8zKxailYBFnx1Lfdx" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/uQxPomdfjI5adLMgXHSB" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/4jWDdT6MvhMhODRSOKh2" alt=""><figcaption></figcaption></figure>

8. **説明** フィールドにクライアントシークレットの説明を追加します。
9. **期限切れ** ドロップダウンからアプリケーションの有効期限を選択します。
10. **追加** をクリックします。

<figure><img src="/files/YfbcBLGirlTtqQzKnWJS" alt=""><figcaption></figcaption></figure>

11. **クライアントシークレット** タブの **値** および **シークレットID** フィールドの横にあるコピーアイコンをクリックして Microsoft Entra ID からトークンを取得します。

<figure><img src="/files/9zodqzYFVWej3ZRaFste" alt=""><figcaption></figcaption></figure>

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

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

1. **アクセス制御 (IAM)** を選択し、**ロールの追加** をクリックします。

<figure><img src="/files/DJloqWsAqwFERoy3X5mV" alt=""><figcaption></figcaption></figure>

2. **Azure Event Hubs Data Sender** をロールに選択し、メンバーの下のアプリケーションを選択します。
3. **レビュー+割り当て** をクリックします。

<figure><img src="/files/yV93OTT4WGGo0cW8S2pl" alt=""><figcaption></figcaption></figure>

## Postman において

Postman を使用して Microsoft Entra トークンを取得します。 ウェブフックリクエストを以下の方法で認証します:

* Bearer token
* OAuth 2.0

### Bearer token

1. Postman にサインインし、新しいリクエストを作成します。
2. メソッドを **GET** に設定し、次の URL を入力します:\
   `https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token`

<figure><img src="/files/Grk1Dsk2ules4l8zVMGD" alt=""><figcaption></figcaption></figure>

3. **ヘッダー** タブの下で、**Content-Type** キー `application/x-www-form-urlencoded` を値として追加します。
4. **ボディ** タブの下で **form-data** を選択し、次のキーと値のペアを追加します:
   * `grant_type`: `client_credentials`
   * `client_id`: 先にコピーしたクライアント ID を貼り付けます。
   * `client_secret`: クライアントシークレットを貼り付けます。
   * `resource`: `https://eventhubs.azure.net`
5. **送信** をクリックし、トークンを保存します。 これにより **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 名前空間の名前に置き換えます。
   * `<QUEUE NAME>` はキューの名前であり、キューの名前は Event Hub 名となります。
4. **ボディ** タブの下で **raw** をデータタイプとして選択し、リクエストで送信したいメッセージを追加します。

<figure><img src="/files/gmn850JgrBUl5lB7PnEs" alt=""><figcaption></figcaption></figure>

5. **送信** を選択します。 これにより **201** ステータスコードが返され、画像に示されています。

メッセージは **Event Hubs 名前空間** ページに投稿されます。

<figure><img src="/files/5brGo7pZx7QyOgrIinb8" alt=""><figcaption></figcaption></figure>

## Nexthink において

### ウェブフックのクレデンシャル作成

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

1. メインメニューの **管理>コネクタクレデンシャル** に進みます。
2. **新しいクレデンシャル** をクリックし、以下の詳細を入力します:
   * **名前:** ウェブフックの名前。
   * **説明:** ウェブフックによって実行されるアクションの有意な説明。
   * **プロトコル**: **セキュア ハイパーテキスト トランスファー プロトコル (HTTPS)** を選択します。 [HTTPS 用コネクタクレデンシャル](https://docs.nexthink.com/platform/ja/integrations/outbound-connectors/connector-credentials) のセクションを参照します。
   * **HTTPS プロトコル用 URL**

     サードパーティーツールの URL を次の形式で入力します: `https://<EVENT HUB NAMESPACE>.servicebus.windows.net/`
   * **認証:** ドロップダウン リストから認証タイプを選択します。

<figure><img src="/files/p8VY4cDxNpFjJ1Mu0iO3" alt=""><figcaption></figcaption></figure>

3. 作成した新しいクレデンシャルを保存し、ウェブフックを設定するために戻ります。

### Nexthink でウェブフックを作成

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

1. **管理>アウトバウンド コネクタ>ウェブフック** に進みます。
2. **新しいウェブフック** をクリックし、フォームを記入します:
   * **名前**: ウェブフックの名前を入力します。
   * **NQL 条件**: ウェブフックをトリガーする条件を定義する NQL クエリを構成します。
   * **リクエスト方法**: POST。
   * **リソース**: Event Hub の URL を次の形式で:\
     `<EVENT HUB NAME>/messages`
   * **ペイロード**: Event Hub に送信する JSON ペイロード。
3. 構成を検証するために **テストを送信** をクリックします。
4. 構成が検証されたら、**ウェブフックを保存** をクリックします。

###


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/webhooks/webhook-use-cases-setup/sending-data-to-azure-event-hubs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.