Skip to main content
AtlassianのJira APIトークンを設定して、Jinba FlowのワークフローからJiraのイシューとプロジェクト進捗を管理します。

​
前提条件

  • Jira Cloudサイトにアクセスできるatlassianアカウント
  • APIトークンの作成権限（すべてのAtlassianアカウントで利用可能）

​
Jira APIトークンの作成

「個人」APIトークンを作成してください。「組織」APIキーではありません。 この2つは 別物で、Jiraで使えるのは一方だけです：
  • ✅ 個人APIトークン — id.atlassian.com/manage-profile/security/api-tokens で作成。Jiraのデータにアクセスできます。
  • ❌ 組織APIキー — 管理コンソール（admin.atlassian.com/o/<org>/api-keys）で作成。 組織管理スコープ（manage:org, *:admin）しか持たず、Jira課題の作成・取得は一切できません。 どれだけスコープにチェックを入れても 401 Unauthorized になります。
  1. id.atlassian.com でAtlassianアカウントにサインイン
  2. セキュリティ → APIトークン に移動
  3. APIトークンを作成 をクリック
  4. ラベル（例: Jinba Flow）を入力して 作成 をクリック
  5. 生成されたトークンをコピー（一度しか表示されません）
直接リンク: https://id.atlassian.com/manage-profile/security/api-tokens
クラシックトークン（接頭辞 ATATT…）を推奨します — アカウントの全権限を持ち、 スコープ設定が不要です。スコープ付きトークン（ATCTT…）も動作し、api.atlassian.com ゲートウェイ経由で自動ルーティングされますが、必要なスコープを自分で付与する必要があります。 どちらの場合も base_url はサイトURL（https://your-domain.atlassian.net）のままにしてください。

​
Jinba Flowへの設定

  1. Jinba Flowのワークスペース設定を開く
  2. シークレット セクションに移動
  3. Jira を見つけて 追加 をクリック
  4. APIトークンを入力：
    • APIトークン: Atlassianからコピーしたトークン
  5. 保存 をクリック

​
Jiraステップの設定

各Jiraツールのステップには、シークレットに加えて以下の設定フィールドが必要です：
フィールド説明例
base_urlJiraサイトのURLhttps://your-domain.atlassian.net
emailAtlassianアカウントのメールアドレスyou@example.com
api_token保存したJiraシークレットを選択—

​
JiraサイトURLの確認方法

Jira CloudのベースURLは https://<your-domain>.atlassian.net の形式です。Jiraボードを表示している際のブラウザのアドレスバーで確認できます。

​
ユーザーのアカウントIDの確認方法

Jiraはユーザーを名前やメールアドレスではなくaccountIdで識別します。アカウントIDを確認するには：
  1. ユーザーのJiraプロフィールを開く
  2. URLにアカウントIDが表示されます: .../jira/people/<accountId>
または、JIRA_SEARCH_ISSUESやJiraのユーザー検索APIを使用してプログラムからアカウントIDを検索できます。