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 アクション ワークフローの実行がリクエストされたまたは完了した