Jira統合の開始方法

Jira統合の設定は迅速かつ簡単です。このドキュメントでは、組織全体でこの強力な統合を活用できるようにするために必要な設定と設定について説明します。

Jira Cloud（ジラ・クラウド）への接続

まず、axeアカウント ポータル管理者がJiraインスタンスへの認証接続を確立する必要があります。この接続は組織全体で共有されるため、接続を確立するユーザーは、課題を送信したいすべてのプロジェクトにアクセス権を持っている必要があります。

1.axe Account Portal（アックス・アカウント・ポータル）内の［「設定」ページ］へ移動してください(https://axe.deque.com/configuration) 1.「設定」ナビゲーション内の「統合」リンクをクリックします 1.「Jira Cloudに新規接続を追加」ボタンをクリックしてください 「Jira Cloudに新規接続を追加」ボタンのスクリーンショット(images/integrations-add-new-connection.png) 1.新しいポップアップウィンドウ（OAuth認可）が表示され、ログインを求められます（すでにJiraにログインしている場合は、この手順は省略されます）。 1.Jiraで認証されると、「アプリを使用する」選択リストで接続するJiraインスタンスを選択するように求められます。 1.Jiraインスタンスを選択したら、「承認」をクリックします 1.ポップアップウィンドウが閉じ、確認ダイアログが表示されます。 1.ドロップダウンで接続したいJiraインスタンスを確認します 1.「完了」をクリックします 1.接続されると、「Jiraに正常に接続されました」というメッセージが表示されます。 「Jiraに正常に接続されました」というメッセージのスクリーンショット(images/integrations-successful-connection.png)

Jira Data Centerへの接続

1.axe Account Portal（アックス・アカウント・ポータル）内の［「設定」ページ］へ移動してください(https://axe.deque.com/configuration) 1.「設定」ナビゲーション内の「統合」リンクをクリックします 1.「Jira Data Centerへの新規接続を追加」ボタンをクリックします。 1.「Configure settings」ボタン（「接続が構成されていません」というテキストの下）をクリックします 1.Jira Data CenterのURLを入力してください（例: https://jira.mycompany.com） Jira Data Centerの設定ページのスクリーンショット(images/jira-on-prem-settings.png) 1.Jiraで入力したものと同じコンシューマーキーを入力してください。 1.Jira Data Center（ジラ・データセンター）では... ・ページの右上隅にある歯車アイコンの「設定」ボタンをクリックしてください ・「アプリケーション」リンクをクリックします。 ・「アプリケーションリンク」をクリックしてください。

• テキスト入力欄にURLとしてhttps://www.deque.comを入力してください。

・「新しいリンクを作成」ボタンをクリックしてください -「続行」ボタンをクリックします 「入力したURLから応答がありません」などの警告や、リダイレクトに関する警告が表示された場合は、無視しても問題ありませんので、ご安心ください。URL自体はいかなる検証にも使用されず、接続を適切に設定するための単なる必須フィールドです。 ・アプリケーション名（例：「Deque Jira Integration」；この値はJira Data Centerの設定ページでも同じものを入力してください）。 -「受信リンクを作成」チェックボックスにチェックを入れてください -「続行」ボタンをクリックします ・_コンシューマーキー_フィールドに値を入力します（例: "DequeOAuthKey"）

• _「Consumer Name」_フィールドに値を入力してください（例：「Deque Jira Integration」）。

・「Jira Data Center 設定」ページに表示されている公開鍵を、_Public Key_フィールドに入力してください。 1.axe Account PortalのJira Data Center設定ページに戻ってください。 ・Jira Data Centerで入力したものと同じ_コンシューマーキー_を入力してください ・《保存》ボタンをクリックします。 ・「統合に接続」ボタンをクリックします。 ・ポップアップウィンドウ内で、まだデータセンターにログインしていない場合はログインしてください。

• 「許可」をクリックしてください。
• ウィンドウを閉じてください。

Deque（デーク）オンプレミスインスタンスからJiraクラウド接続の前提条件

Jira Client App（Jiraクライアントアプリ）を登録する

1.https://developer.atlassian.com/console/myapps/ にアクセスしてください 1.「作成」ボタンをクリックして、「OAuth 2.0」インテグレーションを選択してください 1.名前をご指定ください（例：「Acme Corp - axe on-prem - Jira Cloud Integration」） 1.「Atlassian の開発者規約に同意します」チェックボックスにチェックを入れ、［作成］ボタンをクリックします_ 1.「配布」タブで「編集」をクリックし、「配布ステータス」で「共有」を選択してください。 ・「ベンダー名」を「Deque」に設定する。 ・「プライバシーポリシー」を「https://www.deque.com/privacy-policy/」に設定する。 ・「個人情報を保存しますか」を「いいえ」に設定してください。

• 変更を保存します。

1.「権限」タブで「Jira API」の横にある「追加」ボタンをクリックしてください。 1.設定の準備が整うと（しばらく時間がかかります）、"追加"ボタンが新しい"設定"ボタンに置き換えられます。 ・「設定」ボタンが表示されない場合は、ページを再読み込みしてください。 1.「Configure」をクリックします 1.「スコープの編集」をクリックします

• 以下のチェックボックスにチェックを入れてください: 「read:jira-work」「read:jira-user」「write:jira-work」「manage:jira-webhook」

1.「認証」タブで、「追加」ボタンをクリックしてください。 1.「コールバックURL」を「https://axe.deque.com/jira-direct/connected」に設定してください。 1.「変更を保存」ボタンをクリックします 1.この画像をダウンロードしてください（右クリックして「名前を付けて画像を保存」を選択します）。 1.「設定」タブで「アバターを変更」をクリックし、保存したaxeロゴを選択してください。 1.「認証の詳細」セクションで「クライアントID」と「シークレット」を保存しておきます。これらはオンプレミスインストールの際に使用します。 1.Dequeオンプレミスのインストール完了後、上記の手順に従って[Jiraクラウドへの接続を確立]してください。(#connecting-to-jira-cloud)

アクティブな接続の切断

「Jiraから切断」をクリックすると、以前にJiraで確立されたアクティブな認証セッションが無効になります。さらに、ユーザーは切断されたJiraインスタンスに問題を送信できなくなります。

切断された接続を再度確立するには、「Jiraに接続」ボタンをクリックしてください。接続の手順(#establishing-a-new-connection)に再度案内されます。

接続の削除

接続が切断(#disconnecting-an-active-connection)された後、「Jira接続を削除」ボタンをクリックして削除してください。

テンプレート

接続が確立されたら(#connecting-to-jira-cloud)、axe（アックス）の課題をJira（ジラ）フィールドに統一的にマッピングするためのテンプレートを作成できます。テンプレートは、組織全体で問題作成の一貫性を保つのに役立ちます。

テンプレートの作成、管理、利用について詳しくは、テンプレートドキュメントをご覧ください(templates)。

Jira（ジラ）への課題送信

Jiraへの接続を確立し、テンプレートを作成した後は、Jiraにaxeの問題を送信できます。この手順では、単一の問題または複数の問題を送信してJira（ジラ）チケットを作成することができます。

• axe DevTools拡張機能からJiraに課題を送信する
• axe MonitorからJiraに課題を送信する