> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure DevOps 連携

> Azure DevOps リポジトリで Devin と直接連携して作業する

<Info>
  Devin は、Microsoft Entra のサービス プリンシパルを使用した Azure DevOps への接続にも対応しており、この方法では 昇格されたディレクトリ管理者権限を持つ専用のサービス アカウントは必要ありません。要件によっては、こちらの方法のほうが適している場合があります。詳細は [Azure DevOps (Service Principal)](/ja/enterprise/integrations/azure-devops-service-principal) を参照してください。
</Info>

<div id="why-integrate-devin-with-azure-devops">
  ## なぜ Devin を Azure DevOps と連携するのか？
</div>

Devin を Azure DevOps 組織と統合すると、Devin がリポジトリをクローンしたり PR を作成したりして、チームと効果的に協働できるようになります。この統合により、既存の開発ワークフローの中で Devin をシームレスに利用できます。

他の一部の SCM との統合とは異なり、Azure DevOps ではサードパーティ製アプリが同じような形では表示されません。その代わり、すべての接続の管理は Devin 内の **Enterprise Settings > Integrations** で行います。

<div id="prerequisites">
  ## 前提条件
</div>

Azure DevOps 統合をセットアップする前に、次の内容を準備してください。

1. **Devin 専用の Azure DevOps ユーザーを作成する** - Devin 専用の新しい Azure DevOps アカウント (例: `devin@yourcompany.com`) を作成します。この専用サービスアカウントにより、アクセス管理と監査ログを明確に分離できます。

2. **Devin ユーザーに十分な管理者ロールを付与する** - 新しく作成した Devin サービスアカウントは、テナントに対する管理者の同意を付与できる必要があります (Application Administrator、Cloud Application Administrator、または Global Administrator)。十分な権限を持つ管理者がテナントレベルで同意を付与しない限り、Microsoft はサードパーティアプリケーションのアクセスを制限します。

3. **接続フローの準備をする** - 連携を完了するには、次の状態である必要があります:
   * 個人アカウントで **Devin** にサインインしている
   * Devin サービスアカウント (テナントに対する管理者の同意を付与できる新しいアカウント) で **Azure DevOps** にサインインしている

<Note>
  統合のセットアップ中は、両方のブラウザーセッションがアクティブである必要があります。接続を開始するための Devin アカウントと、OAuth 同意を承認するための Azure DevOps 上の Devin サービスアカウントの両方です。
</Note>

<div id="authentication-and-permissions">
  ## 認証と権限
</div>

Devin は Microsoft の MSAL (Microsoft Authentication Library) を利用した OAuth 2.0 によって Azure DevOps に接続します。OAuth フローを完了するには、Devin のサービスアカウントがテナントに対して管理者の同意を付与できる必要があります (Application Administrator、Cloud Application Administrator、または Global Administrator) 。Azure DevOps はサービスアカウント経由で動作するため、Devin は登録済みアプリではなく、権限が付与された Devin のユーザー ID を使用して接続します。

<div id="rbac-and-permission-model">
  ### RBAC と権限モデル
</div>

Devin の Azure DevOps 連携は、認証と認可を分離した厳格なロールベースのアクセス制御 (RBAC) モデルで構築されています。これにより、Devin は Enterprise の管理者によって明示的に許可されたリポジトリにのみアクセスします。

Azure DevOps を Devin に接続すると、次の処理が行われます。

1. 暗号化されたリフレッシュトークンを含み、ユーザーアイデンティティに紐づいた接続レコードが作成される
2. Devin が、アクセス可能な組織、プロジェクト、およびリポジトリを定義する権限レコードを生成する
3. 実行時には、すべてのリポジトリに対してチェックが行われ、アクセス境界を強制するために権限リストと突き合わせられる

Enterprise のお客様の場合、権限は複数の組織間で再利用でき、すべてのリポジトリレベルのアクセスは、Integrations 配下の **Devin Enterprise UI** から管理されます。

<div id="azure-devops-hierarchy">
  ## Azure DevOps の階層構造
</div>

Azure DevOps では、3 階層の構造 **Organization > Project > Repository** を採用しています。Devin はこの階層構造を内部で扱っており、接続しているユーザーにアクセス権がある限り、どの階層にあるリポジトリでも検出して操作できます。

<div id="setting-up-the-integration">
  ## 統合のセットアップ
</div>

1. **両方のアカウントにサインインします：**
   * [app.devin.ai](https://app.devin.ai) で Devin アカウントにサインインします
   * 別のブラウザまたはシークレットウィンドウで、Devin サービスアカウント (テナントに対する管理者の同意を付与できるアカウント) を使用して Azure DevOps にサインインします

2. Enterprise の Devin アカウントで、[**Settings > Enterprise Settings > Integrations**](https://app.devin.ai/settings/integrations) に移動します。

<Frame>
  <img src="https://mintcdn.com/cognitionai/IUVOuadgM9g1fi9k/images/enterprise/Connect-ADO.png?fit=max&auto=format&n=IUVOuadgM9g1fi9k&q=85&s=682dac6971ec445fbc868a56acf66845" alt="Azure DevOps Connected Accounts" width="3590" height="1856" data-path="images/enterprise/Connect-ADO.png" />
</Frame>

3. Integrations ページで、**Connect to Azure DevOps** ボタンをクリックします。

<Frame>
  <img src="https://mintcdn.com/cognitionai/IUVOuadgM9g1fi9k/images/enterprise/Connect-To-ADO.png?fit=max&auto=format&n=IUVOuadgM9g1fi9k&q=85&s=f82bd2325d80b96ec62479f09586b91b" alt="Connect To Azure DevOps" width="1240" height="508" data-path="images/enterprise/Connect-To-ADO.png" />
</Frame>

4. 新しいブラウザタブが開き、Devin に Azure DevOps Organization へのアクセス権限を付与するよう求められます。**Devin サービスアカウント (テナントに対する管理者の同意を付与できるアカウント) でサインインしていることを必ず確認してください。**

<Frame>
  <div style={{maxWidth: '400px', margin: '0 auto'}}>
    <img src="https://mintcdn.com/cognitionai/ifLkKLaMB-vvINwf/images/enterprise/ADO-Permission.png?fit=max&auto=format&n=ifLkKLaMB-vvINwf&q=85&s=b9389036b537d7f476ad94991a36f26e" alt="Azure DevOps Permissions" width="930" height="1224" data-path="images/enterprise/ADO-Permission.png" />
  </div>
</Frame>

5. 権限を付与すると、Enterprise Settings の Integrations ページに、Azure DevOps 統合と接続済みリポジトリが表示されます。

<Frame>
  <img src="https://mintcdn.com/cognitionai/IUVOuadgM9g1fi9k/images/enterprise/ADO-Org-in-Devin.png?fit=max&auto=format&n=IUVOuadgM9g1fi9k&q=85&s=c8097e83087683a6036bd71a045d7db4" alt="Azure DevOps Integrated" width="1216" height="1118" data-path="images/enterprise/ADO-Org-in-Devin.png" />
</Frame>

6. Devin が Azure DevOps にアクセスできるようになったら、Enterprise アカウント配下の任意またはすべての Sub-Organization に権限を付与できます。これを行うには、Azure DevOps 統合で **Git Permissions** を選択し、Sub-Organization を選択して、Group または Repository レベルで権限を付与します。

<Frame>
  <img src="https://mintcdn.com/cognitionai/IUVOuadgM9g1fi9k/images/enterprise/ADO-git-permissions.png?fit=max&auto=format&n=IUVOuadgM9g1fi9k&q=85&s=765a3e9cdbc8da18001b0cc268e72e64" alt="Azure DevOps Git Permissions" width="2414" height="630" data-path="images/enterprise/ADO-git-permissions.png" />
</Frame>

7. 権限を付与した各 Organization について、**Devin's Settings > Devin's Machine** に移動し、**+ Repository** をクリックして、リポジトリを Devin's Machine に連携します。

<div id="what-devin-can-access">
  ## Devin がアクセスできる内容
</div>

Devin の Azure DevOps 連携は、以下を含む **Git 操作のみに特化** しています：

| Capability           | Description              |
| -------------------- | ------------------------ |
| List repositories    | 利用可能なリポジトリとそのメタデータを表示    |
| Read branches        | ブランチ情報とコミット履歴にアクセス       |
| Create pull requests | コード変更のための新しい PR を作成      |
| View pull requests   | PR のイベント、コメント、ステータスにアクセス |
| Push code            | 新しいブランチとコミットをリポジトリにプッシュ  |

<div id="what-devin-cannot-access">
  ## Devin がアクセスできないもの
</div>

この連携機能は、意図的に Git の機能のみに範囲を限定しています。Devin は次のものに **アクセスできません**:

* Work items (boards)
* Pipelines or builds
* Test plans
* Artifacts
* Wiki
* Service connections

<Note>
  将来的に、組織として Devin にこれらの追加領域もサポートさせる必要がある場合は、より広範な OAuth スコープと新しいプロバイダー ロジックが必要になります。要件についてご相談の際は、[enterprise@cognition.ai](mailto:enterprise@cognition.ai) までご連絡ください。
</Note>

<div id="security-considerations">
  ## セキュリティ上の考慮事項
</div>

このシステムは、最小特権の原則に基づいて設計されています。

* **OAuth は権限を付与し、RBAC が境界を強制する** - OAuth は Azure DevOps へアクセスするための技術的な権限を付与しますが、実際のアクセス境界は追加の Git 権限レイヤーによって強制されます
* **明示的なアクセスのみ** - Devin は、Enterprise UI で明示的に付与されていないリポジトリやプロジェクトには決してアクセスしません
* **認証情報の暗号化** - すべてのリフレッシュトークンは暗号化され、安全に保存されます
* **監査証跡** - 専用のサービスアカウントを使用することで、Azure DevOps の監査ログで Devin のアクティビティを追跡しやすくなります
* **ブランチポリシーの順守** - Devin の PR は、他のコントリビューターと同じブランチポリシーおよびレビュー要件の対象となります

<div id="best-practices">
  ## ベストプラクティス
</div>

* **専用の Devin サービスアカウントを使用する** - 個人アカウントではなく、Devin 用に作成された専用の Azure DevOps アカウントを必ず利用してください
* **ブランチポリシーを有効化する** - マージ前にすべての変更が適切なレビュープロセスを経るようにするため、Azure DevOps でブランチポリシーを設定してください
* **リポジトリレベルの権限を使用する** - 組織全体へのアクセスを付与するのではなく、Devin には必要な特定のリポジトリにのみアクセス権を付与してください
* **アクセスログを監視する** - Devin のアクティビティについて、Azure DevOps の監査ログを定期的に確認してください
* **セットアップ内容を文書化する** - Devin にどのリポジトリへのアクセス権を付与しているかと、その理由を社内ドキュメントとして管理してください

<Tip>
  すべての変更がマージ前に適切なレビュープロセスを経るようにするため、Azure DevOps でブランチポリシーを設定することを推奨します。
</Tip>

<Note>
  Microsoft Entra ID が組織の HRIS (Human Resources Information System / 人事情報システム) と連携している場合、Azure DevOps との連携を完了するために、追加の構成手順が必要になることがあります。高度なセットアップについては、[Devin サポートチーム](mailto:enterprise@cognition.ai)までお問い合わせください。
</Note>

<div id="troubleshooting">
  ## トラブルシューティング
</div>

**OAuth 同意が失敗する場合:**

* Devin サービスアカウントがそのテナントに対して管理者の同意を付与できることを確認してください (Application Administrator、Cloud Application Administrator、または Global Administrator ロールが必要です)
* Microsoft Entra ID テナントでサードパーティアプリケーションへの同意が許可されていることを確認してください
* OAuth フローを完了する際に、個人アカウントではなく Devin サービスアカウントで Azure DevOps にサインインしていることを確認してください

**Devin からリポジトリが見えない場合:**

* Devin サービスアカウントが Azure DevOps 上の該当リポジトリにアクセスできることを確認してください
* Devin の Enterprise Settings でリポジトリの権限が付与されていることを確認してください
* リポジトリが Devin's Machine に追加されていることを確認してください

**プルリクエスト (PR) の作成に失敗する場合:**

* Devin サービスアカウントが対象リポジトリに対する Contributer 権限を持っていることを確認してください
* ブランチポリシーが PR の作成をブロックしていないことを確認してください
* 対象ブランチが存在し、アクセス可能であることを確認してください

<div id="network-setup">
  ## ネットワーク設定
</div>

Azure DevOps インスタンスで IP フィルタリングが有効になっている場合は、Devin の IP アドレスを許可リストに追加する必要があります。

最新の一覧については、[IP 許可リストに関するドキュメント](/ja/admin/common-issues#ip-whitelisting)を参照してください。