翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Atlassian Jira クラウド統合
Atlassian Jira Cloud アクションコネクタを使用して、自然言語で直接 Amazon Quick で Jira の問題、プロジェクト、スプリント、ユーザーを作成、更新、検索、管理します。
この統合をセットアップするには、2 つのステップが必要です。まず、Atlassian デベロッパーコンソールで OAuth 2.0 (3LO) アプリを作成し、そのアクセス許可を設定します。次に、Amazon Quick で統合を作成し、Atlassian アプリに接続します。Amazon Quick がサポートする認証方法の詳細については、「」を参照してください[認証方法](quick-action-auth.md)。
## [開始する前に]
統合を設定する前に、以下があることを確認してください。
+ Atlassian Jira Cloud。
+ [Atlassian デベロッパーコンソール](https://developer.atlassian.com/console/myapps/)にアクセスして、OAuth アプリを作成または管理します。
+ サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。
## Atlassian デベロッパーコンソールを設定する
ユーザー認証 (3LO) を使用する場合は、Amazon Quick を設定する前に、Atlassian デベロッパーコンソールで OAuth 2.0 アプリを作成します。Amazon Quick コンソールに移動する前に、以下のすべてのステップを完了します。
サービス認証 (API キー) のみを使用する場合は、このセクションをスキップして に進むことができます[Amazon Quick で統合を設定する](#jira-integration-setup)。
OAuth 2.0 (3LO) アプリケーションの詳細については、Atlassian デベロッパードキュメントの[OAuth 2.0 (3LO) アプリケーション](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/)」を参照してください。
### OAuth 2.0 (3LO) アプリを作成する
Amazon Quick は、Atlassian OAuth 2.0 (3LO) アプリを使用して、ユーザーに代わって Atlassian Cloud 製品で認証します。Amazon Quick を設定する前に、Atlassian デベロッパーコンソールでこのアプリを作成します。
1. [Atlassian デベロッパーコンソール](https://developer.atlassian.com/console/myapps/)を開き、Atlassian アカウントでサインインします。
1. **Create** を選択し、**OAuth 2.0 統合**を選択します。
1. **名前**には、 など、統合のわかりやすい名前を入力します`your-app-name connector`。
1. Atlassian デベロッパー規約を確認して同意します。
1. **[作成]** を選択します。
### アクセス許可の設定
OAuth 2.0 アプリを作成したら、Amazon Quick が Atlassian 製品とやり取りするために必要な API アクセス許可を追加します。
1. Atlassian デベロッパーコンソールのアプリから、左側のナビゲーションで**アクセス許可**を選択します。
1. Atlassian 製品の API (**Jira API** や **Confluence API** など) を検索し、**追加**を選択します。API が追加されると、ボタンが **Configure** に変わります。
1. [**設定**] を選択します。スコープページが開き、**クラシックスコープ**と**粒度スコープタブが表示されます**。
1. **Classic scopes** タブで、**Edit Scopes** を選択します。必要なクラシックスコープを選択し、**保存**を選択します。
1. **きめ細かなスコープ**タブを選択し、**スコープの編集**を選択します。必要なきめ細かなスコープを選択し、**保存**を選択します。
統合に必要な特定のスコープについては、以下のスコープセクションを参照してください。
### API アクセス許可を設定する
Jira Cloud アクション統合の OAuth 2.0 アプリに次のスコープを追加します。
**クラシックスコープ**
**Classic scopes** タブで、**Edit Scopes** を選択し、次のスコープを選択します。
**Jira アクション統合 – クラシックスコープ**
| スコープ | 説明 |
| --- | --- |
| read:jira-work | Jira プロジェクトと問題データの読み取り、問題の検索、添付ファイルや作業ログなどの問題に関連するオブジェクトの検索を行います。 |
| manage:jira-project | プロジェクト設定を作成および編集し、新しいプロジェクトレベルのオブジェクト (バージョンやコンポーネントなど) を作成します。 |
| manage:jira-configuration | Jira 管理アクションを実行する (プロジェクトとカスタムフィールドの作成、ワークフローの表示、問題リンクタイプの管理など）。 |
| read:jira-user | ユーザー名、E メールアドレス、アバターなど、ユーザーがアクセスできる Jira のユーザー情報を表示します。 |
| write:jira-work | Jira で問題を作成および編集し、ユーザーとしてコメントを投稿し、作業ログを作成し、問題を削除します。 |
| manage:jira-webhook | 動的に宣言された Jira ウェブフックを取得、登録、更新、削除します。 |
**きめ細かなスコープ**
**きめ細かなスコープ**タブを選択し、**スコープの編集**を選択します。検索バーを使用して、以下のスコープを見つけます。たとえば、 を検索`sprint:jira-software`してスプリント関連のスコープを検索します。
**Jira アクション統合 – きめ細かなスコープ**
| スコープ | 説明 |
| --- | --- |
| read:board-scope:jira-software | 読み取りボードの設定。 |
| read:sprint:jira-software | スプリント情報を読み取ります。 |
| write:sprint:jira-software | スプリントを作成および変更します。 |
| delete:sprint:jira-software | スプリントを削除します。 |
| write:board-scope:jira-software | ボード設定を管理します。 |
| read:project:jira | プロジェクトの詳細を読み取ります。 |
### 認可を設定
Atlassian がアプリを承認した後にユーザーを Amazon Quick にリダイレクトできるように、コールバック URL を設定します。
1. Atlassian デベロッパーコンソールのアプリから、左側のナビゲーションで**認可**を選択します。
1. **OAuth 2.0 (3LO) **の横にある**「追加**」を選択します。
1. **コールバック URLs**、 と入力します`https://region.quicksight.aws.amazon.com/sn/oauthcallback`。*region* を、Amazon Quick インスタンスがデプロイされている AWS リージョンに置き換えます。例: `us-east-1`。
1. **[Save changes]** (変更の保存) をクリックします。
### 認証情報を記録する
Atlassian デベロッパーコンソールを離れる前に、次の値があることを確認してください。Amazon Quick 設定にはこれらが必要です。
1. Atlassian デベロッパーコンソールのアプリから、左側のナビゲーションで**設定**を選択します。
1. **認証の詳細**で、**クライアント ID** と**シークレット**値をコピーします。
**Atlassian デベロッパーコンソールから必要な認証情報**
| 値 | 検索先 |
| --- | --- |
| クライアント ID | 設定ページ、認証の詳細の下 |
| シークレット | 設定ページ、認証の詳細の下 |
## Amazon Quick で統合を設定する
認証情報を準備したら、Amazon Quick で統合を作成します。
1. Amazon Quick コンソールで、**統合**を選択します。
1. **[Actions]** タブを選択します。
1. **「アクションの新しいアプリ統合を設定する**」で、**Atlassian Jira Cloud** を検索し、追加 (プラス「＋」) ボタンを選択します。
1. **統合の作成**ウィザードで、次のフィールドに入力します。
+ **名前** – Jira 統合の説明名。
+ **説明** (オプション) – この接続の使用方法に関する注意事項。
+ **接続タイプ** – **パブリックネットワーク**を選択します。
1. **認証設定**で、認証方法を選択し、必須フィールドを入力します。
1. **ユーザー認証**では、次のフィールドを設定します。
+ **ベース URL** – API コールの Jira インスタンス URL。これは、ユーザーがログインする URL とは異なります。これは、 のようになります`https://api.atlassian.com/ex/jira/yourInstanceId`。インスタンス ID を検索するには、 に移動します`https://your-domain.atlassian.net/_edge/tenant_info`。
+ **クライアント ID** – Atlassian OAuth アプリの設定ページからのクライアント ID。
+ **クライアントシー**クレット – Atlassian OAuth アプリの設定ページからのシークレット。
+ **トークン URL** – `https://auth.atlassian.com/oauth/token`
+ **認可 URL** – `https://auth.atlassian.com/authorize`
+ **リダイレクト URL** – このフィールドには、Amazon Quick コールバック URL があらかじめ入力されています。
1. **サービス認証**では、次のフィールドを設定します。
+ **API キー** – Jira API トークン。
+ **ベース URL** – API コールの Jira インスタンス URL。
+ **E メール** – 関連付けられたユーザーアカウント E メール。
1. [**作成して続ける]** を選択します。
1. (オプション) **統合の共有**ページで、統合を共有するユーザーを選択します。
**重要**
Jira Cloud は、API トークンが取り消されたり、不適切に設定されている場合でも、HTTP 200 成功レスポンスを返すことがあります。詳細については、「[JRACLOUD-82932](https://jira.atlassian.com/browse/JRACLOUD-82932)」を参照してください。統合が正常に接続されたように見えるが、アクションが予期せず失敗する場合は、API トークンが有効で、取り消されていないことを確認します。
## 使用可能なアクション
統合を設定すると、次のアクションを使用できます。
**Jira Cloud で使用可能なアクション**
| アクション | 説明 |
| --- | --- |
| 添付ファイルの追加 | 問題に添付ファイルを追加します。 |
| コメントの追加 | 新しいコメントを追加します。 |
| 問題ステータスの変更 | 問題のタスクステータスを変更します。 |
| 問題の作成 | 新しい問題またはサブタスクを作成します。 |
| プロジェクトを作成する | 新しいプロジェクトを作成します。 |
| スプリントの作成 | プロジェクトにスプリントを作成します。 |
| コメントの削除 | コメントを削除します。 |
| 問題の削除 | プロジェクトの問題を削除します。 |
| プロジェクトの削除 | プロジェクトを削除します。 |
| スプリントの削除 | プロジェクトのスプリントを削除します。 |
| 問題の編集 | 問題を変更します。 |
| ユーザーの検索 | Jira ユーザーを検索します。 |
| すべてのラベルを取得する | すべてのラベルを表示します。 |
| すべてのユーザーを取得する | すべての Jira ユーザーを一覧表示します。 |
| 添付ファイルコンテンツの取得 | 添付ファイルの内容を表示します。 |
| コメントの取得 | 問題コメントを表示します。 |
| 問題を取得する | プロジェクトの問題の詳細を表示します。 |
| プロジェクトの問題タイプを取得する | プロジェクトの問題タイプを表示します。 |
| 優先度の取得 | 問題の優先順位を表示します。 |
| プロジェクトの取得 | プロジェクトの詳細を表示します。 |
| スプリントの取得 | プロジェクト内のスプリントの詳細を表示します。 |
| 問題をバックログに移動する | 問題をバックログに移動します。 |
| スプリントとランクに問題を移動する | 問題をスプリントに割り当てます。 |
| 検索の問題 | 問題を検索します。 |
| プロジェクトの検索 | 表示されるプロジェクトを検索します。 |
| 検索ステータス | 問題のステータスを検索します。 |
| コメントの更新 | コメントを編集します。 |
| プロジェクトの更新 | プロジェクトを変更します。 |
| スプリントの更新 | スプリントの詳細を更新します。 |
**注記**
使用できるアクションは、Jira Cloud インスタンスで設定されたアクセス許可と認証方法によって異なります。
## の管理とトラブルシューティング
統合を編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。
### 認証問題
+ **アプリ設定が正しく**ない – Atlassian デベロッパーコンソールの OAuth アプリに必要なスコープが含まれ、リダイレクト URI が Amazon Quick 設定と一致することを確認します。
+ **有効期限切れまたは取り消された API トークン** – サービス認証を使用する場合は、API トークンの有効期限が切れていないか、取り消されていないことを確認します。既知の Jira Cloud 動作 ([JRACLOUD-82932](https://jira.atlassian.com/browse/JRACLOUD-82932)) により、無効なトークンでも統合が正常に接続されたように見える場合があります。
+ **不正なベース URL** – API コールのベース URL が Jira Cloud ログイン URL と同じではありません。API URL 形式 を使用していることを確認します`https://api.atlassian.com/ex/jira/yourInstanceId`。インスタンス ID を検索するには、 に移動します`https://your-domain.atlassian.net/_edge/tenant_info`。
### 一般的なエラーメッセージ
+ **`Access denied. You do not have permission to perform this action`** – 認証されたユーザーには、Jira Cloud に必要なアクセス許可がありません。Jira Cloud 管理者に連絡して、適切なアクセス許可を確認して付与してください。
+ **`OAuth 2.0 authorization failed`** – Atlassian デベロッパーコンソールと Amazon Quick の両方でクライアント ID、クライアントシークレット、OAuth スコープが正しく設定されていることを確認します。