Jira Cloud の統合 - Amazon Quick
できること[開始する前に]Jira API トークンを作成するJira 統合をセットアップする認証を設定する使用可能なアクション統合の共有Jira 統合の管理

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Jira Cloud の統合

Amazon Quick を Jira Cloud インスタンスに接続して、問題、プロジェクト、その他の Jira オブジェクトを管理します。Amazon Quick 環境を離れることなく、Jira コンテンツを作成、更新、クエリできます。この統合には、Amazon Quick Pro 階層以上が必要です。

できること

Jira Cloud 統合を使用すると、Jira REST API を使用して Jira インスタンス内でアクションを実行できます。

アクションコネクタ

Jira REST API を使用して、Jira の問題、プロジェクト、およびその他のオブジェクトを作成、更新、クエリします。

注記

この統合は、アクションの実行のみをサポートします。これを使用してナレッジベースを作成したり、検索目的で Jira データにアクセスしたりすることはできません。

[開始する前に]

Jira 統合を設定するには、以下が必要です。

  • 適切なアクセス許可を持つ Jira Cloud インスタンス。

  • Jira ユーザーアカウントまたは API トークンの認証情報。

  • Amazon Quick Author 以上。

  • OAuth アプリケーションを設定するための管理アクセス (ユーザー認証用）。

Jira API トークンを作成する

API キー認証を使用するには、Atlassian アカウントに API トークンを作成します。

  1. Atlassian アカウント設定に移動し、セキュリティを選択します。

  2. Amazon Quick 統合用の新しい API トークンを作成します。

  3. 生成されたトークンをコピーして、Amazon Quick 統合設定で使用します。

  4. Jira Cloud インスタンスの URL とユーザーの E メールアドレスを書き留めます。Jira Cloud インスタンス URL は API コールの特別な値であり、 に移動することで確認できますhttps://your-domain.atlassian.net/_edge/tenant_info。

重要

Jira Cloud は、API トークンが取り消されたり、不適切に設定されている場合でも、HTTP 200 成功レスポンスを返すことがあります。詳細については、「JRACLOUD-82932」を参照してください。統合が正常に接続されたように見えるが、アクションが予期せず失敗する場合は、API トークンが有効で、取り消されていないことを確認します。

Jira 統合をセットアップする

Amazon Quick を Jira Cloud インスタンスに接続するには、次の手順に従います。

  1. Amazon Quick コンソールで、統合を選択します。

  2. 追加 (プラス「＋」ボタン) をクリックします。

  3. 統合の詳細を入力します。

    • 名前 - Jira 統合のわかりやすい名前を入力します。

    • 説明 (オプション) - この統合の目的を説明します。

  4. 接続タイプ (ユーザーまたはサービス認証) を選択します。

  5. 認証方法に基づいて接続設定を完了します。

    • ユーザー認証 (OAuth):

      • ベース URL - Jira Cloud インスタンス URL。これは、 の形式で指定する必要がありますhttps://api.atlassian.com/ex/jira/instanceid。instanceid は、 に移動することで見つけることができますhttps://your-domain.atlassian.net/_edge/tenant_info。

      • クライアント ID - Atlassian OAuth アプリクライアント ID。

      • クライアントシークレット - Atlassian OAuth アプリクライアントシークレット。

      • トークン URL - Atlassian OAuth トークンエンドポイント。

      • 認証 URL - Atlassian OAuth 認可エンドポイント。

      • リダイレクト URL - OAuth リダイレクト URI。

    • サービス認証 (API キー):

      • ベース URL - Jira Cloud インスタンス URL。

      • API キー - Jira API トークン。

      • E メール - Jira ユーザーアカウントに関連付けられた E メールアドレス。

  6. 作成して続行を選択します。

  7. 統合を共有するユーザーを選択します。

  8. [次へ] をクリックします。

認証を設定する

Jira Cloud 統合は、2 つの認証方法をサポートしています。組織に最適な方法を選択します。

ユーザー認証 (OAuth)

個々のユーザー ID でアクションを実行する場合は、OAuth を使用します。これらのフィールドを設定します。

  • ベース URL - Jira Cloud インスタンス URL。

  • クライアント ID - Atlassian OAuth アプリクライアント ID。

  • クライアントシークレット - Atlassian OAuth アプリクライアントシークレット。

  • トークン URL - Atlassian OAuth トークンエンドポイント。

  • 認証 URL - Atlassian OAuth 認可エンドポイント。

  • リダイレクト URL - OAuth リダイレクト URI。

必要な OAuth スコープ:

  • read:jira-user - ユーザー情報を読み取ります。

  • read:jira-work - 問題、プロジェクト、作業項目を読み取る。

  • write:jira-work - 問題と作業項目を作成および変更します。

  • manage:jira-project - プロジェクト設定を管理します。

  • manage:jira-configuration - Jira 設定を管理します。

  • manage:jira-webhook - ウェブフックを管理します。

  • read:sprint:jira-software - スプリント情報を読み取ります。

  • write:sprint:jira-software - スプリントを作成および変更します。

  • delete:sprint:jira-software - スプリントを削除します。

  • write:board-scope:jira-software - ボード設定を管理します。

サービス認証 (API キー)

service-to-service接続には API キー認証を使用します。これらのフィールドを設定します。

  • ベース URL - Jira Cloud インスタンス URL。

  • API キー - Jira API トークン。

  • E メール - Jira ユーザーアカウントに関連付けられた E メールアドレス。

注記

既知の Jira Cloud の動作により、取り消された API トークンや無効な API トークンでも、統合が正常に接続されているように見える場合があります。セットアップ後にアクションが予期せず失敗した場合、Atlassian アカウント設定で API トークンがまだ有効であることを確認します。

使用可能なアクション

Jira 統合を作成したら、次のアクションを使用して Jira Cloud とやり取りできます。

  • Jira の問題を作成、読み取り、更新、削除します。

  • 問題の移行とワークフローを管理します。

  • JQL (Jira クエリ言語) を使用したクエリの問題。

  • プロジェクト、コンポーネント、バージョンを管理します。

  • 問題にコメントと添付ファイルを追加します。

  • ユーザーの割り当てと監視を管理します。

  • プロジェクトにアクセスしてメタデータを発行します。

注記

使用できるアクションは、Jira Cloud インスタンスで設定されたアクセス許可と認証方法によって異なります。

統合の共有

Jira アクションコネクタは、組織内の他のユーザーと共有できます。

  1. 統合を作成したら、統合の共有を選択します。

  2. 統合を共有するユーザーまたはグループを選択します。

  3. 共有アクセスに適切なアクセス許可を設定します。

  4. 共有設定を確認します。

Jira 統合の管理

Jira 統合では、以下の管理タスクを実行できます。

  • 統合設定の編集 - 認証設定または Jira インスタンス設定を更新します。

  • 統合アクセスの共有 - 組織内の他のユーザーが統合を使用できるようにします。

  • 使用状況メトリクスのモニタリング - 統合アクティビティと API 使用状況メトリクスを表示します。

  • 使用可能なアクションの確認 - 使用可能な Jira アクションの完全なリストを参照してください。

  • 統合の削除 - 統合を削除し、関連する認証を取り消します。