Postman と REST API を使用して Atlassian Cloud からユーザーを削除する

お困りですか?

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

コミュニティに質問


Platform Notice: Cloud - This article applies to Atlassian products on the cloud platform.

このドキュメントはナレッジ ベースのリソースとしてのみ役立ちます。カスタマイズや開発に関するリクエストはアトラシアンのサポート対象外ですのでご注意ください。そのようなリクエストについては、開発者ネットワークまたはパートナー ネットワークをご案内します。

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

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

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

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

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



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

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

オリジナル

集中型

サイト管理者または組織管理者として、[ユーザー] は [Product site (製品サイト)] の下で確認できます。

組織管理者として、[ユーザー] は [ディレクトリ] タブで確認できます。

データを準備する

  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 を設定する

以下の場合は、このセクションを省略できます。

  • 「Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)」という名前のコレクションが設定済みである

  • 「Atlassian Cloud」という名前の環境が設定済みである

Postman の設定手順を確認するには、ここをクリックしてください。

Postman をダウンロードする

  1. https://www.postman.com/downloads/ から Postman をダウンロードします。

  2. Postman を実行します。

新しい環境を作成する

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

  2. [Environment (環境)] を選択します。

  3. 環境名を「Atlassian Cloud」に設定します。

  4. 以下の変数を設定します。

    変数タイプ初期値および現在値コメント

    cloudUrl

    default

    https://<yoursite>.atlassian.net

    yoursite をご利用のサブドメインに置き換えてください。例: acmecorp

    apiTokenEmailAddress

    default

    <youruser@yourdomain.com>

    アトラシアン管理者アカウントのメール

    apiToken

    シークレット

    https://id.atlassian.com/manage-profile/security/api-tokens から取得

    Atlassian アカウントの API トークンを管理する

    Postman の変数では大文字と小文字が区別されます。

  5. 右上の [Save (保存)] をクリックします。

新しいコレクションを作成する

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

  2. [Collection (コレクション)] を選択します。

  3. コレクション名を「Atlassian Cloud User Management (Atlassian Cloud ユーザー管理)」に設定します。

  4. [Authorization (認証)] タブをクリックします。
  5. [Type (タイプ)] を [Basic Auth (ベーシック認証)] に変更します。

  6. ユーザー名 として {{apiTokenEmailAddress}} を指定します 。Postman が変数の指定を認識したことを示すように、テキストがオレンジ色になります。 これは、変数名にカーソルを合わせることで確認できます。

  7. パスワードとして {{apiToken}} を指定します 。Postman が変数の指定を認識したことを示すように、テキストがオレンジ色になります。 これは、変数名にカーソルを合わせることで確認できます。

  8. [Tests (テスト)] タブをクリックします。

  9. 次の情報を入力します。

    pm.test("Request successful", function () {
        pm.expect(pm.response.code).to.be.oneOf([200,201,202,204]);
    });


    これにより、すべての REST API が正常に作成されていることを確認できます。

  10. 右上の [Save (保存)] をクリックします。

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 つ発生することが予想されます。

参考

以下は、現在アクティブな機能リクエストです。

ID-8172 - 課題情報を取得中... ステータス

自由に投票してください。アトラシアンがユーザーのニーズに基づいて新しい開発に優先順位を付ける上で役立ちます。 




最終更新日: 2024 年 10 月 28 日

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

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.