この記事を使用すべきタイミング

この記事は、Atlassian Cloud でグループ メンバーシップを一括で更新/追加する必要がある際に役立ちます。この記事ではメンバーシップの更新方法に関する概要をご説明します。なお、Jira プロジェクトのグループの使用状況、Jira 権限スキーム、Confluence スペース権限、または Confluence ページの制限は更新されません。

この記事を使用すべきでないタイミング

この記事は、アトラシアン ガード SCIM でプロビジョニングされたユーザーとグループを持つ組織には適用されません。SCIM を通じてプロビジョニングされたグループのメンバーシップを変更するには、ID プロバイダー管理者にお問い合わせください。

組織のユーザー管理 UI エクスペリエンスを識別する

1. admin.atlassian.com にアクセスします。 複数の組織がある場合は、対象の組織を選択します。

データを準備する

ユーザーとグループ メンバーシップをエクスポートする

1. このステップは、ご利用のユーザー管理エクスペリエンスによって異なります。
   - オリジナル: [ユーザーをエクスポート] を選択します。
   - 一元管理: 画面の上部にある [ユーザーをエクスポート] を選択します。
2. 必要に応じて、[ユーザー] と [ユーザー ステータス] のオプションを選択します。

3. 必要なデータをダウンロードに含めるため、[追加データ] のオプションを選択します。

   • グループ メンバーシップ - ユーザーが所属しているグループを含めます。

   • 列にピボット - グループ データを展開して、各グループ メンバーシップの行を生成します。
     

4. [ユーザーをエクスポート] を選択します。

5. CSV ファイルをダウンロードする準備が整ったら、メールが届きます。メールの受信に予想よりも時間がかかっている場合は、迷惑メール フォルダーをご確認ください。

6. メールを開いて [CSV ファイルをダウンロード] を選択します。

7. ファイルの名前を groups.csv に変更します。
8. "Group id" (A 列) の列見出しを groupId に変更します (大文字小文字を区別します)
9. "User id" (C 列) の列見出しを accountId に変更します (大文字小文字を区別します)
10. 保持するグループ メンバーシップに対応する行を削除します。CSV にマッピングされているグループ メンバーシップはすべて削除されます。つまり、最終的な CSV にリストされているグループ メンバーシップが削除されるメンバーシップになります。

11. CSV ファイルを保存します。

サンプル ファイル - groups.csv

メモ:

• groupId と accountId の列見出しは以下の例とまったく同じであることが重要です。これは、Postman がこれらの列を繰り返し処理して、CSV にリストされているユーザーのグループ メンバーシップを削除するためです。
• 厳密に言うと、必要なのは A 列と C 列だけで、その他の列は不要です。CSV には、この例に示されているよりも多くの列が含まれている可能性があります。列の数はサイト/組織に存在する製品の数に対応しており、CSV 内の列の数は Postman が行う API 呼び出しには影響しません
• この例では、6 人のユーザーがエンジニアリング グループから削除されます。つまり、6 人のユーザーのエンジニアリング グループのグループ メンバーシップが取り消されます
• ユーザー "syncpolicytestuser3@domain.example" は 3 つのグループから削除されます
• ユーザーのアカウントはサイト/組織に残ります。グループ メンバーシップのみが削除されます

Postman を設定する

REST API 呼び出しを設定する

1. [New (新規)] をクリックするか、Ctrl + N キー (Windows/Linux) または Cmd + N キー (macOS) を押します。

2. [HTTP] を選択します。

3. リクエストに「Atlassian Cloud のグループからユーザーを削除」という名前をつけます。

4. メソッドを GET から DELETE に変更します。

5. URL に以下を貼り付けます。

   {{cloudUrl}}/rest/api/latest/group/user?groupId={{groupId}}&accountId={{accountId}}

   Postman の変数は大文字と小文字が区別され、指定の環境とスプレッドシートで提供されているものと一致している必要があることに注意してください。

6. [Authorization (認証)] タブをクリックします。

7. [Type (タイプ)] が [Inherit auth from parent (親から認証を継承)] であることを確認します。

8. [Save (保存)] をクリックして、[Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)] コレクションに保存します。

Postman Runner を実行する 

1. Postman の右上にある環境セレクターで [Atlassian Cloud] を選択し、環境を変更します。

2. サイドバーの [Collections (コレクション)] を選択します。

3. [Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)] コレクションを選択します。

4. [Overview (概要)] タブで、右上の実行ボタン ▶️ を選択します。

5. [実行順序] で、REST API 呼び出しが 1 つ（「Atlassian Cloud のグループからユーザーを削除」）だけ選択されていることを確認します。

6. [Functional (機能)] タブで、[Run manually (手動で実行)] を選択します。

7. [Data (データ)] をクリックします。

8. 「データをマッピングする」で準備した CSV ファイルの場所に移動して選択します。

9. [Run configuration (実行設定)] の [Iterations (イテレーション)] の数を 1 に減らします。

10. [Advanced settings (詳細設定)] はそのまま残します。

11. [Run Atlassian Cloud User Management (Atlassian Cloud ユーザー管理の実行)] をクリックします。

12. Postman をチェックして、ランナー コレクションがすべてのテストに合格していることを確認します。実行結果は次のように表示されるはずです。

    1. [Iterations (イテレーション)] と [All tests (すべてのテスト)] の回数が同じ

    2. Passed (n) (成功) (n は [Iterations (イテレーション)] の数)

    3. Failed (0) (失敗)

    4. Skipped (0) (スキップ)

13. admin.atlassian.com をチェックして、エクスポートしたリストの行 2 のユーザーが想定したグループのメンバーになっていることを確認します。

14. [Iterations (イテレーション)] の数を CSV ファイルの行数に設定し、前の手順に従って Postman Runner を再実行します。

参考

• サイトからユーザーをエクスポートする
• Microsoft - テキスト (.txt または .csv) ファイルをインポートまたはエクスポートする
• Jira Cloud REST API - グループからユーザーを削除する
• Postman - Collection Runner を使用する