Azure Event Hubs へのデータ送信
このドキュメントは外部ソースを参照しています。
Nexthinkは、サードパーティのドキュメントや外部の更新による不整合の可能性に関して、その正確性を管理していません。
エラーや矛盾をNexthink サポートに報告してください。
このドキュメントは、Nexthink Webhooksを使用してAzure Event Hubsにデータを送信する方法の概要を説明します。
前提条件
開始する前に、以下のものを確認してください:
Azureアカウント
Postmanアカウント
Nexthinkのライセンス
Azure ポータル内
リソースグループを作成する
リソースグループは、Azureリソースの論理コンテナです。
Azure ポータルにサインインします。
メインメニューからリソース グループを選択し、作成をクリックします。

該当するサブスクリプションを選択し、リソースグループに対してユニークな名前を入力します。
Region groupドロップダウンから該当する地域グループを選択し、レビュー + 作成をクリックします。

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

イベントハブの名前空間を作成する
イベントハブを作成する前に、システムはイベントハブの名前空間を必要とします。
Azureポータルですべてのサービスを選択します。
検索フィールドにイベントハブと入力します。
Event Hubsにカーソルを合わせ、スターをクリックして、お気に入りリストにEvent Hubsを追加してください。

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

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

名前空間がデプロイされた後、名前空間ページに移動します。
デプロイメントページで、リソースに移動を選択して名前空間のページに移動します。
次のようなイベントハブの名前空間ページを確認してください:

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

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

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

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

アプリケーションをMicrosoft Entra IDで登録する
Azureに対して認証するには、Microsoft Entra ID(以前はAzure AD)を使用してアプリケーションを登録します。
Azure ポータルにサインインします。
検索フィールドにMicrosoft Entra IDを入力して、ドロップダウンリストから選択します。
メインメニューからアプリ登録を選択します。
+新しい登録をクリックします。

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

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

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

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

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

アプリケーションをEvent Hubsデータ送信者に追加
アクセスを得るために、アプリケーションをAzure Event Hubs Data Senderロールに割り当てます。
**アクセス制御(IAM)**を選択し、役割の割り当てを追加をクリックします。

Azure Event Hubs Data Senderを役割として指定し、メンバーにアプリケーションを追加します。
レビュー + 割り当てをクリックします。

Postman内で
Microsoft Entraトークンを取得するにはPostmanを使用します。 Webhookリクエストに対して認証を行うには次のいずれかを使用します:
Bearer token
OAuth 2.0
Bearer token
Postmanにサインインして新しいリクエストを作成します。
メソッドをGETに設定し、以下のURLを入力します:
https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token

ヘッダタブで、キー
Content-Type
の値をapplication/x-www-form-urlencoded
とします。ボディタブで、フォームデータを選択し、次のキーと値のペアを追加します:
grant_type
:client_credentials
client_id
: 前述のクライアントIDをペーストします。client_secret
: クライアントシークレットをペーストします。resource
:https://eventhubs.azure.net
送信をクリックしてトークンを保存します。 これにより、200ステータスコードが返されます。
OAuth 2.0
Postmanで新しいタブを開きます。
メソッドをPOSTに選択します。
次の形式でURLを入力します:
https://<EVENT HUBS NAMESPACE NAME>.servicebus.windows.net/<QUEUE NAME>/messages
. 置き換える:<EVENT HUBS NAMESPACE NAME>
をイベントハブの名前空間に置き換えてください。<QUEUE NAME>
をキューの名前に置き換えます—キュー名はイベントハブ名になります。
ボディタブで、データ形式をrawに選択し、リクエストに送信するメッセージを追加します。

送信を選択します。 これは、画像に示されているように、201ステータスコードを返します。
メッセージはイベントハブの名前空間ページに投稿されます。

Nexthink内
Webhook認証情報を作成する
NexthinkのWebインターフェースから:
メインメニューで管理 > コネクタ認証情報に移動します。
新しい認証情報をクリックし、次の詳細を入力します:
名前: Webhookの名前。
説明: Webhookが実行するアクションの意義的な説明。
プロトコル: **ハイパーテキストトランスファープロトコルセキュア(HTTPS)**を選択します。 詳細については、「コネクタ資格情報のHTTPS」セクションを「コネクタ資格情報」ドキュメントで参照してください。
HTTPSプロトコルのURL
次の形式で、サードパーティツールのURLを入力します:
https://<EVENT HUB NAMESPACE>.servicebus.windows.net/
認証: ドロップダウンリストから認証タイプを選択します。

新しく作成した認証情報を保存し、Webhookの設定に戻ります。
NexthinkでWebhookを作成する
NexthinkのWebインターフェースから:
管理 > アウトバウンドコネクタ > Webhooksに進みます。
新しいWebhookをクリックし、フォームを完了します:
名前: Webhookの名前を入力します。
NQL条件: Webhookをトリガーする条件を定義するNQLクエリを設定します。
リクエストメソッド: POST。
リソース: イベントハブのURLを次の形式で設定します:
<EVENT HUB NAME>/messages
ペイロード: イベントハブに送信するJSONペイロード。
設定を検証するためにテスト送信をクリックします。
設定が検証されたら、Webhookの保存をクリックします。
Last updated
Was this helpful?