
Компоненты и границы доверия
Песочница — недоверенная граница. Она получает файлы и инструкции, необходимые для выполнения работы,
но не исходные учётные данные 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 может просматривать сайты и устанавливать пакеты с публичных адресов без подключения приложения.
Работа с учётными данными
Песочница получает значения-заполнители для учётных данных, которыми управляет Yahont. Прокси определяет идентичность песочницы, получает нужные учётные данные и добавляет их только к подходящему исходящему запросу.
Исходные учётные данные находятся в хранилище под управлением Yahont и ненадолго — в памяти прокси,
пока готовится запрос. Процесс подстановки не записывает их в рабочее пространство песочницы,
пакет навыков или созданные файлы.
Знания компании
Craft ищет по знаниям компании через API Yahont, а не подключает песочницу напрямую к векторной базе данных или проиндексированным источникам. Yahont обрабатывает запрос от имени владельца песочницы и применяет права этого пользователя на документы. Включение Craft, предоставление доступа к навыку или подключение приложения не расширяет доступ пользователя к проиндексированным документам. Результаты поиска всё равно могут попасть в запрос, созданный файл или веб-приложение, поэтому пользователям нужно проверять результаты, прежде чем делиться ими.Приложения и одобрения
Запросы, отнесённые к приложению, используют политики, настроенные администратором:
Для действия Спрашивать процесс одобрения выглядит так:
1
Приостановите запрос
Прокси останавливает запрос до подстановки учётных данных приложения.
2
Запросите решение
Yahont отправляет в сессию карточку одобрения. Пользователь одобряет один раз,
одобряет подходящие действия на время сессии или отклоняет запрос.
3
Перешлите или заблокируйте
Прокси пересылает одобренный запрос с учётными данными или отклоняет его по умолчанию после отклонения или истечения
срока.
Созданные веб-приложения
Yahont отдаёт созданные веб-приложения через аутентифицированный прокси, а не открывает порты песочницы напрямую. Прокси проверяет область общего доступа сессии, прежде чем переслать запрос:
Общий доступ открывает созданное веб-приложение, а не разговор в Craft или файловый обозреватель сессии.
Однако информация, записанная в само приложение, видна всем, кто может его открыть.
Перед отправкой запроса на сервер созданного приложения прокси удаляет cookie зрителя, заголовки авторизации,
заголовки CSRF, заголовки пересылки и заголовки идентичности.
Он также удаляет
set-cookie из ответа созданного приложения. Предпросмотр работает в iframe с песочницей,
в котором включены скрипты, формы и переходы по инициативе пользователя.
Состояние и операционные данные
Соображения безопасности
Развёртывание Craft
Выберите бэкенд песочниц и настройте его средства защиты.
Управление Craft
Настройте доступ, приложения, навыки, модели и инструкции рабочего пространства.

