Microsoft Azure DevOps について
Iru は Azure DevOps REST API から、プロジェクト、リポジトリ、ブランチポリシー、プルリクエスト、ビルドパイプラインとリリースパイプライン、ユーザーとグループ、サービス接続、監査ログイベント を読み取ります。認証には Microsoft Entra ID を介した委任された OAuth 2.0 を使用し、他の Microsoft Azure ソースと同じ Launch OAuth Authentication ウィザードを使用します。職場アカウントでサインインします。Iru が個人用アクセストークンを要求することはありません。収集は、そのアカウントがすでに参照できる組織とプロジェクトに限定されます。パイプラインの 変数名 は収集されますが、シークレット値は収集されません。仕組み
vso.code、vso.build、vso.release、vso.graph、vso.audit_log などの読み取りアクセス）。個人用アクセストークンを作成したり貼り付けたりしないでください。ウィザードでは受け付けられません。
公式リファレンス: REST API の概要、OAuth 2.0 を使用した REST API へのアクセスの承認。
前提条件
- Iru に読み取らせる Azure DevOps 組織（
https://dev.azure.com/contosoのcontoso）にサインインできる Microsoft Entra ID アカウント。 - Iru に読み取らせるすべてのプロジェクトの可視性。OAuth は委任されるため、Iru はそのアカウントのプロジェクトアクセス権を継承します。プロジェクトを参照できないアカウントでは、そのプロジェクトについて何も返されません。
- Microsoft の同意画面を開けるよう、Iru サイトに対してブラウザの ポップアップ が許可されていること。プロジェクトの対象範囲を決定してください。ブランチポリシーが対象範囲外の場合、Iru はコードレビューや承認のコントロールを検証できません。
Microsoft Azure DevOps を Iru に接続する
- Azure DevOps
- Iru Compliance
Compliance でソースを接続する前に、このタブの手順を完了してください。
1
Azure DevOps にサインインする
Iru ウィザードで使用する Microsoft Entra ID アカウント（Iru に読み取らせるのと同じテナントと組織）で
https://dev.azure.com/{your-organization} にサインインします。2
プロジェクトへのアクセス権を確認する
対象範囲内のすべてのプロジェクトを開けることを確認します。Iru は、このアカウントがすでにアクセスできるものしか収集できません。
3
ブラウザでポップアップを許可する
コネクタウィザードから Microsoft の同意画面を開けるよう、Iru のホスト名に対して ポップアップ を許可します。
4
マルチテナントの注意点を確認する
会社で複数の Microsoft Entra ID テナントを使用している場合は、同じブラウザプロファイルで個人用 Microsoft アカウントからサインアウトするか、プライベートウィンドウを使用して、OAuth ポップアップで正しい職場アカウントが選択されるようにします。
5
個人用アクセストークンは作成しない
Iru は OAuth 2.0 で認証します。ウィザードに PAT を貼り付けないでください。
Iru Compliance タブに進んでください。
トラブルシューティング
ソースをオンにしても何も開かない
ソースをオンにしても何も開かない
Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
認証が失敗する、または Microsoft のウィンドウが表示されない
認証が失敗する、または Microsoft のウィンドウが表示されない
ポップアップブロッカー の設定を確認してから、正しい Microsoft Entra ID テナントの職場アカウントでサインインしてください。
リポジトリは表示されるが、ブランチポリシー、プルリクエスト、パイプラインが表示されない
リポジトリは表示されるが、ブランチポリシー、プルリクエスト、パイプラインが表示されない
サインインしたアカウントに、それらのオブジェクトへの読み取りアクセス権がありません。対象範囲内のすべてのプロジェクトを参照できるアカウントでサインインするか、管理者にそのアクセス権を付与してもらってから再接続してください。
プロジェクトがまったく表示されない
プロジェクトがまったく表示されない
OAuth を完了したアカウントがそのプロジェクトを参照できません。対象範囲内のすべてのプロジェクトにアクセスできるアカウントで再接続してください。
一定期間アクティビティがないとカードに Broken と表示される
一定期間アクティビティがないとカードに Broken と表示される
接続がアクティブな間、アクセストークンは更新されます。更新が中断された場合は、ソースをオフにしてからオンにし、OAuth を再度完了してください。これは PAT の有効期限切れではありません。Iru はこのソースで個人用アクセストークンを使用しません。
関連記事
Sources の管理
すべての Compliance ソースを参照、管理します。
Compliance を使い始める
フレームワーク、アクション、アーティファクト。
Iru の概要
Endpoint、Compliance、Identity がどのように連携するか。
Artifacts の管理
ソースやアクションから得たエビデンスをアップロード、確認、整理します。