DevOpsツールに必要な権限

サードパーティツールで DevOps チェンジベロシティ に接続するために必要な権限。

Azure DevOps の権限

重要:

Azure DevOps の次の表で指定されたアクセス レベルのアクセス許可と ServiceNow DevOps 拡張機能を使用すると、ServiceNow から Azure DevOps に接続できます。Azure DevOps アドミンは、Azure DevOps で Webhook とサービス接続を手動で構成する必要はありません。

重要:

• プロジェクトをオンボーディングする場合、 プロジェクト管理者 権限では、PAT の所有者がプロジェクトの プロジェクト管理者 グループのメンバーである必要があります。
• 組織をオンボードする場合、 プロジェクト管理者 特権では、PAT の所有者が組織の プロジェクト コレクション管理者 グループのメンバーである必要があります。

オブジェクト	必要な権限	影響
作業アイテム	読み込み	インポート、ポーリング、または構成された Webhook を使用したリアルタイムで、ボードを検出し、作業アイテムを受信するために必要です。
コード	読み込み	インポート、ポーリング、または構成された Webhook を使用したリアルタイムで、リポジトリを検出し、分岐、コミット、およびタグを受信するために必要です。
Build (構築)	読み取りと実行	読み取り:インポート、ポーリング、または構成された Webhook を使用してリアルタイムで、ビルドパイプラインを検出し、パイプライン実行の詳細 (ステージ、アーティファクト、テスト結果、コードセキュリティ結果など) を受信するために必要です。 実行:変更コントロールステップに基づいてパイプラインを一時停止または再開するために必要です。
リリース	読み取り、書き込み、実行	読み取り:インポート、ポーリング、または構成された Webhook を使用してリアルタイムで、リリースパイプラインを検出し、パイプライン実行の詳細 (ステージ、アーティファクト、テスト結果、コードセキュリティ結果など) を受信するために必要です。 書き込みと実行:変更コントロールステップに基づいてパイプラインを一時停止または再開するために必要です。
テスト管理	読み込み	パイプライン実行のテスト結果を受信するために必要です。
サービス接続	読み取り、クエリ、管理	変更の促進、アーティファクト、パッケージ登録などの ServiceNow タスクを構成するために使用されるサービス接続を自動的に作成するために必要です。
包装	読み込み	インポート、ポーリング、または構成された Webhook を使用したリアルタイムで、アーティファクトリポジトリを検出し、フィードとパッケージを受信するために必要です。
権限	プロジェクトアドミニストレーター	Webhook を自動的に作成して、リアルタイムでデータを受信し、変更の促進、アーティファクト、パッケージ登録などの ServiceNow タスクを構成するために使用されるサービス接続を自動的に作成するために必要です。

Azure DevOps の制限事項

カスタム定義のアクセスレベルで Azure ツールを作成し、統合ユーザー認証情報の変更のためにそのようなツールを再構成した場合、作成されたリリースとリリースデプロイの既存のサービスフックは更新されません。代わりに、2 つの新しいサービスフックが新しい構成の詳細で作成されます。これらのサービス フックの重複を回避するには、フル アクセス レベルでツールを作成する必要があります。

Bitbucket

オブジェクト	必要な権限	影響
権限	アドミン	インポート、ポーリング、または構成された Webhook を使用して、リポジトリを検出し、分岐、コミット、およびタグをフェッチするために必要です。

GitHub の権限

次の表に、ベーシック認証の GitHub アクセス許可を示します。

オブジェクト	必要な権限	影響
repo	repo	インポート、ポーリング、または構成された Webhook を使用したリアルタイムで、リポジトリとその各ワークフローを検出し、分岐、コミット、プル要求、およびタグを受信するために必要です。
admin:repo_hook	write:repo_hook	Webhook を自動的に作成して、リポジトリデータをリアルタイムで受信するために必要です。
admin:repo_hook	read:repo_hook	リポジトリデータをリアルタイムで受信する新しい Webhook が自動的に作成される前に、既存の Webhook を検索するために必要です。
user	user:email	インポート、ポーリング、または構成された Webhook を使用してリアルタイムで、プル要求アクター (承認者、作成者、結合担当者、レビュー担当者、アサイニーなど) を検出するために必要です。

次の表に、OAuth 2.0 認証に必要な GitHub 権限を示します。

オブジェクト	必要な権限	影響
アクション	読み込み専用	構成された Webhook を使用して、各リポジトリに関連付けられたワークフローをリアルタイムで受信するために必要です。
コンテンツ	読み込み専用	インポート/ポーリングを使用するか、構成された Webhook を使用してリアルタイムで、リポジトリとその各ワークフローを検出し、分岐、コミット、およびタグを受信するために必要です。
展開	読み取りと書き込み	ServiceNow の変更を環境シークレットとして持つ環境があるワークフローを再開するために必要です。
環境	読み込み専用	変更の作成のために既存の環境シークレットを検索するために必要です。
メタデータ	読み込み専用	リポジトリとその各ワークフローを検出するために必要です。
シークレット	読み込み専用	環境シークレットにアクセスするために必要です (変更を作成するため)。
Webhook	読み取りと書き込み 注: ServiceNow から Webhook を構成するには、読み取りおよび書き込み権限が必要です。	Webhook を自動的に作成して、リポジトリデータをリアルタイムで受信するために必要です。
プル要求	読み込み専用	インポート/ポーリングを使用するか、構成された Webhook を使用してリアルタイムで、プル要求を検出し、関連詳細 (プル要求 ID、コミット、作成者、承認者、コメント、レビュー担当者など) を受信するために必要です。
チェック	読み込み専用	プライベートリポジトリに関連付けられたワークフローイベントを処理するために必要です。

注:

GitHub アプリを使用して接続していて、権限チェックで問題が発生している場合は、GitHub アプリのクライアント ID プレフィックスが DevOps プロパティの GitHub アプリのクライアント ID 指定子で利用可能であることを確認してください。詳細については、「DevOps プロパティにクライアント ID を追加」を参照してください。

GitLab の権限

オブジェクト	必要な権限	影響
api	読み取りと書き込み	インポート、ポーリングを使用するか、構成された Webhook を使用してリアルタイムで、リポジトリとパイプラインを検出し、分岐、コミット、タグ、およびパイプライン実行の詳細 (ステージ、アーティファクト、テスト結果、コードセキュリティ結果など) を受信するために必要です。また、変更コントロールステップに基づいてパイプラインを一時停止または再開します。

Jenkins の権限

オブジェクト	必要な権限	影響
全体	読み込み	インポート、ポーリングを使用するか、プラグインを使用してリアルタイムで、パイプラインを検出し、パイプライン実行の詳細 (ジョブまたはステージ、アーティファクト、テスト結果、コードセキュリティ結果など) ServiceNow DevOps Jenkins 受信するために必要です。
ジョブ	読み込み	インポート、ポーリングを使用するか、プラグインを使用してリアルタイムで、パイプラインを検出し、パイプライン実行の詳細 (ジョブまたはステージ、アーティファクト、テスト結果、コードセキュリティ結果など) ServiceNow DevOps Jenkins 受信するために必要です。

JFrog の権限

オブジェクト	必要な権限	影響
ロール	プラットフォームを管理	アーティファクト名、アーティファクトリポジトリ、アーティファクトバージョンなどのアーティファクトの詳細にアクセスするために必要です。

Jira の権限

オブジェクト	必要な権限	影響
グループ	jira-software-users	インポート、ポーリング、または構成された Webhook を使用して、計画を検出し、機能、ストーリーなどをフェッチするために必要です。
権限	Jira アドミニストレーター	機能とストーリーをリアルタイムでフェッチするための Webhook を自動的に作成するために必要です。