Безопасность и данные

Что 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) и регулярно проверяйте результаты.

На этой странице