Jira ​

Jiraは、あらゆるソフトウェアのリリースを整理および計画するための簡単な方法を提供します。これにより、Developmentチームはソフトウェアをリリースする際に従う主要なステップを定義できます。これには次が含まれます:

• プラン
• 追跡
• リリース
• レポート

Workatoを使用して、JiraとZendesk、ServiceNow、SalesforceのDesk.comなどの他の課題追跡システム間でプロジェクトと課題を同期できます。

ユースケース ​

Jiraコネクターの機能については、ユースケースドキュメントをご覧ください。 Jiraコネクターを使用して、強力なマルチアプリワークフローと自動化を作成する方法について説明します:

• Workdayの新規従業員向けにJiraおよびOktaユーザーをプロビジョニングします。
• 新しいPagerDutyインシデントからJira課題を作成または更新します。
• 新しいServiceNowインシデントについてJira課題を作成します。

APIバージョン ​

JiraコネクターはJira Cloud REST API v2を使用します。

サポートされているエディションとバージョン ​

Jiraコネクターは次と連携します:

• Jira Cloudインスタンス
• バージョン7.x以降のJiraオンプレミスインスタンス
• Jira Serverに置き換わったJira Data Center

コネクション設定 ​

Jiraに接続する方法は6つあります:

• APIトークン
• サービスアカウント（APIトークン）
• OAuth 2.0（Cloud - AtlassianがホストするJira）
• OAuth 2.0（Data Center）
• Personal access tokens
• 基本認証（パスワード）

パスワードを使用する基本認証ではなく、APIトークン、サービスアカウントAPIトークン、OAuth 2.0、または個人用アクセストークンを使用してJiraに接続することを強くお勧めします。

API token ​

サービスアカウント（APIトークン） ​

OAuth 2.0（Cloud - AtlassianがホストするJira） ​

OAuth 2.0（Data Center） ​

Personal access tokens ​

パスワードによる基本認証 ​

接続に必要なロールと権限 ​

Jira、Jira Cloud、Jira Data Centerのユーザーで、自分のJiraインスタンスへのログインアクセス権を持つユーザーは、認証情報を使用してWorkatoに接続できます。ただし、統合のために、Jira Administratorグローバル権限を持つ別のユーザーを作成することをお勧めします。

Jiraコネクションは、Jiraプロジェクト内のプロジェクト権限スキームに従います。 Jiraアカウントに、関連するJiraオブジェクトに対して目的のアクションを実行するための十分な権限があることを確認する必要があります。

Jiraプロジェクト権限 ​

ユーザーがプロジェクト内のオブジェクトにアクセスする主な方法は3つあります:

• ユーザー
• 課題セキュリティスキーム
• 権限スキーム

ユーザー ​

ユーザーは、2つの方法でプロジェクトに追加（プロジェクト設定 > ユーザーから）できます:

1. 特定のユーザーを検索して選択し、そのユーザーのプロジェクトロールを指定します。 ユーザーJan Donyadaのプロジェクトロールの選択

   プロジェクトロールを使用すると、ユーザーを機能ロールに関連付けることができます。たとえば、組織で、すべてのソフトウェアDevelopment課題をクローズする前にQA担当者がテストする必要がある場合、次のようにできます:

   • QAというプロジェクトロールを作成します。
   • Software Developmentという権限スキームを作成し、その中でClose issue権限をQAロールに割り当てます。
   • Software Development権限スキームをすべてのソフトウェアDevelopmentプロジェクトに関連付けます。
   • 各ソフトウェアDevelopmentプロジェクトについて、QAエンジニアを追加し、QAプロジェクトロールを割り当てます。

2. グループを検索してから、そのグループのプロジェクトロールを指定します。 Jira Administratorsグループのプロジェクトロールの選択

   グループには複数のメンバーが含まれます。グループはプロジェクトロールに似ていますが、1つの重要な違いがあります。グループメンバーシップはグローバルですが、プロジェクトロールメンバーシップはプロジェクト固有です。また、グループメンバーシップはJira管理者のみが変更できますが、プロジェクトロールメンバーシップはプロジェクト管理者のみが変更できます。

課題セキュリティスキーム ​

課題セキュリティスキームを作成して各プロジェクトに追加することで、プロジェクトの課題を表示および編集できるユーザーを制御できます。

スキームには複数のセキュリティレベルを設定でき、ユーザーまたはユーザーグループを各セキュリティレベルに割り当てることができます。これにより、適切なセキュリティレベルが割り当てられたユーザーのみが課題を表示できるようになります。

プロジェクトに定義済みの課題セキュリティスキームがある場合、リンクされたJiraアカウントは、セキュリティスキーム内の適切なセキュリティレベルのメンバーである必要があります。通常、セキュリティレベルのメンバーには次が含まれます:

• 個別メンバー
• グループ
• プロジェクトロール
• 次のような課題ロール:
  • 報告者
  • プロジェクトリード
  • 現在の担当者
• 誰でも（たとえば、匿名アクセスを許可する場合）

次の例では、課題セキュリティスキームに定義済みのセキュリティレベルがあり、特定のユーザー、グループ、およびプロジェクトロールにのみアクセスを許可しています。

「Top-secret」セキュリティレベルで定義されているように、ユーザー「Jan Donyada」、「Jira Administrators」グループのユーザー、および「QA」プロジェクトロールを持つユーザーのみが課題にアクセスできます

権限スキーム ​

プロジェクト権限は権限スキーム内で作成され、その後、Jira管理者によって特定のプロジェクトに割り当てられます。

権限は、課題の作成、課題の編集、課題の割り当てなど、特定のアクションへのアクセスを制御します。権限を表示するには、Jiraでプロジェクト設定 > 権限に移動します。

各権限は、次の範囲に付与できます。

• プロジェクトロール
• アプリケーション（Jira、Jira Service Desk、Jira Data Centerなど。）
• グループ

プロジェクトロール ​

プロジェクトに関連付けられた権限スキームで、特定のアクションに対するロール固有の権限が定義されている場合、リンクされたJiraアカウントは、Workatoレシピでそれらのアクションの使用が認可されるよう、同じロールを割り当てられている必要が_あります_。

たとえば、以下のプロジェクト権限スキームでは、QAロールのみにClose Issuesアクションの実行が許可されています。

WorkatoレシピがClose issueアクションを実行する場合、そのアクションが承認されるには、リンクされたJiraアカウントにもQAロールを割り当てる必要があります。

アプリケーションアクセス ​

アプリケーションアクセス設定では、どのユーザーがどの製品にアクセスできるかを制御できます。サイトに1つの製品しかない場合（たとえば、ConfluenceのみまたはJiraのみのインスタンスがある場合）、ユーザーはサインアップ時にその製品へのアクセス権を自動的に付与されます。

WorkatoレシピがJira Softwareインスタンスで特定のアクションのみを実行する必要がある場合、それらのアクションにはJira Softwareを選択する必要があります。

Jira Softwareのユーザーのみが課題の割り当てを許可されます

同様に、WorkatoレシピがConfluenceインスタンスで特定のアクションのみを実行する必要がある場合、それらのアクションにはConfluenceを選択する必要があります。

WorkatoレシピがJira SoftwareおよびConfluenceの両方で特定のアクションを実行する場合、それらのアクションにはAny logged in userを選択する必要があります。

Jira SoftwareまたはConfluenceのいずれかのログイン済みユーザーは、課題の割り当てを許可されます

グループ ​

プロジェクトに関連付けられた権限スキームで、特定のアクションに対してグループ固有の権限が定義されている場合、リンクされたJiraアカウントは、Workatoレシピでそれらのアクションを使用するために承認されるには、そのグループのメンバーである_必要があります_。 Jira Administratorsグループはスプリントの管理を許可されています

サポートされているJiraアクションと必要な権限 ​

アップロード/ダウンロードアクション ​

添付ファイルのアップロードおよびダウンロードアクションを使用するには、リンクされたJiraアカウントを、権限ページのAttachment Permissionsタブの権限に追加する必要があります。

コメントトリガーとアクション ​

Commentsに関連するトリガーとアクションを使用するには、リンクされたJiraアカウントを、権限ページのComments Permissionsタブの権限に追加する必要があります。

課題トリガーとアクション ​

Issuesに関連するトリガーとアクションを使用するには、リンクされたJiraアカウントを、権限ページのIssues Permissionsタブの権限に追加する必要があります。

接続されたJiraユーザーに、オブジェクトまたはアクションにアクセスするために必要な権限がない場合、403 - Forbiddenエラーが表示されます。

プロジェクト権限の管理方法については、Jiraの権限ガイドを参照してください。

ユーザーが特定のプロジェクト、課題タイプ、またはフィールドにアクセスしたりアクションを実行したりできない理由をトラブルシューティングするには、Jira権限ヘルパーを使用できます。

Jira権限ヘルパー ​

Jira権限ヘルパーを使用すると、ユーザーが特定のプロジェクトまたはフィールドを表示または編集できない理由を確認できます。

これを使用するには、JiraインスタンスへのJira Administratorアクセス権が必要です。詳細については、Jiraの権限ヘルパーガイドを参照してください。

Jiraリアルタイムトリガーの使用 ​

Jiraリアルタイムトリガーを使用するには、まず接続先のJiraインスタンスにwebhookを登録する必要があります。 Jiraインスタンスにwebhookを登録するには、Jira Administratorグローバル権限が必要です。

リンクされたJiraアカウントにJira Administrators global permissionsがある場合、Workatoレシピ（Jiraリアルタイムトリガーを含む）が初めて開始されると、WorkatoはJiraインスタンスにwebhookを自動的に登録します。

Jira管理者およびグローバル権限の詳細については、Jiraのグローバル権限ガイドを確認してください。

webhookを登録するには、リンクされたJiraアカウントにJira Administrators global permissionsが必要です。必要な権限がない場合は、次を実行できます:

• webhookを登録するための正しい権限を持つユーザーと連携します。
• Jira Administrators global permissionsへのアクセス権をリクエストします。
• Jiraコネクターのリアルタイムトリガーの代替として、WebhooksコネクターのwebhookトリガーとJiraの静的webhook機能を使用します。

Jira Administratorとしてのwebhookトリガーの登録 ​

グローバル権限を持つJira Administratorの場合、HTTP webhookトリガーレシピで使用したい他のJiraインスタンスユーザーのためにwebhookを登録できます。

これはJira管理コンソールから実行できます。 Jira管理コンソールを通じてwebhookを登録する方法の詳細については、webhookの登録に関するJiraガイドを確認してください。

webhookの登録方法 ​