Microsoft Entra ID からアセットに情報をインポートする

Assets - Microsoft Entra ID Integration is an app that allows you to import data from Microsoft Entra ID (formerly Microsoft Azure AD) into Assets. It can be used to automatically map your data into Assets, making it easier to keep your information up to date.

Microsoft Entra ID インスタンスをアセットに接続し、次の手順でデータをインポートできます。

Microsoft Entra ID アプリをインストールする

Microsoft Entra ID のデータをアセットにインポートするには、まず Atlassian Marketplace からアセット - Microsoft Entra ID 統合アプリをダウンロードしてインストールする必要があります。

Microsoft Entra ID で権限を設定する

インポートを実行する前に、アプリの権限を設定する必要があります。そのためには、Microsoft Entra ID のインスタンスに移動する必要があります。

1. Microsoft Entra ID のインスタンスに移動します。

2. 左側のサイドバーから [Applications (アプリ)] を選択し、[App registrations (アプリの登録)] を選択します。

3. 画面の上部で、[New registration (新規登録)] を選択します。

4. [Name (名前)] に新しいアプリ登録の名前を入力します。

5. [Supported account types (サポートされているアカウント タイプ)] で、[Accounts in this organization only (この組織のアカウントのみ)] を選択します。

6. 下部の [Register (登録)] を選択して、新しいアプリ登録を作成します。

7. 新しいアプリ登録に関する詳細情報が表示されます。左側のサイドバーから API permissions (API 権限) を選択します。

8. [Add a permission (権限の追加)] を選択します。

9. よく使用される Microsoft API のリストから選択できる画面が表示されます。[Microsoft Graph] を選択します。

10. [What type of permissions does your application require? (アプリで必要な権限のタイプ)] で、[Application permissions (アプリ権限)] を選択します。

11. リストから権限を選択できる画面が表示されます。

    1. [User.Read.All] の権限を有効にします。

    2. [Application.Read.All] の権限を有効にします。

    3. [Group.Read.All] の権限を有効にします。

12. 画面の下部で、[Add permission (権限の追加)] を選択して、これらの新しい権限を追加します。

13. [Configured permissions (設定されている権限)] 画面に、追加したばかりの権限が表示されるようになります。[Application.Read.All] および [User.Read.All] 権限の [Status (ステータス)] 列に [Not granted for MSFT (MSFT に対しては付与しない)] と表示されていることに注目してください。

14. [Configured permissions (設定されている権限)] で、[Grant admin consent for MSFT (MSFT に対する管理者の同意を付与)] を選択し、[Yes (はい)] を選択してこれらの権限に対する同意を付与します。

15. [Status (ステータス)] 列で、すべての権限が [Granted for MSFT (MSFT に対して付与)] と表示されているはずです。

Microsoft Entra ID でシークレット キーを作成する

アプリの権限を設定したら、Microsoft Entra ID でシークレット キーを生成する必要があります。

1. Microsoft Entra ID のインスタンスに移動します。

2. 前のセクションで作成したアプリ登録を選択します。

3. 左側のサイドバーで、[Certificates and secrets (証明書とシークレット)] を選択し、[New client secret (新しいクライアント シークレット)] を選択します。

   1. [Description (説明)] に新しいクライアント シークレットの説明を入力します。

   2. [Expires (有効期限)] 列で、既定値の [Recommended: 180 days (6 months) (推奨: 180 日 (6 か月))] を選択します。

   3. 画面の下部で、[Add (追加)] を選択して、新しいシークレット キーを追加します。

   4. [Certificates and secrets (証明書とシークレット)] 画面に戻ります。[Client secrets (クライアント シークレット)] タブを選択します。

   5. [Value (値)] 列で、シークレット キーの値を安全な場所にコピーします。

4. 左側のサイドバーで、[Overview (概要)] を選択します。

   1. [Application (Client) ID (アプリ (クライアント) ID)] の値を安全な場所にコピーします。

   2. [Directory (Tenant) ID (ディレクトリ (テナント) ID)] の値を安全な場所にコピーします。

アセットでインポート構造を作成して設定する

まず、Microsoft Entra ID のデータをアセットのオブジェクト スキーマに接続する新しいインポート構造を作成します。次に、Entra ID の [Application (Client) ID (アプリ (クライアント) ID)]、[Directory (Tenant) ID (ディレクトリ (テナント) ID)]、および [Secret Key (シークレット キー)] の値をアセットのインポート構造にコピーします。

1. アセットに移動します。

2. Microsoft Entra ID からのデータを格納する新しいオブジェクト スキーマを作成するか、既存のスキーマにデータをインポートします。既存のデータとの混同を避けるため、このアプリは空のスキーマで使用することをお勧めします。オブジェクト スキーマの詳細をご確認ください。

3. Select your object schema, then select Schema settings.

4. [インポート] タブを選択してから、[インポートを作成] を選択します。

5. [Microsoft Entra ID] を選択します。

6. [インポート構造を定義] 画面で、[名前] と [説明] にインポートの名前と説明を入力します。

7. [インポートを作成] を選択して、新しいインポート構造を作成します。

8. 新しいインポートを選択します。

9. [...] を選択してから、[アプリを設定] を選択します。

10. アプリケーション (クライアント) ID、ディレクトリ (テナント) ID、シークレット キーを入力します。

11. [設定を保存] を選択します。

アセットでインポートを実行する

これでインポートを実行して、Microsoft Entra ID からプルした情報をアセットに取り込むことができます。

1. アセットに移動します。

2. Select your object schema, then select Schema settings.

3. [インポート] タブを選択してから、新しいインポートを選択します。

4. ... を選択してから、[データをインポート] を選択します。