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

アセット - Microsoft Entra ID 統合は、Microsoft Entra ID (旧 Microsoft Azure AD) から Jira Service Management のアセットにデータをインポートできるアプリです。このアプリを使用すると、データをアセットに自動的にマッピングして、情報を最新の状態に保つのが簡単になります。

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

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

Before you can import data Microsoft Entra ID into Assets, you must download and install the Assets - Microsoft Entra ID Integration app from the Atlassian Marketplace.

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. You are now viewing detailed information about your new app registration. Select API permissions from the left sidebar.

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. Navigate to Assets.

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

3. オブジェクト スキーマを選択してから、[スキーマ設定] を選択します。

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

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

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

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

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

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

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

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

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

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

1. Navigate to Assets.

2. オブジェクト スキーマを選択してから、[スキーマ設定] を選択します。

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

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