> ## 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.

# Enterprise ポリシー

> Enterprise ポリシーを使用すると、Devin Desktop の設定を一元管理できます。Windows、macOS、Linux で、グループポリシー、構成プロファイル、JSON ポリシーファイルを使って、拡張機能の許可リスト、更新モード、その他の設定を構成できます。

<div id="enterprise-policies-for-extension-management">
  # 拡張機能管理向け Enterprise ポリシー
</div>

Devin Desktop の Enterprise ポリシーを利用すると、組織は開発チームのエディタ設定を一元的に管理し、組織全体で一貫性とセキュリティを確保できます。ポリシー値が設定されると、Devin Desktop で任意のレベル (デフォルト、ユーザー、ワークスペース) に設定された内容より優先されます。

IT 管理者は、さまざまなデバイス管理ソリューションを通じて、ユーザーのデバイスに特定の Devin Desktop 設定を展開し、強制できます。Devin Desktop は、**Windows**、**macOS**、**Linux** でのポリシー適用をサポートしています。

<Note>
  Devin Desktop では、VS Code とは別の独自のポリシーパスを使用します。VS Code 用に設定したポリシーは Devin Desktop には適用されず、逆も同様です。
</Note>

***

<div id="windows-group-policies">
  ## Windows グループ ポリシー
</div>

Devin Desktop は、[レジストリ ベースの Windows グループ ポリシー](https://learn.microsoft.com/en-us/windows/client-management/group-policies-overview) をサポートしています。ポリシーは、モバイル デバイス管理 (MDM) ソリューションを使用して展開することも、各デバイスで手動で構成することもできます。

<Note>
  Devin Desktop は、レジストリ パス `Software\Policies\Windsurf\{ProductName}` (例: `Software\Policies\Windsurf\Windsurf` または `Software\Policies\Windsurf\WindsurfInsiders`) からポリシーを読み取ります。これは、`Software\Policies\Microsoft\{ProductName}` から読み取る VS Code とは異なります。
</Note>

<div id="step-1-obtain-the-admx-and-adml-files">
  ### Step 1: ADMX ファイルと ADML ファイルを取得する
</div>

Devin Desktop の各リリースには、利用可能なポリシーを定義する ADMX テンプレート ファイルを含む `policies` ディレクトリが含まれています。

既存の Devin Desktop のインストールから ADMX ファイルと ADML ファイルを取得できます。

1. Devin Desktop のインストール ディレクトリに移動します。
2. `policies` フォルダーを探します。このフォルダーには、ADMX テンプレート ファイル (例: `windsurf.admx`) と、さまざまな言語向けの ADML ファイルを含む `locales` サブフォルダーが含まれています。

または、Devin Desktop の zip アーカイブをダウンロードして展開し、展開したファイル内にある `policies` フォルダーを探してください。

<div id="step-2-install-the-policy-definition-files">
  ### ステップ 2: ポリシー定義ファイルをインストールする
</div>

1. `windsurf.admx` ファイルを `C:\Windows\PolicyDefinitions` にコピーします。
2. `locales` サブフォルダーから適切な ADML ファイル (例: `en-US\windsurf.adml`) を `C:\Windows\PolicyDefinitions\<your-locale>` (例: `C:\Windows\PolicyDefinitions\en-US`) にコピーします。

<Note>
  `PolicyDefinitions` ディレクトリにファイルをコピーするには、管理者権限が必要です。
</Note>

Active Directory 環境では、ポリシーをドメイン全体で利用できるようにするため、ADMX ファイルと ADML ファイルを [Central Store](https://learn.microsoft.com/en-us/troubleshoot/windows-client/group-policy/create-and-manage-central-store) にコピーしてください。

<div id="step-3-deploy-the-policies">
  ### ステップ 3: ポリシーを展開する
</div>

設定済みのポリシーは、MDM ソリューションを使用して大規模に展開することも、ローカル グループ ポリシー エディター を使用してローカル マシン上で手動でテストすることもできます。

<div id="deploy-at-scale">
  #### 大規模展開
</div>

[Microsoft Intune](https://www.microsoft.com/en-us/security/business/microsoft-intune) や Active Directory グループ ポリシーなどの製品を利用すると、デバイス ポリシーを大規模に一元管理できます。これらの解決策により、管理者は ADMX/ADML ファイルとポリシー設定を一元的な場所から複数のデバイスに展開できます。

<div id="manually-test-policies-on-a-local-machine">
  #### ローカル マシンでポリシーを手動でテストする
</div>

ローカルの Windows マシンでローカル グループ ポリシー エディターを使って Devin Desktop のポリシーを設定するには、以下の手順に従ってください。

1. **ローカル グループ ポリシー エディターを開く:**
   * `Windows+R` を押して「ファイル名を指定して実行」ダイアログを開きます。
   * `gpedit.msc` と入力し、Enter キーを押します。
   * ユーザー アカウント制御の確認が表示された場合は、**はい** を選択します。

2. **Windsurf のポリシーに移動する:**
   * **コンピューターの構成** > **管理用テンプレート** > **Windsurf**
   * **ユーザーの構成** > **管理用テンプレート** > **Windsurf**

<Tip>
  コンピューターレベルとユーザーレベルの両方でポリシーが設定されている場合は、コンピューターレベルのポリシーが優先されます。
</Tip>

3. **ポリシーを設定する:**
   * 設定するポリシー (例: **AllowedExtensions**) をダブルクリックします。
   * ポリシーを適用するには、**有効** を選択します。
   * 文字列ポリシー (例: `AllowedExtensions`) の場合は、テキスト フィールドに値を入力します。例: `{"publisher1": true, "publisher2": true}`。
   * ブール値ポリシー (例: **EnableTelemetry**) では、**有効** または **無効** を選択すると値が設定されます。
   * 変更を保存するには、**OK** を選択します。

<Warning>
  文字列ポリシーの値に構文エラー (例: 不正な JSON) がある場合、設定は適用されません。エラーは Devin Desktop の Window ログで確認できます (`Ctrl+Shift+P` で Command Palette を開き、**Show Window Log** と入力します) 。
</Warning>

ポリシーは次回 Devin Desktop の起動時に有効になります。

***

<div id="macos-configuration-profiles">
  ## macOS構成プロファイル
</div>

構成プロファイルは、macOS デバイスの設定を管理するためのものです。プロファイルは、利用可能なポリシーに対応するキーと値のペアを含む XML ファイル (`.mobileconfig`) です。

これらのプロファイルは、モバイル デバイス管理 (MDM) ソリューションを使用して展開することも、各デバイスに手動でインストールすることもできます。

<div id="step-1-obtain-the-sample-configuration-profile">
  ### ステップ 1: サンプル構成プロファイルを入手する
</div>

Devin Desktop の各リリースには、サンプルの `.mobileconfig` ファイルが付属しています。Devin Desktop がインストールされている macOS デバイスでサンプルファイルを探すには、次の手順に従います。

1. Finder を開き、`/Applications` に移動します。
2. **Devin.app** を右クリックし、**パッケージの内容を表示** を選択します。
3. `Contents/Resources/app/policies` に移動します。
4. サンプルの `.mobileconfig` ファイルを見つけます。

### ステップ 2: ポリシー値を設定する

1. サンプルの `.mobileconfig` ファイルを作業しやすい場所 (例: デスクトップまたは Documents フォルダ) にコピーします。
2. コピーしたファイルをテキストエディタで開きます。
3. 要件に合わせてポリシー値を編集します。

**文字列ポリシー** — テキスト値または JSON 文字列を受け付けるポリシー:

```xml theme={null}
<!-- 例: 特定のパブリッシャーからの拡張機能を許可する -->
<key>AllowedExtensions</key>
<string>{"publisher1": true, "publisher2": true}</string>
```

**ブール値ポリシー** — true/false の値を受け付けるポリシー:

```xml theme={null}
<!-- 例: ユーザーフィードバックを有効にする -->
<key>EnableFeedback</key>
<true/>

<!-- 例: テレメトリを無効にする -->
<key>EnableTelemetry</key>
<false/>
```

**不要なポリシーを削除** — 適用したくないポリシーは、キーと値の両方を削除してください。

<Warning>
  ポリシーの値に構文エラーがある場合、その設定は適用されません。エラーは Devin Desktop の Window ログで確認できます (`⌘+Shift+P` で Command Palette を開き、**Show Window Log** と入力します) 。
</Warning>

### ステップ3：ポリシーをデプロイする

<div id="deploy-at-scale">
  #### 大規模展開
</div>

複数のデバイスにわたるEnterprise向けの展開では、MDM対応のApple Business Managerなどのモバイルデバイス管理 (MDM) ソリューションを利用します。

構成プロファイルの詳細については、[構成プロファイルに関するAppleのドキュメント](https://support.apple.com/guide/deployment/intro-to-mdm-profiles-depc0aadd3fe/web)を参照してください。

#### ローカルマシンでポリシーを手動でテストする

1. **構成プロファイルをインストールする:**
   * 編集した `.mobileconfig` ファイルを保存します。
   * Finder で `.mobileconfig` ファイルをダブルクリックします。
   * **システム設定** が開きます。プロファイルの詳細を確認し、**インストール** を選択します。
   * 求められた場合は、管理者の認証情報を使用して認証します。

2. **プロファイルのインストールを確認する:**
   * **システム設定** を開きます。
   * **プライバシーとセキュリティ** > **プロファイル** (古いバージョンでは **一般** > **デバイス管理**) に移動します。
   * 一覧に Devin Desktop の構成プロファイルが表示されていることを確認します。
   * Devin Desktop を起動し、ポリシーが適用されていることを確認します。

<Note>
  ポリシーは、新しい Devin Desktop インスタンスにすぐに適用されます。Devin Desktop がすでに起動している場合は、再起動が必要になることがあります。
</Note>

<div id="remove-a-configuration-profile">
  #### 構成プロファイルを削除する
</div>

ポリシーを解除してデフォルト設定に戻すには、次の手順を実行します。

1. **システム設定** > **プライバシーとセキュリティ** > **プロファイル** を開きます。
2. Devin Desktop の構成プロファイルを選択します。
3. **Remove** (または **-**) ボタンを選択します。
4. 削除を確定するため、管理者の認証情報を使って認証します。

***

<div id="linux-json-policies">
  ## Linux JSON ポリシー
</div>

Linux デバイスでは、JSON ポリシーファイルを `/etc/windsurf/policies/policy.json` に配置することで、Devin Desktop の設定ポリシーを構成できます。この方法では、シンプルな JSON 形式でポリシー値を定義します。

<Note>
  Devin Desktop は `/etc/windsurf/policies/policy.json` からポリシーを読み込みます。一方、VS Code では `/etc/vscode/policy.json` を利用します。Devin Desktop では、必ず正しい場所にファイルを配置してください。
</Note>

<div id="step-1-obtain-the-sample-policy-file">
  ### Step 1: サンプルポリシーファイルを入手する
</div>

各 Devin Desktop リリースには、サンプルの `policy.json` ファイルが付属しています。既存のインストール環境から入手でき、Devin Desktop のインストールパス内にある `resources/app/policies` ディレクトリに配置されています。

<div id="step-2-configure-policy-values">
  ### ステップ 2: ポリシーの値を設定する
</div>

1. サンプルの `policy.json` ファイルを作業用ディレクトリにコピーします:

```bash theme={null}
sudo cp /path/to/windsurf/resources/app/policies/policy.json /tmp/policy.json
```

2. お好みのテキストエディタでファイルを編集します:

```bash theme={null}
sudo nano /tmp/policy.json
```

3. ポリシーの値を設定します。たとえば、特定の拡張機能の発行元のみを許可するには:

```json theme={null}
{
  "AllowedExtensions": "{\"publisher1\": true, \"publisher2\": true}",
  "UpdateMode": "manual"
}
```

### ステップ3：ポリシーをデプロイする

<div id="deploy-at-scale">
  #### 大規模展開
</div>

複数のデバイスにまたがる大規模な Linux 環境では、**Ansible**、**Puppet**、**Chef**、**Salt** などの構成管理ツールを利用して `policy.json` ファイルを展開します。これらのツールを使うと、管理者は管理対象のすべての Linux デバイスに対して、ポリシーの展開、更新、削除をリモートで行えます。

#### ローカルマシンでポリシーを手動でテストする

1. **ポリシー用ディレクトリを作成し、ファイルをコピーします。**

```bash theme={null}
sudo mkdir -p /etc/windsurf/policies
sudo cp /tmp/policy.json /etc/windsurf/policies/policy.json
sudo chmod 644 /etc/windsurf/policies/policy.json
sudo chown root:root /etc/windsurf/policies/policy.json
```

<Note>
  `/etc/windsurf/policies` にディレクトリを作成し、ポリシーファイルを管理するには、root または sudo 権限が必要です。
</Note>

2. **ポリシーがインストールされていることを確認します。**
   * Devin Desktop を起動します (すでに起動している場合は再起動します) 。
   * **File** > **Preferences** > **Settings** を開きます (または `Ctrl+,` を押します) 。
   * 構成済みのポリシーに対応する設定を探します。組織によって管理されていることを示す表示、またはロックアイコンが表示されているはずです。

<div id="remove-policies">
  #### ポリシーの削除
</div>

すべてのポリシーを削除してデフォルト設定に戻すには、`/etc/windsurf/policies/policy.json` ファイルを削除し、Devin Desktop を再起動してください。

***

<div id="extension-management-policies">
  ## 拡張機能管理ポリシー
</div>

Enterprise ポリシーの最も一般的な用途の 1 つは、ユーザーがインストールできる拡張機能を制御することです。`AllowedExtensions` ポリシーを利用すると、管理者は許可された拡張機能発行元の許可リストを定義できます。

<div id="allowedextensions">
  ### AllowedExtensions
</div>

`AllowedExtensions` ポリシーは、許可する拡張機能の発行元を指定する JSON 文字列を受け付けます。このポリシーがアクティブな場合、ユーザーは一覧にある発行元の拡張機能のみをインストールできます。

**例の値:**

```json theme={null}
{"windsurf": true, "github": true, "ms-python": true}
```

これは、前述のプラットフォーム固有のいずれかの方法で設定できます。

* **Windows:** グループ ポリシーの ADMX テンプレート、またはレジストリの `Software\Policies\Windsurf\{ProductName}` で設定します。
* **macOS:** `.mobileconfig` 構成プロファイルで設定します。
* **Linux:** `/etc/windsurf/policies/policy.json` で設定します。

`AllowedExtensions` ポリシーが適用されると、Devin Desktop の拡張機能ビューには、その設定が組織によって管理されていることが表示され、ユーザーはそれを上書きできません。

***

<div id="additional-resources">
  ## 追加リソース
</div>

* [Enterprise 管理者向け Devin Desktop ガイド](/ja/desktop/guide-for-admins)