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

この記事は、Atlassian Cloud からユーザーを一括削除する必要があるときはいつでも使用できます。たとえば、Atlassian Cloud へのユーザー移行をテストした後、再テストするために組織から多くのユーザーを削除する必要がある場合があります。また、会社の合併後、古いアカウントを削除する必要がある場合もあります。

この記事では、Jira がクラウド サイトで利用可能であることを前提としています。

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

この記事は、Atlassian Guard SCIM でプロビジョニングされたユーザーとグループを持つ組織には適用されません。これらのグループは次回のアップデート/同期後に再作成されるためです。SCIM を通じてプロビジョニングされたユーザーを変更するには、ID プロバイダー管理者にお問い合わせください。

組織のユーザー管理を確認する

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

データを準備する

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

2. このステップは、ご利用のユーザー管理エクスペリエンスによって異なります。
   - オリジナル: サイトの名前と URL を選び、そのサイトの [管理] を開いて [ユーザー] を選択します。
   - 一元管理: [ディレクトリ] > [ユーザー] の順に選択します。

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

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

   • サイト/組織内のすべてのユーザー – サイト/組織内にいるすべてのグループ全体のすべてのユーザーが含まれます。

   • 選択したグループのユーザーのみ – 選択したグループのユーザーのみが含まれます。

5. [すべてのユーザー] を選択すると、アクティブ、一時停止中、非アクティブのユーザーがすべて含まれます。

6. さらに以下のオプションを選択して、ダウンロードに含めるデータを追加します。これらのオプションはデータのフィルタリングに役立つ場合があります。

   • [グループ メンバーシップ] – ユーザーが所属しているグループを含みます。初期設定では、複数のグループはコンマ区切りのリストとしてフォーマットされます。

   • [製品アクセス] – ユーザーがアクセスできる製品と製品の各ロールが含まれます。

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

8. CSV ファイルをダウンロードする準備が整ったら、メールが届きます。しばらくしてもメールが届かない場合は、迷惑メール フォルダーをご確認ください。

9. メールを開いて [CSV ファイルをダウンロード] を選択します。ログインしていない場合は、ダウンロードを開始する前にログインする必要が生じる場合があります。

10. 表計算プログラムやテキスト エディターを使用して、組織管理者など、削除すべきでない行をすべて削除します。

11. 削除を実行するユーザーが削除されていることを確認します。

12. 「User id (ユーザー ID)」(Atlassian アカウント ID) 列がクリーンアップ中に削除されないことを確認します。

13. 削除するすべてのユーザーを含むリストになった CSV ファイルを保存します。

Postman を設定する

REST API 呼び出しを設定する

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

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

3. リクエスト名を「Delete User from Atlassian Cloud (Atlassian Cloud からのユーザーの削除)」に設定します。

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

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

   {{cloudUrl}}/rest/api/2/user?accountId={{User id}}

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

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

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

Runner を実行する 

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

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

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

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

5. [Run order (実行順序)] の下で、REST API 呼び出しが 1 つ (「Delete User from Atlassian Cloud (Atlassian Cloud からのユーザーの削除)」) だけであることを確認します。

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

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

8. 事前に準備した CSV ファイルの場所に移動して選択します。

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

   ユーザーの削除は破壊的かつ不可逆的なアクションです。すべてのユーザーを体系的に削除する前に、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 をチェックして、ユーザー数が 1 人減っていることを確認します。

14. [Iterations (イテレーション)] の数を CSV ファイルの行数に設定し、前の手順に従って Postman Runner を再実行します。すでに削除されたユーザーを削除することはできないため、エラーが 1 つ発生することが予想されます。

参考

• サイトからユーザーをエクスポートする
• Jira Cloud REST API - ユーザーの削除
• Postman - Collection Runner を使用する