メインコンテンツへスキップ

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 ポリシー

Devin Desktop の Enterprise ポリシーを利用すると、組織は開発チームのエディタ設定を一元的に管理し、組織全体で一貫性とセキュリティを確保できます。ポリシー値が設定されると、Devin Desktop で任意のレベル (デフォルト、ユーザー、ワークスペース) に設定された内容より優先されます。 IT 管理者は、さまざまなデバイス管理ソリューションを通じて、ユーザーのデバイスに特定の Devin Desktop 設定を展開し、強制できます。Devin Desktop は、WindowsmacOSLinux でのポリシー適用をサポートしています。
Devin Desktop では、VS Code とは別の独自のポリシーパスを使用します。VS Code 用に設定したポリシーは Devin Desktop には適用されず、逆も同様です。

Windows グループ ポリシー

Devin Desktop は、レジストリ ベースの Windows グループ ポリシー をサポートしています。ポリシーは、モバイル デバイス管理 (MDM) ソリューションを使用して展開することも、各デバイスで手動で構成することもできます。
Devin Desktop は、レジストリ パス Software\Policies\Windsurf\{ProductName} (例: Software\Policies\Windsurf\Windsurf または Software\Policies\Windsurf\WindsurfInsiders) からポリシーを読み取ります。これは、Software\Policies\Microsoft\{ProductName} から読み取る VS Code とは異なります。

Step 1: ADMX ファイルと ADML ファイルを取得する

Devin Desktop の各リリースには、利用可能なポリシーを定義する ADMX テンプレート ファイルを含む policies ディレクトリが含まれています。 既存の Devin Desktop のインストールから ADMX ファイルと ADML ファイルを取得できます。
  1. Devin Desktop のインストール ディレクトリに移動します。
  2. policies フォルダーを探します。このフォルダーには、ADMX テンプレート ファイル (例: windsurf.admx) と、さまざまな言語向けの ADML ファイルを含む locales サブフォルダーが含まれています。
または、Devin Desktop の zip アーカイブをダウンロードして展開し、展開したファイル内にある policies フォルダーを探してください。

ステップ 2: ポリシー定義ファイルをインストールする

  1. windsurf.admx ファイルを C:\Windows\PolicyDefinitions にコピーします。
  2. locales サブフォルダーから適切な ADML ファイル (例: en-US\windsurf.adml) を C:\Windows\PolicyDefinitions\<your-locale> (例: C:\Windows\PolicyDefinitions\en-US) にコピーします。
PolicyDefinitions ディレクトリにファイルをコピーするには、管理者権限が必要です。
Active Directory 環境では、ポリシーをドメイン全体で利用できるようにするため、ADMX ファイルと ADML ファイルを Central Store にコピーしてください。

ステップ 3: ポリシーを展開する

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

大規模展開

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

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

ローカルの Windows マシンでローカル グループ ポリシー エディターを使って Devin Desktop のポリシーを設定するには、以下の手順に従ってください。
  1. ローカル グループ ポリシー エディターを開く:
    • Windows+R を押して「ファイル名を指定して実行」ダイアログを開きます。
    • gpedit.msc と入力し、Enter キーを押します。
    • ユーザー アカウント制御の確認が表示された場合は、はい を選択します。
  2. Windsurf のポリシーに移動する:
    • コンピューターの構成 > 管理用テンプレート > Windsurf
    • ユーザーの構成 > 管理用テンプレート > Windsurf
コンピューターレベルとユーザーレベルの両方でポリシーが設定されている場合は、コンピューターレベルのポリシーが優先されます。
  1. ポリシーを設定する:
    • 設定するポリシー (例: AllowedExtensions) をダブルクリックします。
    • ポリシーを適用するには、有効 を選択します。
    • 文字列ポリシー (例: AllowedExtensions) の場合は、テキスト フィールドに値を入力します。例: {"publisher1": true, "publisher2": true}
    • ブール値ポリシー (例: EnableTelemetry) では、有効 または 無効 を選択すると値が設定されます。
    • 変更を保存するには、OK を選択します。
文字列ポリシーの値に構文エラー (例: 不正な JSON) がある場合、設定は適用されません。エラーは Devin Desktop の Window ログで確認できます (Ctrl+Shift+P で Command Palette を開き、Show Window Log と入力します) 。
ポリシーは次回 Devin Desktop の起動時に有効になります。

macOS構成プロファイル

構成プロファイルは、macOS デバイスの設定を管理するためのものです。プロファイルは、利用可能なポリシーに対応するキーと値のペアを含む XML ファイル (.mobileconfig) です。 これらのプロファイルは、モバイル デバイス管理 (MDM) ソリューションを使用して展開することも、各デバイスに手動でインストールすることもできます。

ステップ 1: サンプル構成プロファイルを入手する

Devin Desktop の各リリースには、サンプルの .mobileconfig ファイルが付属しています。Devin Desktop がインストールされている macOS デバイスでサンプルファイルを探すには、次の手順に従います。
  1. Finder を開き、/Applications に移動します。
  2. Windsurf.app を右クリックし、パッケージの内容を表示 を選択します。
  3. Contents/Resources/app/policies に移動します。
  4. サンプルの .mobileconfig ファイルを見つけます。

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

  1. サンプルの .mobileconfig ファイルを作業しやすい場所 (例: デスクトップまたは Documents フォルダ) にコピーします。
  2. コピーしたファイルをテキストエディタで開きます。
  3. 要件に合わせてポリシー値を編集します。
文字列ポリシー — テキスト値または JSON 文字列を受け付けるポリシー:
<!-- 例: 特定のパブリッシャーからの拡張機能を許可する -->
<key>AllowedExtensions</key>
<string>{"publisher1": true, "publisher2": true}</string>
ブール値ポリシー — true/false の値を受け付けるポリシー:
<!-- 例: ユーザーフィードバックを有効にする -->
<key>EnableFeedback</key>
<true/>

<!-- 例: テレメトリを無効にする -->
<key>EnableTelemetry</key>
<false/>
不要なポリシーを削除 — 適用したくないポリシーは、キーと値の両方を削除してください。
ポリシーの値に構文エラーがある場合、その設定は適用されません。エラーは Devin Desktop の Window ログで確認できます (⌘+Shift+P で Command Palette を開き、Show Window Log と入力します) 。

ステップ 3: ポリシーを適用する

大規模展開

複数のデバイスにわたるEnterprise向けの展開では、MDM対応のApple Business Managerなどのモバイルデバイス管理 (MDM) ソリューションを利用します。 構成プロファイルの詳細については、構成プロファイルに関するAppleのドキュメントを参照してください。

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

  1. 構成プロファイルをインストールする:
    • 編集した .mobileconfig ファイルを保存します。
    • Finder で .mobileconfig ファイルをダブルクリックします。
    • システム設定 が開きます。プロファイルの詳細を確認し、インストール を選択します。
    • 求められた場合は、管理者の認証情報を使用して認証します。
  2. プロファイルのインストールを確認する:
    • システム設定 を開きます。
    • プライバシーとセキュリティ > プロファイル (古いバージョンでは 一般 > デバイス管理) に移動します。
    • 一覧に Devin Desktop の構成プロファイルが表示されていることを確認します。
    • Devin Desktop を起動し、ポリシーが適用されていることを確認します。
ポリシーは、新しい Devin Desktop インスタンスにすぐに適用されます。Devin Desktop がすでに起動している場合は、再起動が必要になることがあります。

構成プロファイルを削除する

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

Linux JSON ポリシー

Linux デバイスでは、JSON ポリシーファイルを /etc/windsurf/policies/policy.json に配置することで、Devin Desktop の設定ポリシーを構成できます。この方法では、シンプルな JSON 形式でポリシー値を定義します。
Devin Desktop は /etc/windsurf/policies/policy.json からポリシーを読み込みます。一方、VS Code では /etc/vscode/policy.json を利用します。Devin Desktop では、必ず正しい場所にファイルを配置してください。

Step 1: サンプルポリシーファイルを入手する

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

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

  1. サンプルの policy.json ファイルを作業用ディレクトリにコピーします:
sudo cp /path/to/windsurf/resources/app/policies/policy.json /tmp/policy.json
  1. お好みのテキストエディタでファイルを編集します:
sudo nano /tmp/policy.json
  1. ポリシーの値を設定します。たとえば、特定の拡張機能の発行元のみを許可するには:
{
  "AllowedExtensions": "{\"publisher1\": true, \"publisher2\": true}",
  "UpdateMode": "manual"
}

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

大規模展開

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

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

  1. ポリシー用ディレクトリを作成し、ファイルをコピーします。
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
/etc/windsurf/policies にディレクトリを作成し、ポリシーファイルを管理するには、root または sudo 権限が必要です。
  1. ポリシーがインストールされていることを確認します。
    • Devin Desktop を起動します (すでに起動している場合は再起動します) 。
    • File > Preferences > Settings を開きます (または Ctrl+, を押します) 。
    • 構成済みのポリシーに対応する設定を探します。組織によって管理されていることを示す表示、またはロックアイコンが表示されているはずです。

ポリシーの削除

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

拡張機能管理ポリシー

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

AllowedExtensions

AllowedExtensions ポリシーは、許可する拡張機能の発行元を指定する JSON 文字列を受け付けます。このポリシーがアクティブな場合、ユーザーは一覧にある発行元の拡張機能のみをインストールできます。 例の値:
{"windsurf": true, "github": true, "ms-python": true}
これは、前述のプラットフォーム固有のいずれかの方法で設定できます。
  • Windows: グループ ポリシーの ADMX テンプレート、またはレジストリの Software\Policies\Windsurf\{ProductName} で設定します。
  • macOS: .mobileconfig 構成プロファイルで設定します。
  • Linux: /etc/windsurf/policies/policy.json で設定します。
AllowedExtensions ポリシーが適用されると、Devin Desktop の拡張機能ビューには、その設定が組織によって管理されていることが表示され、ユーザーはそれを上書きできません。

追加リソース