Skip to main content
Craft добавляет в Yahont недоверенную среду выполнения кода. Yahont управляет жизненным циклом песочницы, хранит учётные данные вне песочницы и посредничает при доступе к знаниям компании, внешним сервисам и созданным веб-приложениям. Архитектура среды выполнения Craft: браузер, плоскость управления Yahont, песочница каждого пользователя, прокси песочниц, поставщики моделей, поиск, внешние приложения и созданные веб-приложения

Компоненты и границы доверия

Песочница — недоверенная граница. Она получает файлы и инструкции, необходимые для выполнения работы, но не исходные учётные данные Yahont, поставщика модели или приложения.

Жизненный цикл запроса

1

Yahont авторизует запрос

Браузер отправляет в API Yahont запрос, вложения, выбор модели и выбранные возможности. Yahont проверяет доступ пользователя к Craft и моделям.
2

Yahont готовит рабочее пространство

Yahont создаёт или восстанавливает песочницу пользователя, создаёт каталог для сессии и синхронизирует доступные этому пользователю навыки и файлы библиотеки пользователя.
3

Агент работает в песочнице

Песочница вызывает выбранную модель, выполняет код и инструменты и записывает файлы в рабочее пространство сессии. Yahont передаёт события агента обратно в браузер потоком.
4

Сетевые запросы проходят через прокси

Прокси песочниц определяет песочницу и сессию, блокирует внутренние адреса и подставляет учётные данные или запрашивает одобрение, если этого требует адрес назначения.
5

Yahont отдаёт результат

Пользователи просматривают и скачивают файлы через аутентифицированные API Yahont. Yahont проксирует созданные веб-приложения из песочницы, проверив область общего доступа приложения.

Изоляция песочницы и рабочего пространства

Craft поддерживает одну песочницу на пользователя и отдельное рабочее пространство для каждой сессии. В рабочем пространстве находятся вложения, созданный код, промежуточные файлы, результаты и инструкции агента для сессии. Навыки и файлы библиотеки пользователя синхронизируются в управляемую область песочницы и связываются с каждой сессией. Вложения принадлежат только своей сессии, а файлы библиотеки пользователя остаются доступными во всех сессиях пользователя. Пакеты навыков могут содержать исполняемые скрипты, поэтому перед предоставлением доступа их нужно проверять как код. Когда песочница простаивает, Yahont сохраняет состояние её сессий в настроенное файловое хранилище и останавливает среду выполнения. Yahont восстанавливает это состояние, когда пользователь возвращается. Снимки обеспечивают засыпание и восстановление; это не история версий для пользователя. Бэкенд Docker требует от API-сервера и фонового рабочего процесса доступа к сокету Docker на чтение и запись. Такой доступ фактически равен доступу root к хосту, поэтому Docker Compose предназначен для небольших развёртываний на доверенном хосте.

Исходящий сетевой трафик

Межсетевой экран песочницы разрешает DNS и путь через прокси песочниц. У HTTP- и HTTPS-запросов песочницы нет второго, прямого маршрута в сеть. Прокси ведёт себя по-разному в зависимости от адреса назначения:
Прокси — это средство контроля исходящего трафика и граница учётных данных, а не список разрешённых адресов публичного интернета. Craft может просматривать сайты и устанавливать пакеты с публичных адресов без подключения приложения.
Kubernetes добавляет NetworkPolicy как второе средство контроля трафика от песочницы к прокси и DNS. Песочницы Docker используют отдельный мост, который не может разрешать имена сервисов Compose Yahont и обращаться к ним. Требования к операторам см. в руководствах по развёртыванию в Kubernetes и Docker Compose.

Работа с учётными данными

Песочница получает значения-заполнители для учётных данных, которыми управляет Yahont. Прокси определяет идентичность песочницы, получает нужные учётные данные и добавляет их только к подходящему исходящему запросу. Исходные учётные данные находятся в хранилище под управлением Yahont и ненадолго — в памяти прокси, пока готовится запрос. Процесс подстановки не записывает их в рабочее пространство песочницы, пакет навыков или созданные файлы.

Знания компании

Craft ищет по знаниям компании через API Yahont, а не подключает песочницу напрямую к векторной базе данных или проиндексированным источникам. Yahont обрабатывает запрос от имени владельца песочницы и применяет права этого пользователя на документы. Включение Craft, предоставление доступа к навыку или подключение приложения не расширяет доступ пользователя к проиндексированным документам. Результаты поиска всё равно могут попасть в запрос, созданный файл или веб-приложение, поэтому пользователям нужно проверять результаты, прежде чем делиться ими.

Приложения и одобрения

Запросы, отнесённые к приложению, используют политики, настроенные администратором: Для действия Спрашивать процесс одобрения выглядит так:
1

Приостановите запрос

Прокси останавливает запрос до подстановки учётных данных приложения.
2

Запросите решение

Yahont отправляет в сессию карточку одобрения. Пользователь одобряет один раз, одобряет подходящие действия на время сессии или отклоняет запрос.
3

Перешлите или заблокируйте

Прокси пересылает одобренный запрос с учётными данными или отклоняет его по умолчанию после отклонения или истечения срока.
Если запрос соответствует нескольким встроенным действиям приложения, действует самая строгая политика: Запрещать, затем Спрашивать, затем Автоодобрение. Запрос к встроенному приложению, которого нет в каталоге, обрабатывается как Спрашивать. Пользовательские приложения используют Спрашивать для каждого запроса, соответствующего их настроенным шаблонам URL. У запланированных задач нет присутствующего пользователя, который мог бы ответить на запрос одобрения. Владелец задачи может заранее одобрить приложение для этой задачи; это разрешает действия приложения со значением Спрашивать во время выполнения. Предварительное одобрение не отменяет Запрещать и применяется ко всему приложению, а не к одному действию.

Созданные веб-приложения

Yahont отдаёт созданные веб-приложения через аутентифицированный прокси, а не открывает порты песочницы напрямую. Прокси проверяет область общего доступа сессии, прежде чем переслать запрос: Общий доступ открывает созданное веб-приложение, а не разговор в Craft или файловый обозреватель сессии. Однако информация, записанная в само приложение, видна всем, кто может его открыть. Перед отправкой запроса на сервер созданного приложения прокси удаляет cookie зрителя, заголовки авторизации, заголовки CSRF, заголовки пересылки и заголовки идентичности. Он также удаляет set-cookie из ответа созданного приложения. Предпросмотр работает в iframe с песочницей, в котором включены скрипты, формы и переходы по инициативе пользователя.
Созданный клиентский код выполняется в браузере зрителя. Запросы со стороны браузера не являются исходящим трафиком песочницы и не проходят через прокси песочниц. Проверьте созданное приложение, прежде чем открывать к нему доступ организации.

Состояние и операционные данные

Относитесь к журналам и трассировкам Craft как к потенциально конфиденциальным. В зависимости от конфигурации журналирования они могут включать запросы, имена файлов, URL, результаты инструментов, взаимодействия с моделями и метаданные одобрений.

Соображения безопасности

Развёртывание Craft

Выберите бэкенд песочниц и настройте его средства защиты.

Управление Craft

Настройте доступ, приложения, навыки, модели и инструкции рабочего пространства.