データマネージャー - 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 の対象分野のエキスパートに相談してください。

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

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

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

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

このジョブが実行されるたびに、選択したデータは、構成されたアダプタを使用してデータマネージャーに取り込まれ、生データになります。

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

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

名前 - 接続の名前。[アダプター] でジョブ名として表示されます。
オブジェクト - データをロードしたいオブジェクトクラスの名前。
データソース名 - 作成されるデータのタイプ。通常はツールの名前 (例: AD、Qualys) となります。注意: [名前] と同じ名前でも問題はありません。
データソースタイプ - ツールが提供するデータのタイプ。たとえば、アセット、CMDB、ユーザーの場所などです。Entra ID の既定の設定は、Azure Directory です。

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 に制限するのがベストプラクティスです。

認証と承認

Entra ID デバイスの標準的な手順を使用します。

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

API 呼び出し

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

取得したフィールド

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

Id
DeviceId
ExternalSourceName
OnPremisesLastSyncDateTime
DeletedDateTime
DeviceMetadata
IsCompliant
OnPremisesSyncEnabled
AccountEnabled
DeviceOwnership
IsManaged
OperatingSystem
ApproximateLastSignInDateTime
DeviceVersion
IsRooted
OperatingSystemVersion
ComplianceExpirationDateTime
DisplayName
ManagementType
ProfileType
ComplianceExpirationDateTime
DomainName    
Manufacturer
RegistrationDateTime
ComplianceExpirationDateTime
EnrollmentProfileName
MdmAppId
SourceType
DeviceCategory
EnrollmentType
Model
TrustType

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問

データ マネージャー - Entra ID デバイス アダプター