Postman と REST API を使用して Atlassian アカウントを一括で非アクティブ化する

関連コンテンツ

  • 関連コンテンツがありません

お困りですか?

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

コミュニティに質問


プラットフォームについて: Cloud のみ - この記事は クラウド プラットフォームのアトラシアン製品に適用されます。

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

この記事は、Atlassian アカウントを一括で無効化/非アクティブ化する必要があるときにいつでも使用できます。エンド ユーザーが非アクティブな Atlassian アカウントを持っている場合、そのユーザーはどの Atlassian Cloud サービスにもアクセスできません。非アクティブ化できるのは、組織が管理している Atlassian アカウントだけです。管理対象アカウントとは

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

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


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

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

オリジナル

集中型

サイト管理者または組織管理者である場合は、[ユーザー] は製品サイトで確認できます。[ユーザー]

ページが [ディレクトリ] タブに存在しない場合は、従来のユーザー管理 UI

エクスペリエンスを利用していることになります。

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

データを準備する

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

  2. [ユーザー] > [管理対象アカウント] の順に移動します。

  3. [メンバーをエクスポート] を選択します。

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

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

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

  7. 非アクティブ化を実行しているユーザーが削除されていることを確認します。

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

  9. 非アクティブ化するすべてのユーザーの Atlassian アカウントのリストを含む CSV ファイルを保存します。

Postman を設定する

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

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

  • 「Atlassian Cloud (Org API キー付き)」という名前の環境がセットアップ済みである

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 (Org API キー付き)」に設定します。

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

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

    cloudUrl

    default

    https://<yoursite>.atlassian.net

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

    orgApiKey (英語)

    シークレット

    admin.atlassian.com から

    管理 API を使用して組織を管理する

    organizationId (組織 ID)

    default

    <yourOrganizationId>

    組織 API トークンと同時に提供されます

    https://admin.atlassian.com/o/ で始まる関連 URL から取得できます。

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

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

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

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

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

  3. コレクション名を「Atlassian Cloud User Management (Org API キー)」に設定します。

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

  5. タイプ を「ベアラー トークン」に変更します 。

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

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

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

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


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

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

REST API 呼び出しを設定する

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

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

  3. リクエスト名を「Deactivate Atlassian account (Atlassian アカウントの非アクティブ化)」に設定します。

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

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

    https://api.atlassian.com/users/{{Atlassian ID}}/manage/lifecycle/disable

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

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

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

Runner を実行する 

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

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

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

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

  5. [Run order (実行順序)] の下で、REST API 呼び出しが 1 つ (「Deactivate Atlassian account (Atlassian アカウントの非アクティブ化)」) だけであることを確認します。

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

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

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

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

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

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

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

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

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

    3. Failed (0) (失敗)

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

  13. [管理対象アカウント] ページで、非アクティブ化されたユーザーの数が 1 人増えていることを確認します。

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

参考


最終更新日 2025 年 6 月 5 日

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

はい
いいえ
この記事についてのフィードバックを送信する

関連コンテンツ

  • 関連コンテンツがありません
Powered by Confluence and Scroll Viewport.