Dropbox Dash に Jira を追加する方法

組織のアトラシアン Jira アカウントを Dropbox Dash に追加すると、Dash 内で直接 Jira の作業項目にアクセスして、タイトルやメタデータで検索できます。Jira アカウントを Dash と同期すると、ワンクリックでコンテンツと回答にすばやくアクセスできます。

API アクセス権限

Jira を追加する際、Dash は次の承認を要求します：

• オフラインでデータにアクセスする：この権限により、Dash は、Jira データをアクティブに使用していない場合でも、バックグラウンドで Jira データを最新の状態に保つことができます。
• プロフィール情報の表示：この権限により、Dash は Jira でユーザーを識別し、ユーザーの権限と ID に合わせて検索結果を調整できます。
• 作業項目と作業ログの表示：この権限により、Dash は作業項目と作業履歴にインデックスを付けることができるため、タスクとチケット全体を検索できます。
• プロジェクトの詳細の表示：この権限により、Dash は Jira プロジェクトにインデックスを付けることができます。
• ボード構成の表示：この権限により、Dash は Jira のボード、スプリント、またエピックにインデックスを付けて検索できるようになります。
• ユーザーとそのロールの表示：この権限により、Dash は各ユーザーがアクセスできるもののみを表示します。
• グループ メンバーシップの表示：この権限により、Dash は検索結果に Jira コンテンツを表示する際に、グループのアクセス制限を確認できます。
• アバターの表示：この権限は、検索結果内でアバターを表示するために使用されます。

設定の概要

1. 管理者サービスアカウントを作成します。
2. サポートされている 2 つの認証方法のいずれかを使用して、Jira を Dash に追加します。
   • 方法 1：API キー方式 
   • 方法 2：OAuth 方式

Jira でサービス アカウントを作成する方法

Jira を Dash に追加するには、Jira の管理者が Jira と Dash の会社レベルの統合を認証し、承認する必要があります。セキュリティを強化し、Jira と Dash の連携に関する問題（管理者が退職する場合など）を防ぐため、この連携のために Jira で人間以外の管理者サービスアカウントを作成することをお勧めします。

1. 管理者の認証情報を使用して、Atlassian 管理にログインします 。
2. ディレクトリをクリックします。
3. ユーザーを招待をクリックします。
4. サービス アカウント ユーザーのメール アドレスをメール アドレスで招待…フィールドに入力します。
5. 製品アクセスを選択します：Jira 製品
6. ユーザーを招待をクリックします。
   • ユーザーのアトラシアン管理ページに戻り、招待されたユーザーとして「svc-dropboxdash-atlassian-jira」が表示されます。
7. ユーザー「svc-dropboxdash-atlassian-jira」のメール アカウントを開き、Jira への招待状を見つけます。
8. 招待を承認するをクリックします。
9. ポップアップ ウィンドウの氏名フィールドに、「svc-dropboxdash-atlassian-jira」と入力します。
10. パスワード フィールドに新しいパスワードを入力します。
    • パスワードは、パスワード管理ツールなどの安全な場所に保管してください。
11. ［続行］をクリックします。
12. チームの業務に最も適したロールを選択するよう求められます。プルダウンメニューから適切なオプションを選択し、完了をクリックします。

方法 1: API キー方式

この認証方法を使用するには、Jira をダッシュに追加する前に、API トークンと組織 API キーを作成します。

1. Jira で製品管理者の役割を使用して API トークンを作成します。 API トークンを作成する方法 （スコープなし）をご覧ください。

2. Atlassian 管理者アカウントにログインして、管理ポータルで組織 API トークンを生成します。API キーを作成する方法（スコープなし）をご覧ください。

• 注：API キーの有効期限を 1 年（最大）に設定することをお勧めします。サービスの中断を防ぐため、キーの有効期限が切れる前にキーを更新するリマインダーを設定してください。

3. Jira を Dash に追加します。

Jira を Dash に追加するには、次の手順に従ってください。

1. 管理者の認証情報を使用して、dash.ai にログインします。
2. 左下にあるアバター（プロフィール写真またはイニシャル）をクリックします。
3. 管理コンソールを選択します。
4. 左側のサイドバーで Dash をクリックします。
5. ［アプリ］をクリックします。
6. その他のアプリ タブをクリックします。
7. Jira の右側にある①（追加）をクリックします。
8. ポップアップウィンドウで［API トークン］をクリックし、［開始］をクリックします。
9. ［予想されること］ウィンドウを確認し、［開始］をクリックします。
10. サブドメインを入力します。
    • サブドメインは、https:// を除いた Confluence サイトの URL です（例：exampleteam1.atlassian.net）
11. 上記のセクションで生成された API キーを入力します。
12. 以前のセクションで作成したサービス アカウントのメール アドレスを入力します。
13. 以前のセクションで生成された組織 API キーを入力します。
14. ［次へ］をクリックしてから、［完了］をクリックします。

方法 2：OAuth 方式

OAuth メソッドを使用するには、サービスアカウントに組織管理者の役割を割り当ててから、Jira を Dash に追加します。

サービスアカウントに組織管理者の役割を追加する方法。

1. 管理者の認証情報を使用して、Atlassian 管理にログインします 。
2. ディレクトリ> ユーザーをクリックします。
3. サービス アカウントを見つけて、アバターまたは詳細を表示を選択します。
4. ページ上部のその他のアクション（）をクリックし、組織管理者ロールを割り当てるを選択します。
5. ロールを割り当てるをクリックして確定します。

OAuth メソッドを使用して Jira を Dash に追加するには、次の手順に従ってください。

1. 管理者の認証情報を使用して、dash.ai にログインします。
2. 左下にあるアバター（プロフィール写真またはイニシャル）をクリックします。
3. 管理コンソールを選択します。
4. 左側のサイドバーで Dash をクリックします。
5. ［アプリ］をクリックします。
6. その他のアプリ タブをクリックします。
7. Jira の右側にある①（追加）をクリックします。
8. ポップアップウィンドウで［OAuth］をクリックし、［開始］をクリックします。
9. svc-dropboxdash-jira サービス アカウントでアトラシアンのログイン手順を完了し、承諾をクリックします。

10. ［完了］をクリックします。

11. ［お使いのアプリ］タブをクリックします。

これで、Jira が表示されるはずです。