> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Microsoft Azure DevOps
> Microsoft Entra ID の OAuth を使用して Microsoft Azure DevOps を Iru Compliance に接続し、プロジェクト設定、リポジトリ、ブランチポリシー、プルリクエスト、パイプライン、権限、組織の監査アクティビティを収集します。
### Microsoft Azure DevOps について
Iru は Azure DevOps REST API から、**プロジェクト**、**リポジトリ**、**ブランチポリシー**、**プルリクエスト**、**ビルドパイプラインとリリースパイプライン**、**ユーザーとグループ**、**サービス接続**、**監査ログイベント** を読み取ります。認証には **Microsoft Entra ID** を介した委任された **OAuth 2.0** を使用し、他の Microsoft Azure ソースと同じ **Launch OAuth Authentication** ウィザードを使用します。職場アカウントでサインインします。Iru が個人用アクセストークンを要求することはありません。収集は、そのアカウントがすでに参照できる組織とプロジェクトに限定されます。パイプラインの **変数名** は収集されますが、**シークレット値は収集されません**。
### 仕組み
```http theme={null}
OAuth 2.0 authorization code flow (Microsoft Entra ID)
```
Iru は Azure DevOps に対して Microsoft の OAuth 2.0 認可コードフローを使用します。ポップアップでサインインして同意すると、Iru は有効期間の短いアクセストークンを受け取り、自動的に更新します。要求されるスコープは Azure DevOps の権限モデルに従います（`vso.code`、`vso.build`、`vso.release`、`vso.graph`、`vso.audit_log` などの読み取りアクセス）。個人用アクセストークンを作成したり貼り付けたりしないでください。ウィザードでは受け付けられません。
| 項目 | 値 |
| - | - |
| **カテゴリ** | 開発者ツール |
| **認証** | OAuth 2.0（Microsoft Entra ID） |
公式リファレンス: [REST API の概要](https://learn.microsoft.com/en-us/rest/api/azure/devops/)、[OAuth 2.0 を使用した REST API へのアクセスの承認](https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/oauth)。
### 前提条件
* Iru に読み取らせる Azure DevOps 組織（`https://dev.azure.com/contoso` の `contoso`）にサインインできる **Microsoft Entra ID** アカウント。
* Iru に読み取らせるすべてのプロジェクトの可視性。OAuth は委任されるため、Iru はそのアカウントのプロジェクトアクセス権を継承します。プロジェクトを参照できないアカウントでは、そのプロジェクトについて何も返されません。
* Microsoft の同意画面を開けるよう、Iru サイトに対してブラウザの **ポップアップ** が許可されていること。プロジェクトの対象範囲を決定してください。ブランチポリシーが対象範囲外の場合、Iru はコードレビューや承認のコントロールを検証できません。
### Microsoft Azure DevOps を Iru に接続する
Compliance でソースを接続する前に、このタブの手順を完了してください。
Iru ウィザードで使用する **Microsoft Entra ID** アカウント（Iru に読み取らせるのと同じテナントと組織）で `https://dev.azure.com/{your-organization}` にサインインします。
対象範囲内のすべてのプロジェクトを開けることを確認します。Iru は、このアカウントがすでにアクセスできるものしか収集できません。
コネクタウィザードから Microsoft の同意画面を開けるよう、Iru のホスト名に対して **ポップアップ** を許可します。
会社で複数の Microsoft Entra ID テナントを使用している場合は、同じブラウザプロファイルで個人用 Microsoft アカウントからサインアウトするか、プライベートウィンドウを使用して、OAuth ポップアップで正しい職場アカウントが選択されるようにします。
Iru は OAuth 2.0 で認証します。ウィザードに PAT を貼り付けないでください。
[**Iru Compliance**](#iru-compliance) タブに進んでください。
先に [**Azure DevOps**](#azure-devops) タブの手順を完了してください。
Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。
**Microsoft Azure DevOps** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードで **トグル** をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
**Launch OAuth Authentication** を選択します。ウィザードに **Perform OAuth Authentication** と表示されます。
Microsoft のウィンドウが開いたら、Azure DevOps で確認したのと同じ職場アカウントでサインインし、同意画面で **Accept** を選択します。
OAuth ウィンドウが閉じて Iru が交換を完了すると、ウィザードに **接続が構成されました** と表示されます。ウィザードで **組織** 名も求められた場合は、名前のみを入力します（例: `contoso`。完全な URL ではありません）。
**Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Microsoft Azure DevOps** カードが **有効** になっていることを確認します。
### トラブルシューティング
Iru サイトの **ポップアップブロッカー** の設定を確認して、もう一度お試しください。
**ポップアップブロッカー** の設定を確認してから、正しい Microsoft Entra ID テナントの職場アカウントでサインインしてください。
サインインしたアカウントに、それらのオブジェクトへの読み取りアクセス権がありません。対象範囲内のすべてのプロジェクトを参照できるアカウントでサインインするか、管理者にそのアクセス権を付与してもらってから再接続してください。
OAuth を完了したアカウントがそのプロジェクトを参照できません。対象範囲内のすべてのプロジェクトにアクセスできるアカウントで再接続してください。
接続がアクティブな間、アクセストークンは更新されます。更新が中断された場合は、ソースをオフにしてからオンにし、OAuth を再度完了してください。これは PAT の有効期限切れではありません。Iru はこのソースで個人用アクセストークンを使用しません。
### 関連記事
すべての Compliance ソースを参照、管理します。
フレームワーク、アクション、**アーティファクト**。
Endpoint、Compliance、Identity がどのように連携するか。
ソースやアクションから得たエビデンスをアップロード、確認、整理します。