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

# Atlassian Confluence Cloud アクション統合
<a name="confluence-action-integration"></a>

Atlassian Confluence Cloud アクションコネクタを使用して、自然言語を通じて Amazon Quick で Confluence のページとスペースを直接作成、更新、管理します。

この統合を設定するには、まず Atlassian デベロッパーコンソールで OAuth 2.0 (3LO) アプリを作成し、そのアクセス許可を設定します。次に、Amazon Quick で統合を作成し、Atlassian アプリに接続します。Amazon Quick がサポートする認証方法の詳細については、「」を参照してください[認証方法](quick-action-auth.md)。

## [開始する前に]
<a name="confluence-action-prerequisites"></a>

統合を設定する前に、以下があることを確認してください。
+ Atlassian Confluence Cloud。
+ [Atlassian デベロッパーコンソール](https://developer.atlassian.com/console/myapps/)にアクセスして、OAuth アプリを作成または管理します。
+ サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

## Atlassian デベロッパーコンソールを設定する
<a name="confluence-action-atlassian-setup"></a>

ユーザー認証 (3LO) を使用する場合は、Amazon Quick を設定する前に、Atlassian デベロッパーコンソールで OAuth 2.0 アプリを作成します。Amazon Quick コンソールに移動する前に、以下のすべてのステップを完了します。

サービス認証 (API キー) のみを使用する場合は、このセクションをスキップして に進むことができます[認証を準備する](#confluence-action-auth-setup)。

OAuth 2.0 (3LO) アプリケーションの詳細については、Atlassian デベロッパードキュメントの[OAuth 2.0 (3LO) アプリケーション](https://developer.atlassian.com/cloud/confluence/oauth-2-3lo-apps/)」を参照してください。

### OAuth 2.0 (3LO) アプリを作成する
<a name="atlassian-oauth-app"></a>

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. **[作成]** を選択します。

### アクセス許可の設定
<a name="atlassian-oauth-permissions"></a>

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. **きめ細かなスコープ**タブを選択し、**スコープの編集**を選択します。必要なきめ細かなスコープを選択し、**保存**を選択します。

統合に必要な特定のスコープについては、以下のスコープセクションを参照してください。

### Confluence に必要なスコープ
<a name="confluence-action-oauth-scopes"></a>

Confluence Cloud アクション統合の OAuth 2.0 アプリに次のスコープを追加します。

**クラシックスコープ**

**Classic scopes** タブで、**Edit Scopes** を選択し、次のスコープを選択します。


**Confluence アクション統合 – クラシックスコープ**  

| スコープ | 説明 | 
| --- | --- | 
| search:confluence | Confluence のコンテンツとスペースの概要を検索します。 | 

**きめ細かなスコープ**

**きめ細かなスコープ**タブを選択し、**スコープの編集**を選択します。次のスコープを選択します。


**Confluence アクション統合 – きめ細かなスコープ**  

| スコープ | 説明 | 
| --- | --- | 
| read:page:confluence | ページの内容を表示します。 | 
| write:page:confluence | ページを作成および更新します。 | 
| read:space:confluence | スペース情報にアクセスします。 | 

### 認可を設定
<a name="atlassian-oauth-authorization"></a>

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]** (変更の保存) をクリックします。

### 認証情報を記録する
<a name="atlassian-oauth-credentials"></a>

Atlassian デベロッパーコンソールを離れる前に、次の値があることを確認してください。Amazon Quick 設定にはこれらが必要です。

1. Atlassian デベロッパーコンソールのアプリから、左側のナビゲーションで**設定**を選択します。

1. **認証の詳細**で、**クライアント ID** と**シークレット**値をコピーします。


**Atlassian デベロッパーコンソールから必要な認証情報**  

| 値 | 検索先 | 
| --- | --- | 
| クライアント ID | 設定ページ、認証の詳細の下 | 
| シークレット | 設定ページ、認証の詳細の下 | 

## 認証を準備する
<a name="confluence-action-auth-setup"></a>

Confluence Cloud アクションコネクタは、2 つの認証方法をサポートしています。Amazon Quick を設定する前に、必要な認証情報を収集します。

**ユーザー認証 (3LO)**  
前のセクションで Atlassian デベロッパーコンソールの設定を完了した場合、次の値が準備されているはずです。Amazon Quick で統合を設定するときに、これらを入力します。  
+ **ベース URL** – API コールの Confluence インスタンス URL。これは、ユーザーがログインする URL とは異なります。これは、 のようになります`https://api.atlassian.com/ex/confluence/yourInstanceId`。インスタンス ID を検索するには、 に移動します`https://your-domain.atlassian.net/_edge/tenant_info`。
+ **クライアント ID** – Atlassian OAuth アプリの設定ページから。
+ **クライアントシークレット** – Atlassian OAuth アプリの設定ページから。
+ **トークン URL** – `https://auth.atlassian.com/oauth/token`
+ **認可 URL** – `https://auth.atlassian.com/authorize`
+ **リダイレクト URL** – `https://region.quicksight.aws.amazon.com/sn/oauthcallback`

**サービス認証 (API キー)**  
Confluence Cloud 管理者から次の情報を収集します。  
+ **API キー** – Confluence API トークン。
+ **ベース URL** – API コールの Confluence インスタンス URL。
+ **E メール** – 関連付けられたユーザーアカウント E メール。

## Amazon Quick で統合を設定する
<a name="confluence-action-integration-setup"></a>

認証情報を準備したら、Amazon Quick で統合を作成します。

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

1. **[Actions]** タブを選択します。

1. **「アクションの新しいアプリ統合を設定する**」で、**Atlassian Confluence Cloud** を見つけ、追加 (プラス「＋」) ボタンを選択します。

1. **統合タイプ**ページで、**「Atlassian Confluence Cloud でアクションを実行**する」を選択し、**「次へ**」を選択します。

1. **統合の作成**フォームで、次のフィールドに入力します。
   + **名前** – Confluence 統合の説明名。
   + **説明** (オプション) — この接続の使用方法に関する注意事項。
   + **接続タイプ** – **パブリックネットワーク**を選択します。

1. **認証設定**で、認証方法を選択し、必須フィールドを入力します。

   1. **ユーザー認証**では、次のフィールドを設定します。
      + **ベース URL** – API コールの Confluence インスタンス URL。形式は です`https://api.atlassian.com/ex/confluence/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 キー** – Confluence API トークン。
      + **ベース URL** – API コールの Confluence インスタンス URL。
      + **E メール** – 関連付けられたユーザーアカウント E メール。

1. [**作成して続ける]** を選択します。

1. (オプション) **統合の共有**ページで、統合を共有するユーザーを選択します。

## 使用可能なアクション
<a name="confluence-action-available-actions"></a>

統合を設定すると、次のアクションを使用できます。


**Confluence Cloud で使用可能なアクション**  

| アクション | 説明 | 
| --- | --- | 
| ページの作成 | 新しいページを作成します。 | 
| ページの取得 | すべてのページを表示します。 | 
| 検索 | CQL を使用してコンテンツを検索します。 | 
| 更新ページ | ページの内容を更新します。 | 

## の管理とトラブルシューティング
<a name="confluence-action-troubleshooting"></a>

統合を編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

### 認証問題
<a name="confluence-action-troubleshooting-auth"></a>
+ **アプリ設定が正しく**ない – Atlassian デベロッパーコンソールの OAuth アプリに必要なスコープが含まれ、リダイレクト URI が Amazon Quick 設定と一致することを確認します。
+ **期限切れの API トークン** – サービス認証を使用する場合は、API トークンの有効期限が切れていないことを確認し、必要に応じて新しいトークンを生成します。
+ **不正なベース URL** – API コールのベース URL が Confluence Cloud ログイン URL と同じではありません。API URL 形式 を使用していることを確認します`https://api.atlassian.com/ex/confluence/yourInstanceId`。インスタンス ID を検索するには、 に移動します`https://your-domain.atlassian.net/_edge/tenant_info`。

### 一般的なエラーメッセージ
<a name="confluence-action-troubleshooting-errors"></a>
+ **`Access denied. You do not have permission to perform this action`** – 認証されたユーザーには、Confluence Cloud で必要なアクセス許可がありません。Confluence Cloud 管理者に連絡して、適切なアクセス許可を確認して付与してください。
+ **`OAuth 2.0 authorization failed`** – Atlassian デベロッパーコンソールと Amazon Quick の両方でクライアント ID、クライアントシークレット、OAuth スコープが正しく設定されていることを確認します。