Jira is getting a fresh new look and navigation

We’re in the process of rolling out these changes and the documentation may not match your experience. Bear with us while we update it to reflect the new changes. More about navigating the new Jira

Jira 向け GitHub に必要な権限

Jira 向け GitHub アプリへのアクセスを許可することで、GitHub と Jira のアカウントに次の権限を与えることになります。

Jira 権限の範囲

  • 開発情報の読み取り、書き込み、管理者アクセス権: これには、ブランチ、コミット、プル リクエストが含まれます。

GitHub 権限の範囲

リポジトリ権限

権限の範囲

アプリに必要な理由

アクションへの読み取り専用アクセス権

この権限によって、workflow_run Webhook イベントにアクセスできるようになり、artifacts_url、check_suite_id、conclusion、 head_branch、head_sha などの情報を提供できます。

コード スキャン アラート / セキュリティ イベントへの読み取り専用アクセス権

To receive Github code scanning alerts in Jira, the app needs read permissions for security events. The app will listen to code_scanning_alert webhooks and send security report details to Jira. These will appear under the "Other links" tab of the Development Panel on Jira work items.

デプロイへの読み取り専用アクセス権

Jira でビルドとデプロイの情報を確認するには、アプリにデプロイの読み取り権限が必要です。これによって、デプロイが作成されたときに発生する Webhook deployment_status のイベントをリッスンできます。読み取り専用のデプロイ権限は、次の Webhook に使用します。

  • デプロイのステータス

メタデータへの読み取り専用アクセス権

GitHub の必須要件として、すべてのアプリに既定で読み取り専用のメタデータ アクセス権があります。これは、さまざまなリソースのメタデータを含む読み取り専用エンドポイントのコレクションへのアクセスを提供するためです。これらのエンドポイントは、機密の非公開リポジトリ情報を提供しません。読み取り専用のメタデータ権限は、次の Webhook で使用します。

  • repository

Read and write access to work items and pull requests

This permission powers Smart Commit actions and allows Jira URLs to unfurl in comments. Unfurling refers to the app detecting Jira work item keys in square brackets like [ABC-123] and replacing them with respective Jira work item links.

Work items: Read and write work item permissions are used for the following webhooks:

  • work item comment

  • work items

プル リクエスト: プル リクエストの読み取り権限と書き込み権限は、次の Webhook に使用します。

  • プルリクエスト

  • プル リクエストのレビュー。

メモ:

  1. The square brackets are required, without which the pull request may appear in the Jira work item’s Development section, but the work item key won't be expanded to a link.

  2. GitHub Enterprise 統合 (ユーザーが GitHub アプリを所有している場合) では、"書き込み" 権限はオプションです。指定されていない場合、"展開" ロジックはスキップされます。

コンテンツ (コード) への読み取り書き込みのアクセス権

読み取り権限があれば、次の Webhook の開発情報が Jira に同期されます。

  • commit comment

  • 削除

  • push

  • ワークフローの実行

Write permissions allow branch creation from a work item’s dev panel.

注: GitHub Enterprise 統合 (ユーザーが GitHub アプリを所有している場合) では、"書き込み" 権限はオプションです。指定しない場合、"ブランチを作成" 機能は動作しません。

組織の権限

権限の範囲

アプリに必要な理由

メンバーへの読み取り専用アクセス権

GitHub 組織への管理者アクセス権があるかどうかを確認するためです。

アプリにサブスクリプションがあるイベント

イベント

このイベントの発生契機

コード スキャン アラート / セキュリティ イベント

コード スキャン アラートが作成されたか、ブランチで修正されたか、クローズした

コミット コメント

コミット コメントが作成された

作成

Git ブランチまたはタグが作成された

削除

Git ブランチまたはタグが削除された

デプロイのステータス

デプロイが作成された

Work item comment

Activity related to a work item or pull request comment

Work items

Activity related to a work item

Pull request

プル リクエストに関連したアクティビティ

プル リクエストのレビュー

プル リクエスト レビューに関連したアクティビティ

プッシュ

1 つ以上のコミットがリポジトリのブランチまたはタグにプッシュされた

リポジトリ

リポジトリに関連したアクティビティ

ワークフローの実行

GitHub アクション ワークフローの実行がリクエストされたまたは完了した

Have more questions about permissions? Check out our FAQ documentation. If you can’t find the answer you’re looking for, feel free to open a work item or contact our support team. We're here to help.




さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。