Безопасность и данные
Что Dcision хранит и как долго, куда уходит ваше state — включая назначения, — как защищены ключи, секреты и пароли, роли и изоляция рабочих пространств и как не передавать чувствительные данные.
Что хранит Dcision
| Данные | Что хранится | Как долго |
|---|---|---|
| Аккаунт | E-mail, имя, аватар (из Google, если вы входите через него), язык и — только если вы его задали — хеш пароля (scrypt) | Пока существует аккаунт |
| Коды входа | Только хеш с ключом для каждого 6-значного кода; действует 10 минут, 5 попыток | Удаляются через сутки |
| Сессии | Подписанный токен в вашем браузере, действует 30 дней. Dcision хранит только время вашего последнего выхода на всех устройствах или смены пароля | — |
| Приглашения | Приглашённый e-mail, роль, кто и когда пригласил, и хеш SHA-256 токена ссылки — никогда не саму ссылку | Пока существует рабочее пространство |
| Данные организации | Юридическое название, ИНН, e-mail для счетов, страна, адрес и сайт — также сохраняются в вашем клиенте Stripe для счетов | Пока существует рабочее пространство |
| Решения | Черновики и каждая опубликованная версия (схемы) | Пока вы не удалите решение |
| API-ключи | Хеш SHA-256 ключа, замаскированный префикс, имя, окружение и даты — никогда не сам ключ | Пока не удалено рабочее пространство |
| Ключи провайдеров (BYOK) | Ключ, зашифрованный AES-256-GCM, и его последние 4 символа | Пока вы его не удалите |
| Секреты рабочего пространства | Каждое значение, зашифрованное AES-256-GCM, с последними 4 символами | Пока вы его не удалите |
| Секрет подписи | Зашифрован; после ротации — также предыдущий, в течение 24 часов | Пока существует рабочее пространство |
| Выполнения | Всегда: решение, версия, источник, статус, ошибка, действие и причина, задержка, входные и выходные токены, оценка стоимости, модель, ID запроса и записи назначений запуска. State — только если включён storeInput; ответы, уверенность, взвешенные уровни, composites и распределения — только если включён storeOutput | Ваш срок хранения журнала (ниже) |
| Доставки назначений | Статус, попытки, код статуса получателя, задержка и первые 1 024 символа его ответа, а также замаскированный предпросмотр запроса — никогда не его тело. Полный запрос хранится в зашифрованном виде до успешной доставки, а для неудачных — чтобы их можно было отправить повторно | 30 дней |
| Записи идемпотентности | Хеш запроса и ответ, который он вернул | 24 часа |
| Счётчики использования | Число оплачиваемых решений за час | Около 400 дней, для расчётов |
| Оплата | ID клиента и подписки Stripe, тариф, статус и даты цикла. Данные карт обрабатывает Stripe, и они никогда не попадают в Dcision | Пока существует рабочее пространство |
Куда уходит ваше state
Чтобы ответить на решение, Dcision отправляет провайдеру движка:
- state — все его поля, включая поля, не объявленные в схеме, — и
contextрешения какdecision_context; - инструкции вопросов, варианты, уровни и критерии, текстом или в JSON;
- название модели.
Веса composites, политики и настройки остаются в Dcision: они применяются после ответа движка.
Назначения могут передавать данные дальше после решения — только туда, куда вы их настроили:
- Вебхуки и workflows отправляют ответы, действие и сопоставленные вами параметры — никогда не само state.
- API-запросы отправляют то, что содержат ваши URL, заголовки и шаблон тела.
- Агенты получают всё state как
input; LLM-назначения отправляют state — или заданный вамиinput— вашему провайдеру модели, с вашим ключом. - Готовые ответы и функции возвращаются вызывающему; ничего не покидает Dcision.
См. Безопасность и лимиты назначений.
С ключом движка Dcision вызов идёт напрямую в API TypeSafe (Jev) под аккаунтом Dcision; TypeSafe заявляет, что Jev не обучается на запросах и ответах клиентов, — см. её юридические документы. С вашим собственным ключом он идёт к выбранному вами провайдеру, под вашим аккаунтом и на его условиях — в OpenAI для OpenAI Decisions, на ваш собственный сервер для Laya. См. Движки и BYOK. OpenAI Decisions на ключе Dcision вызывается через API OpenAI под аккаунтом Dcision.
Файлы в state (Входные данные): документы, которые Dcision умеет разбирать, читаются внутри Dcision и никогда его не покидают. Аудио, изображения для Jev или Laya и файлы, которые Dcision не умеет разбирать, отправляются в OpenAI с ключом OpenAI рабочего пространства, чтобы их транскрибировать, описать или прочитать. Изображения для OpenAI Decisions передаются вместе с вызовом движка. Журнал выполнений хранит имя, тип, размер и первые 4 000 символов текста каждого файла — никогда не сам файл. Если у рабочего пространства нет ключа OpenAI, используется ключ Dcision — тогда OpenAI становится субобработчиком Dcision; см. Политику конфиденциальности.
Dcision не записывает ваше state и ваши ключи в журналы приложения.
Хранение и удаление
- Выполнения удаляются по истечении меньшего из сроков: срока хранения вашего тарифа (Genesis 7 дней, Developer 14, Growth 30, Enterprise 365) и настройки рабочего пространства Хранение журнала выполнений.
- Удаление решения сразу удаляет его версии и выполнения.
- Записи идемпотентности истекают через 24 часа, независимо от настроек хранения решения.
- Отзыв API-ключа сразу его отключает; хешированная запись остаётся для истории.
- Перевыпуск API-ключа отзывает его и выдаёт новый секрет с тем же именем и окружением за один шаг — никогда не бывает момента с двумя рабочими ключами или без ключа.
- Доставки назначений удаляются через 30 дней после создания, независимо от срока хранения журнала, — в том числе когда их решение удалено.
- Удаление рабочего пространства (это может сделать его Владелец) удаляет его решения, версии, выполнения, API-ключи, приглашения, секреты и доставки. Клиент Stripe сохраняется, чтобы прошлые счета оставались доступны.
- Выйти на всех устройствах в разделе Аккаунт сразу завершает все сессии вашего аккаунта.
Не передавайте чувствительные данные
- Выключите
storeInput— иstoreOutput, если ответы тоже чувствительны, — у решений, которые получают персональные данные. См. Настройки решения. - Отправляйте только то, что нужно решению: необъявленные поля передаются движку. Это также делает ответы точнее — см. Как писать хорошие вопросы.
- Не помещайте персональные данные в инструкции, варианты и
context: они часть схемы, хранятся с каждой версией и отправляются с каждым вызовом. - Заменяйте прямые идентификаторы (имена, e-mail, номера документов) своими ID, когда они не меняют ответ.
- Сократите Хранение журнала выполнений в разделе Настройки.
- Сопоставляйте в параметры назначений только то, что нужно каждому получателю: записи назначений — включая параметры функций — хранятся вместе с выполнением, даже когда
storeInputиstoreOutputвыключены.
Управление доступом
- Изоляция рабочих пространств. Каждый запрос ограничен рабочим пространством. API-ключ соответствует ровно одному рабочему пространству и может запускать только его решения — всё остальное даёт
404 DECISION_NOT_FOUND— и получать список только его выполнений. - Входные данные остаются в приложении.
GET /v1/executionsвозвращает ответы, действия и метрики, но никогда не сохранённое state: входные данные, которые могут содержать персональные данные, показываются только участникам рабочего пространства в приложении. - Ключи и сессии разделены. API-ключи работают только в публичном API (
/v1); эндпоинты приложения отклоняют их с403 FORBIDDEN, а токен сессии не принимается в/v1. - Вход. Google, 6-значный код по e-mail или необязательный пароль: не менее 10 символов с буквами и цифрами, не ваш e-mail и не распространённый пароль, хранится как хеш scrypt. После 5 неверных паролей вход по паролю блокируется на 15 минут, а для неизвестного e-mail ответ такой же. При установке или смене пароля вам приходит письмо, а смена пароля завершает ваши остальные сессии.
- Сессии. Подписанный токен в cookie
httpOnly, никогда не доступный JavaScript браузера, действует 30 дней. Выйти на всех устройствах отзывает их все. - Роли. Каждый участник — Владелец, Администратор, Участник или Наблюдатель. Наблюдатели читают; Участники создают, публикуют и запускают решения, API-ключи и назначения; Администраторы также управляют людьми, настройками, ключами провайдеров и секретами; только Владелец управляет оплатой, передаёт владение и удаляет рабочее пространство. Отказы отвечают
403 FORBIDDEN. См. Команда, роли и аккаунт. - Доступ к рабочему пространству. Каждый запрос приложения проверяется по вашему членству в рабочем пространстве; рабочее пространство, в котором вы не состоите, отвечает
403 FORBIDDENсdetails.reason = "workspace_access".
Чек-лист безопасной интеграции
- Вызывайте API со своего бэкенда по HTTPS; никогда не раскрывайте API-ключ в браузере, мобильном приложении или репозитории.
- Используйте по ключу на сервис и отзывайте ключи, которые больше не используете. Используйте тестовые ключи для staging и CI.
- Отправляйте
Idempotency-Key, чтобы повторы не могли продублировать решение, — см. Идемпотентность. - Записывайте в журнал
execution_idиX-Request-IDвместо state, когда нужно отследить решение. - Проверяйте
Dcision-Signatureу каждого вебхука, workflow, агента и API-запроса, которые вы получаете от Dcision, отклоняйте старые метки времени и дедуплицируйте по ID доставки — см. Вебхуки. - Храните токены и секретные URL в секретах рабочего пространства и ссылайтесь на них как
{{secrets.NAME}}— никогда не вписывайте их в URL, заголовки или тело назначения. - Не допускайте события с
livemode: false— тестовые ключи и Playground — в продакшен-системы.
Ответственное использование
Dcision возвращает вероятности, а не уверенность в исходе. Для важных решений о людях — кредит, трудоустройство, жильё, здравоохранение, юридические вопросы — используйте его для сортировки и маршрутизации, оставляйте человека в контуре (например, через escalate) и регулярно проверяйте результаты.
Юридическая информация
CLI
Командная строка dcision — сохраните API-ключ, запускайте решения, смотрите шаблоны, создавайте и проверяйте схемы решений офлайн — с кодами выхода для скриптов и CI.
История изменений
Выпуски Dcision — v1.9 теневой режим и GPT-Live; v1.8 файлы на входе; v1.7 движок OpenAI; v1.6 перенос в подпространства; v1.5 промпты 32k; v1.4 партнёры; v1.3 выполнения; v1.0 конструктор; v0.1 запуск.