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 では、VS Code とは別の独自のポリシーパスを使用します。VS Code 用に設定したポリシーは Devin Desktop には適用されず、逆も同様です。
Windows グループ ポリシー
Devin Desktop は、レジストリ パス
Software\Policies\Windsurf\{ProductName} (例: Software\Policies\Windsurf\Windsurf または Software\Policies\Windsurf\WindsurfInsiders) からポリシーを読み取ります。これは、Software\Policies\Microsoft\{ProductName} から読み取る VS Code とは異なります。Step 1: ADMX ファイルと ADML ファイルを取得する
policies ディレクトリが含まれています。
既存の Devin Desktop のインストールから ADMX ファイルと ADML ファイルを取得できます。
- Devin Desktop のインストール ディレクトリに移動します。
policiesフォルダーを探します。このフォルダーには、ADMX テンプレート ファイル (例:windsurf.admx) と、さまざまな言語向けの ADML ファイルを含むlocalesサブフォルダーが含まれています。
policies フォルダーを探してください。
ステップ 2: ポリシー定義ファイルをインストールする
windsurf.admxファイルをC:\Windows\PolicyDefinitionsにコピーします。localesサブフォルダーから適切な ADML ファイル (例:en-US\windsurf.adml) をC:\Windows\PolicyDefinitions\<your-locale>(例:C:\Windows\PolicyDefinitions\en-US) にコピーします。
PolicyDefinitions ディレクトリにファイルをコピーするには、管理者権限が必要です。ステップ 3: ポリシーを展開する
大規模展開
ローカル マシンでポリシーを手動でテストする
-
ローカル グループ ポリシー エディターを開く:
Windows+Rを押して「ファイル名を指定して実行」ダイアログを開きます。gpedit.mscと入力し、Enter キーを押します。- ユーザー アカウント制御の確認が表示された場合は、はい を選択します。
-
Windsurf のポリシーに移動する:
- コンピューターの構成 > 管理用テンプレート > Windsurf
- ユーザーの構成 > 管理用テンプレート > Windsurf
- ポリシーを設定する:
- 設定するポリシー (例: AllowedExtensions) をダブルクリックします。
- ポリシーを適用するには、有効 を選択します。
- 文字列ポリシー (例:
AllowedExtensions) の場合は、テキスト フィールドに値を入力します。例:{"publisher1": true, "publisher2": true}。 - ブール値ポリシー (例: EnableTelemetry) では、有効 または 無効 を選択すると値が設定されます。
- 変更を保存するには、OK を選択します。
macOS構成プロファイル
.mobileconfig) です。
これらのプロファイルは、モバイル デバイス管理 (MDM) ソリューションを使用して展開することも、各デバイスに手動でインストールすることもできます。
ステップ 1: サンプル構成プロファイルを入手する
.mobileconfig ファイルが付属しています。Devin Desktop がインストールされている macOS デバイスでサンプルファイルを探すには、次の手順に従います。
- Finder を開き、
/Applicationsに移動します。 - Windsurf.app を右クリックし、パッケージの内容を表示 を選択します。
Contents/Resources/app/policiesに移動します。- サンプルの
.mobileconfigファイルを見つけます。
ステップ 2: ポリシー値を設定する
- サンプルの
.mobileconfigファイルを作業しやすい場所 (例: デスクトップまたは Documents フォルダ) にコピーします。 - コピーしたファイルをテキストエディタで開きます。
- 要件に合わせてポリシー値を編集します。
ステップ 3: ポリシーを適用する
大規模展開
ローカルマシンでポリシーを手動でテストする
-
構成プロファイルをインストールする:
- 編集した
.mobileconfigファイルを保存します。 - Finder で
.mobileconfigファイルをダブルクリックします。 - システム設定 が開きます。プロファイルの詳細を確認し、インストール を選択します。
- 求められた場合は、管理者の認証情報を使用して認証します。
- 編集した
-
プロファイルのインストールを確認する:
- システム設定 を開きます。
- プライバシーとセキュリティ > プロファイル (古いバージョンでは 一般 > デバイス管理) に移動します。
- 一覧に Devin Desktop の構成プロファイルが表示されていることを確認します。
- Devin Desktop を起動し、ポリシーが適用されていることを確認します。
ポリシーは、新しい Devin Desktop インスタンスにすぐに適用されます。Devin Desktop がすでに起動している場合は、再起動が必要になることがあります。
構成プロファイルを削除する
- システム設定 > プライバシーとセキュリティ > プロファイル を開きます。
- Devin Desktop の構成プロファイルを選択します。
- Remove (または -) ボタンを選択します。
- 削除を確定するため、管理者の認証情報を使って認証します。
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: サンプルポリシーファイルを入手する
policy.json ファイルが付属しています。既存のインストール環境から入手でき、Devin Desktop のインストールパス内にある resources/app/policies ディレクトリに配置されています。
ステップ 2: ポリシーの値を設定する
- サンプルの
policy.jsonファイルを作業用ディレクトリにコピーします:
- お好みのテキストエディタでファイルを編集します:
- ポリシーの値を設定します。たとえば、特定の拡張機能の発行元のみを許可するには:
ステップ3:ポリシーをデプロイする
大規模展開
policy.json ファイルを展開します。これらのツールを使うと、管理者は管理対象のすべての Linux デバイスに対して、ポリシーの展開、更新、削除をリモートで行えます。
ローカルマシンでポリシーを手動でテストする
- ポリシー用ディレクトリを作成し、ファイルをコピーします。
/etc/windsurf/policies にディレクトリを作成し、ポリシーファイルを管理するには、root または sudo 権限が必要です。- ポリシーがインストールされていることを確認します。
- Devin Desktop を起動します (すでに起動している場合は再起動します) 。
- File > Preferences > Settings を開きます (または
Ctrl+,を押します) 。 - 構成済みのポリシーに対応する設定を探します。組織によって管理されていることを示す表示、またはロックアイコンが表示されているはずです。
ポリシーの削除
/etc/windsurf/policies/policy.json ファイルを削除し、Devin Desktop を再起動してください。
拡張機能管理ポリシー
AllowedExtensions ポリシーを利用すると、管理者は許可された拡張機能発行元の許可リストを定義できます。
AllowedExtensions
AllowedExtensions ポリシーは、許可する拡張機能の発行元を指定する JSON 文字列を受け付けます。このポリシーがアクティブな場合、ユーザーは一覧にある発行元の拡張機能のみをインストールできます。
例の値:
- Windows: グループ ポリシーの ADMX テンプレート、またはレジストリの
Software\Policies\Windsurf\{ProductName}で設定します。 - macOS:
.mobileconfig構成プロファイルで設定します。 - Linux:
/etc/windsurf/policies/policy.jsonで設定します。
AllowedExtensions ポリシーが適用されると、Devin Desktop の拡張機能ビューには、その設定が組織によって管理されていることが表示され、ユーザーはそれを上書きできません。
