Postman を使用して REST API によって Jira Cloud にユーザーを作成する

お困りですか?

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

コミュニティに質問

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

要約

このガイドを参考に、Jira または Confluence Cloud のユーザーを効率的に一括で作成する方法を学んでください。

データを準備する

  1. テキスト エディターを使用して、作成するすべてのユーザーのメール アドレスを記載したテキスト ドキュメントを準備します。
    最初のサインイン後にパスワードをリセットするためのメールを受信できるよう、すべてのユーザーは (メールボックスを与えられた) 有効なメール アドレスを持っている必要があります。
  2. 最初の行に emailAddress というラベルのヘッダー行を記述します。
  3. 作成するユーザーのメール アドレスを記述し、CSV ファイルとして保存します。
  4. ユーザーの既定のメンバーシップ用に products というラベルの列を追加します。

ファイルの例

emailAddress,products
dgrechen@bancly.com,jira-software
khaulkham-fraben@bancly.com,jira-software
igunston2@bancly.com,jira-software
pmaynell3@bancly.com,jira-software

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. リクエスト名を「Create User in Atlassian Cloud (Atlassian Cloud へのユーザーの作成)」に設定します。

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

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

    {{cloudUrl}}/rest/api/2/user
  6. [Authorization (認証)] タブをクリックします。

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

  8. [Body (本文)] タブをクリックします。
  9. [raw (行)] をクリックします。

  10. コンテンツ タイプを [JSON] に変更します。次のブロックをペイロード領域に貼り付けます。

    {
      "emailAddress": "{{emailAddress}}",
      "products": [
            "{{products}}" ]
    }


    {{emailAddress}} と {{products}} が csv ヘッダーと一致することに注意してください (大文字と小文字は区別されます)。


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

Runner を実行する 

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

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

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

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

  5. [実行順序] の下で、REST API 呼び出しが 1 つ (「Create User in Atlassian Cloud (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 はイテレーションの数)

    3. Failed (0) (失敗)

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

  13. admin.atlassian.com をチェックして、ユーザー数が 1 人増えていることを確認します。ユーザーのアクセス権限を確認します。ユーザーは既定のアクセス権限を継承します。

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

参考

ユーザーとグループを アトラシアン ガード SCIM でプロビジョニングしている組織では、Atlassian Access ユーザー プロビジョニング REST API を使用してください。





最終更新日 2025 年 5 月 6 日

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

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