summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/README.md b/README.md
index 64f5b55..e4e286b 100644
--- a/README.md
+++ b/README.md
@@ -173,6 +173,41 @@ Mountの`access`には`read_only`、`read_write`、`read_write_delete`を指定ã
承認は最初にBrokerが直接起動するEntry Processにだけ適用されます。Entry Processから生成される子孫Processには個別承認を要求しませんが、同じLPAC、ACL、WFP、Job Objectの制限を継承します。未知の外部ExecutableやMount上のExecutableは、Brokerから直接起動できません。
+#### cmd.exeを有効にする例
+
+`agent.local.yaml`のShell一覧へAliasを追加します。配列はlocal側で置換されるため、ほかのShellも使う場合はすべて列挙してください。
+
+```yaml
+sandbox:
+ profile: development
+ workspaces:
+ - C:/tmp
+ execution:
+ executables:
+ - python
+ shells:
+ - cmd
+```
+
+管理者として起動したPowerShellで、cmdの実体を確認して承認します。cmdはWindowsのOS Runtime Rootを利用するため、追加Runtime Rootを登録しない`--no-runtime`を指定します。
+
+```powershell
+cd <install-dir>
+.\agent-mcp.exe executable resolve cmd `
+ --path C:\Windows\System32\cmd.exe `
+ --config .\agent.yaml
+.\agent-mcp.exe executable approve cmd `
+ --path C:\Windows\System32\cmd.exe `
+ --no-runtime `
+ --config .\agent.yaml
+.\agent-mcp.exe executable list --config .\agent.yaml
+.\agent-mcp.exe check --config .\agent.yaml --lang ja
+```
+
+非対話で承認する場合だけ`approve`へ`--yes`を付けます。この操作はAuditへ記録されます。
+
+cmdから子Processを呼ぶ場合は、`cmd.exe`、`curl.exe`、`.venv\Scripts\python.exe`のようにPATHで解決できる名前またはWorkspace相対パスを使います。`%ComSpec%`や`%SystemRoot%\System32\curl.exe`のようなドライブ修飾絶対パスは、cmd自身が事前にvolume情報へアクセスするため、LPACではOSに拒否されることがあります。これは子Process生成の禁止ではありません。
+
### Network
| `access` | 許可内容 |