# ワークフロー向けEntra IDの統合

Microsoft Graph APIをNexthinkプラットフォームと統合するには、2つの統合ポイントを確立する必要があります。 データモデルのユーザーテーブルにUPNを持ち込むために1つの統合ポイントが必要です。 APIの認証情報を処理するためにもう1つのインテグレーションポイントが必要です。

{% hint style="warning" %}
コネクタアクションの権限はこのページの範囲外であることに注意してください。

各コネクタアクションおよび必要な権限の詳細については、対応するAPIエンドポイントドキュメントを参照してください。
{% endhint %}

### Entra IDインテグレーション <a href="#entraidintegrationforworkflows-entraidintegration" id="entraidintegrationforworkflows-entraidintegration"></a>

ワークフローはEntra IDインテグレーションからUPN（Universal Principal Name）を利用します。 これは、NexthinkデータモデルにUPNを入力し、それを`user.ad.name`フィールドにマッピングするために必要です。 Nexthink コネクタを Entra ID に設定する詳細については、[Microsoft Azure Active Directory用コネクタ](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/inbound-connectors/connector-for-microsoft-entra-id-azure-ad)を参照してください。

このインテグレーションの結果、ユーザーUPNがNexthinkユーザーテーブルに入力されるべきです。 このユーザーUPNは、Graph APIコールを行う際にワークフローで利用されます。 以下のスクリーンショットは、Entra IDコネクタの設定例を提供し、適切に設定された場合、ユーザーテーブルがユーザー名で満たされることを示しています。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-fb6cd0d2b3f97aa48cad3ff3d4b85649a0b89482%2Fimage-20230920-160818%20(1).png?alt=media" alt=""><figcaption><p>認証情報設定例</p></figcaption></figure>

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-5a66af74f4b839a78a60570a459cdf0d59ecbc58%2Fimage-20230920-160905%20(1).png?alt=media" alt=""><figcaption><p>フィールドマッピング例</p></figcaption></figure>

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-ca7a6f58dd9e8671f7df8e47a2fc3135290a4bca%2Fimage-20230920-160628%20(1).png?alt=media" alt=""><figcaption><p>ユーザー名がユーザーテーブルに入力されます</p></figcaption></figure>

### Graph APIコネクタインテグレーション <a href="#entraidintegrationforworkflows-graphapiconnectorintegration" id="entraidintegrationforworkflows-graphapiconnectorintegration"></a>

APIコールを有効にするためには、コネクタ資格情報を設定することが重要です。 [コネクタ資格情報](https://docs.nexthink.com/platform/ja/configuring_nexthink/bringing-data-into-your-nexthink-instance/integrating-nexthink-with-third-party-tools/outbound-connectors/connector-credentials)に関する詳細情報は、ドキュメンテーションページを参照してください。 各サービス/API Thinkletには、記入が必要な認証情報のドロップダウンフィールドがあります。 ワークフローがライブラリからインストールまたはコピーされた際、このフィールドは各環境のローカル設定であるため空白になります。ライブラリには含まれません。 Entra IDアプリケーション登録のセットアップで、APIの読み取り/書き込み権限を追加することが重要です。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-ffce47127022c885bd0bcbe51f9306f1f0cc815f%2Fimage-20230920-161542%20(1).png?alt=media" alt=""><figcaption><p>認証情報の設定例</p></figcaption></figure>

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-602308b44819d47cc56187af61d118ca432b70e1%2Fimage-20230920-161407%20(1).png?alt=media" alt=""><figcaption><p>認証情報フィールドが維持されたThinklet</p></figcaption></figure>

EntraアプリケーションのApplication IDは、認証情報設定ではClient IDとして維持されます。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-ab70100ea4b853a4bedbcfc5c73a2273934b6273%2Fimage-20230920-162423%20(1).png?alt=media" alt=""><figcaption><p>EntraアプリケーションのApplication IDは、認証情報設定ではClient IDとして維持されます</p></figcaption></figure>

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-af337a25ceb81f447596aa5b1657c8c01037c45c%2Fimage-20230920-163149%20(1).png?alt=media" alt=""><figcaption><p>テナントIDはアクセス トークンURLの一部として使用されます</p></figcaption></figure>

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-d3b6a167c173e485ae0cc32fa0a8cdce3de0cf70%2Fimage%20(85).png?alt=media" alt=""><figcaption><p>クライアントシークレットは、アプリ登録、証明書＆シークレットからコピーする必要があります</p></figcaption></figure>
