Jira

Qangarooは他のアプリと連携することができます！サイドバーにある「アプリ連携」をクリックすると、連携機能ページへ移動することができます。連携機能ページでは連携できるサービスとそのサービスの連携状態が分かります。

設定画面でAPIキーなど連携サービスに必要な情報を入力します。Backlogの場合はASP版とEnterprise版の二つの種類があり、タイプによってスペース名またはホスト名を入力する必要があります。RedmineとJiraの場合はホスト名を入力することになります。
注意： Backlog Enterprise版、RedmineとJira ServerはIP制限されているかどうかを確認してください。QangarooのIPを解放しないと連携できません。

❶連携するサービスの確認

JiraではBacklogやRedmineの場合と違い、OAuth認証を行います。OAuth認証はJiraのアプリケーションリンク設定でQangarooをアプリケーションリンクとして設定する必要があります。

1. Jiraに管理者権限をお持ちのアカウントでログインし、アプリケーションリンクの設定ページを開きます。URLのパスは以下のものです。
/plugins/servlet/applinks/listApplicationLinks

2. QangarooアプリケーションのURLを入力し、「新しいリンクを作成」をクリックします。 URLは以下のようなものです。
https://サブドメイン.qangarooo.jp/

3. 「入力したURLから応答がありません。無効な可能性があります。必要に応じてURLを修正し、’続行’をクリックしてください。」と表示されますが、上記のURLと間違いなければ、「続行」をクリックします。
＊この画面は複数回表示されることがありますが、次の画面に進むまで「続行」をクリックしてください。

4. アプリケーション名は任意の名前を入力、アプリケーションタイプは「汎用アプリケーション」を選択し、「続行」をクリックします。この２つの項目以外は入力しなくても構いません。

5. 先ほど入力したフォームの下のアプリケーションのリストに、入力していただいたアプリケーション名で作成されますので、そのアクション欄にある鉛筆マークをクリックします。

6. アプリケーションリンクの構成を設定する画面が開きます。
サイドバーのアプリケーションの詳細をクリックし、アプリケーション名と表示URLが入力されていることを確認します。
入力されていない場合は、アプリケーション名は任意の名前を入力し、表示URLは以下を入力します。
https://サブドメイン.qangarooo.jp/

7. サイドバーの受信認証設定に進み、OAuth認証設定をしていきます。
まず、Qangarooの Jira連携設定画面にあるコンシューマーキーのコピーボタンをクリックしてコピーします。
そして、先ほどの受信設定画面のコンシューマーキー欄に貼り付けます。
コンシューマー名は任意の名前を入力してください。
＊送信認証タブの入力欄は入力しなくても構いません。

8. 次にQangarooの Jira連携設定画面にあるパブリックキーのコピーボタンをクリックしてコピーします。
そして、先ほどの受信設定画面の公開キー(パブリックキー)欄に貼り付けます。
＊コンシューマーコールバックURLは入力しないでください。

9. Jiraのご契約タイプがJira Cloudの場合は、保存をクリックします。

10. Jiraのご契約タイプがJira Serverの場合は、「2-Legged OAuthを許可する」を選択できます。許可した場合、実行ユーザーを入力してください。
2-Legged OAuthを許可した場合、Qangarooから連携されたJiraに課題が作成・更新されるときにその実行ユーザーが報告者または更新者になります。
許可しなかった場合は、Jiraにログイン中のユーザーで連携されます。
上記の設定でよければ保存をクリックします。