データマネージャー - Entra ID ユーザーアダプタ

Assets Data Manager for Jira Service Management Cloud is a Premium and Enterprise only feature that is currently in Open Beta development. View and vote on our list of upcoming features.

If you find a bug or have questions, please reach out to Atlassian Support or the Atlassian Community.

はじめに

Entra ID ユーザーは Microsoft が開発したシステム管理用のツールです。

Entra ID ユーザー アダプターは API 接続によってデータをアセットデータマネージャーに取り込みます。

Entra ID ユーザーコネクターでは、テナント ID、クライアント ID、クライアントシークレットを取得するために、Azure Portal でアプリを登録する必要があります。サポートが必要な場合は、Microsoft Azure に関するエキスパートに相談してください。

このツールをアセットデータマネージャーに接続するにはどうすればいいですか?

このタスクを完了するには、データマネージャーアダプターの管理者権限が必要です。データマネージャーでの権限とロールの仕組みをご覧ください。

カスタムビルドのアダプターを使用して、このツールをアセットデータマネージャーに接続するには、次の手順に従います。

[名前]、[オブジェクトクラス]、[データソース名]、[データソースタイプ] など、[データマネージャーフィールド] セクションにリストされているすべての情報を収集します。
「Entra ID ユーザーフィールド」セクションにすべての情報を収集します。このためには、Entra ID ユーザーに関するエキスパート (SME) への相談が必要となる場合があります。
データマネージャー内:
1. ご利用のツールに合ったアダプターを選択して、新しいジョブを作成します。
2. すべての必須フィールドに適切な情報を設定します。
Entra ID 内のユーザー:
1. 認証と承認を適切に設定するには、以下の「認証と承認」セクションに記載されているすべての手順に従ってください。
2. 次の「API 呼び出し」セクションの情報を確認して、エンドポイントが利用可能であることを確認します。
3. 以下の「取得したフィールド」セクションの情報をご確認ください。
このジョブが実行されるたびに、選択したデータは、構成されたアダプタを使用してデータマネージャーに取り込まれ、生データになります。

データマネージャーフィールド

アセットデータマネージャーから取得した次の情報を指定する必要があります。

名前 - 接続の名前。[アダプター] でジョブ名として表示されます。
オブジェクトクラス - データをロードするオブジェクトクラスの名前。
データソース名 - 作成されるデータのタイプ。通常はツールの名前 (例: AD、Qualys) となります。注意: [名前] と同じ名前でも問題はありません。
データソースタイプ - データプラットフォームが提供するデータのタイプ。これは通常、ツールの名前 (例: SCCM、Intune、JSMAssets、Qualys) または領域 (例: 資産、CMDB) となります。

Entra ID ユーザーフィールド

Entra ID ユーザーから取得した次の情報を指定する必要があります。

テナント ID - 認証に使用する Entra ID テナントを識別する一意の識別子。
クライアント ID - Entra ID で Microsoft アプリを識別するための一意の識別子。
クライアントシークレット - トークンのリクエスト時に身元情報を証明するために使用するシークレット文字列。
API タイムアウト - API タイムアウトは、ソースから返されるフィールドの数を制限します。アダプターの API タイムアウトは、既定で 0 に設定されています。

タイムアウトが発生すると、応答にタイムアウトの詳細が記載された「500 エラー」のステータスコードが返されます。タイムアウトは通常、次の 2 つのうちのいずれかに起因します。

呼び出しに関連する Entra ID デバイスソースのデータが多すぎる場合
ネットワーク/サービスに問題がある場合。

API 制限 - "API 制限" フィールドを使用すると、データマネージャーによって消費されてバックエンドのステージングデータベースに転送されるリクエスト/データ (またはレコード) の量を設定できます。

アダプターの API 制限は既定で 0 に設定されています。これは制限がないことを意味します。ただし、接続先の Entra ID ソースに大量のデータが格納されている場合は、数値を 1000 に制限するのがベストプラクティスです。

認証と承認

Azure Portal でアプリを登録して、テナント ID、クライアント ID、アプリ ID を取得します。
クライアントシークレットを生成して、クライアントシークレット ID を取得します。
アプリの「概要」ページで、[管理] > [API 権限] > [権限を追加] の順に選択します。
利用可能な API のリストから Microsoft Graph を選択します。次に、「User.Read.All」という権限を追加して、管理者同意を与えます。
[アクセス許可の追加] を選択します。

API 呼び出し

Entra ID デバイスの API 呼び出しは User.Read.All です。

取得したフィールド

次のフィールドが取得されます。

id
BusinessPhones
DisplayName
GivenName
JobTitle
Mail
MobilePhone
OfficeLocation
PreferredLanguage
Surname
UserPrincipalName

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問

データ マネージャー - Entra ID ユーザー アダプタ