View a markdown version of this page

Atlassian Confluence Cloud アクション統合 - Amazon Quick
[開始する前に]Atlassian デベロッパーコンソールを設定する認証を準備するAmazon Quick で統合を設定する使用可能なアクションの管理とトラブルシューティング

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

Atlassian Confluence Cloud アクション統合

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

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

[開始する前に]

統合を設定する前に、以下があることを確認してください。

Atlassian デベロッパーコンソールを設定する

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

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

OAuth 2.0 (3LO) アプリケーションの詳細については、Atlassian デベロッパードキュメントのOAuth 2.0 (3LO) アプリケーション」を参照してください。

OAuth 2.0 (3LO) アプリを作成する

Amazon Quick は、Atlassian OAuth 2.0 (3LO) アプリを使用して、ユーザーに代わって Atlassian Cloud 製品で認証します。Amazon Quick を設定する前に、Atlassian デベロッパーコンソールでこのアプリを作成します。

  1. Atlassian デベロッパーコンソールを開き、Atlassian アカウントでサインインします。

  2. Create を選択し、OAuth 2.0 統合を選択します。

  3. 名前には、 など、統合のわかりやすい名前を入力しますyour-app-name connector。

  4. Atlassian デベロッパー規約を確認して同意します。

  5. [作成] を選択します。

アクセス許可の設定

OAuth 2.0 アプリを作成したら、Amazon Quick が Atlassian 製品とやり取りするために必要な API アクセス許可を追加します。

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

  2. Atlassian 製品の API (Jira API や Confluence API など) を検索し、追加を選択します。API が追加されると、ボタンが Configure に変わります。

  3. [設定] を選択します。スコープページが開き、クラシックスコープと粒度スコープタブが表示されます。

  4. Classic scopes タブで、Edit Scopes を選択します。必要なクラシックスコープを選択し、保存を選択します。

  5. きめ細かなスコープタブを選択し、スコープの編集を選択します。必要なきめ細かなスコープを選択し、保存を選択します。

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

Confluence に必要なスコープ

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

クラシックスコープ

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

Confluence アクション統合 – クラシックスコープ
スコープ 説明
search:confluence Confluence のコンテンツとスペースの概要を検索します。

きめ細かなスコープ

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

Confluence アクション統合 – きめ細かなスコープ
スコープ 説明
read:page:confluence ページの内容を表示します。
write:page:confluence ページを作成および更新します。
read:space:confluence スペース情報にアクセスします。

認可を設定

Atlassian がアプリを承認した後にユーザーを Amazon Quick にリダイレクトできるように、コールバック URL を設定します。

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

  2. OAuth 2.0 (3LO) の横にある「追加」を選択します。

  3. コールバック URLs、 と入力しますhttps://region.quicksight.aws.amazon.com/sn/oauthcallback。region を、Amazon Quick インスタンスがデプロイされている AWS リージョンに置き換えます。例: us-east-1。

  4. [Save changes] (変更の保存) をクリックします。

認証情報を記録する

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

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

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

Atlassian デベロッパーコンソールから必要な認証情報
値 検索先
クライアント ID 設定ページ、認証の詳細の下
シークレット 設定ページ、認証の詳細の下

認証を準備する

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 で統合を設定する

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

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

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

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

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

  5. 統合の作成フォームで、次のフィールドに入力します。

    • 名前 – Confluence 統合の説明名。

    • 説明 (オプション) — この接続の使用方法に関する注意事項。

    • 接続タイプ – パブリックネットワークを選択します。

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

    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 があらかじめ入力されています。

    2. サービス認証では、次のフィールドを設定します。

      • API キー – Confluence API トークン。

      • ベース URL – API コールの Confluence インスタンス URL。

      • E メール – 関連付けられたユーザーアカウント E メール。

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

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

使用可能なアクション

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

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

の管理とトラブルシューティング

統合を編集、共有、または削除するには、「」を参照してください既存の統合の管理。

認証問題

  • アプリ設定が正しくない – 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。

一般的なエラーメッセージ

  • 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 スコープが正しく設定されていることを確認します。