# Crystal VPN — API для AI-агентов

> Управление организациями, сотрудниками и VPN-доступом через существующий Crystal VPN Workspace. Сервер всегда проверяет роль и принадлежность организации.

Документация:
- Руководство: /vpn/api/remote-access/agent/guide.md
- OpenAPI 3.1: /vpn/api/remote-access/agent/openapi.json
- Машиночитаемый манифест: /vpn/api/remote-access/agent/agent.json

Авторизация:
1. POST /vpn/api/remote-access/workspace/login с login/password и Origin текущего домена.
2. Сохранить HttpOnly cookie __Secure-crystal_workspace только в защищённом cookie jar.
3. Взять csrf из ответа и передавать его как X-CSRF-Token во всех POST.
4. GET /workspace/bootstrap возвращает только доступные текущему пользователю организации.

Никогда не помещайте пароль, cookie, CSRF, приглашение или ссылку VPN-профиля в публичный prompt или лог. Перед записью перечитайте объект, используйте expected_version и стабильный operation_id.