Общий доступ и передача

Ссылка для общего доступа

Сгенерируйте ссылку, отправьте её. Получатель входит в систему - достаточно бесплатного аккаунта - и окружение появляется в его клиенте. Он может смотреть, не может менять. Вы можете отозвать доступ в любой момент.

Передача владения

Тоже ссылка, но с другим смыслом: принятие не добавляет окружение в клиент получателя рядом с вашим, а безвозвратно переносит владение туда. Требует у получателя платного тарифа и свободной квоты. Отмены нет.

Экспорт файла

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

В меню окружения сгенерируйте ссылку для общего доступа. Вы выбираете срок действия - от 1 до 30 дней, по умолчанию 7.

Ссылка показывается ровно один раз. Нет страницы, куда можно вернуться и скопировать её заново, поэтому скопируйте её до закрытия диалога.

Окружением можно поделиться только с одним человеком одновременно. Генерация новой ссылки списывает ту, что была активна раньше, - если старая ссылка ещё открыта в чьём-то браузере, она перестаёт работать.

Повторное открытие ссылки тем же получателем, который уже её принял, ничего не ломает - это считается тем же самым принятием, а не вторым. Любой другой человек, открывший её после этого, увидит, что она уже занята.

Удаление окружения, находящегося в общем доступе, не оставляет ссылку незаметно живой. Доступ получателя заканчивается вместе с окружением, и любой доступ к управляемому прокси, связанный с ним, тоже.

Может

Открыть окружение и работать с ним. Посмотреть его отпечаток. Если у владельца управляемый прокси - работать через него, никогда не видя хост, имя пользователя или пароль. Исключение см. в разделе «Свой прокси».

Не может

Переименовать, изменить настройки отпечатка, удалить, экспортировать в файл или передать дальше третьему лицу. Эти действия остаются у владельца.

Общий, а не скопированный

Владелец и получатель работают с одним архивом, а не с двумя, которые расходятся. Cookies и входы, записанные во время сессии получателя, - это то, что владелец увидит при следующем открытии, и наоборот.

Отзыв убирает окружение из клиента получателя и не даёт открыть его снова. Если оно использует управляемый прокси, отзыв также обрывает учётные данные, через которые работал получатель, - он теряет доступ к этому выходному IP вместе с окружением.

Окружение не остаётся лежать на их машине. Когда получатель закрывает браузер, локальная копия удаляется сразу после того, как эта сессия сохранена обратно в ваш архив - между сессиями на его диске не остаётся ничего вашего. Если сохранение не удалось или не смогло захватить всё, копия сохраняется, а не удаляется: в этот момент она хранит единственную запись о том, что произошло в той сессии.

Прокси-соединение, которое уже было открыто в момент отзыва, может продолжать работать ещё некоторое время, прежде чем оборвётся. Новые соединения больше не выдаются, но уже существующее не гарантированно обрывается в момент нажатия отзыва. Рассчитывайте на «получатель больше не сможет войти снова», а не на точное время отключения.

Получатель должен быть на платном тарифе с запасом в квоте профилей. Бесплатный аккаунт не может принять передачу.

Если окружение привязано к управляемому прокси, получателю также нужен запас в квоте прокси - прокси переходит вместе с окружением, и теперь он считается в его лимите, а не в вашем.

Если окружение вместо этого работает через прокси, который вы подключили сами, его учётные данные копируются в аккаунт получателя как часть передачи - в отличие от ссылки для общего доступа, передача их не скрывает.

Это единственная операция на этой странице без отмены. Как только получатель принимает передачу, окружение исчезает из вашего аккаунта. Отозвать её нельзя, и вернуть можно только если новый владелец сам поделится им или передаст его обратно.

Со стороны владельца: текущее состояние общего доступа для профиля, которым вы владеете - sharedWith (email получателя или null) и любая активная непринятая invite.

Генерирует ссылку. Тело запроса: { kind: 'SHARE' | 'TRANSFER', ttlDays?: number } - ttlDays ограничивается диапазоном 1-30, по умолчанию 7. Возвращает { url, token, expiresAt }. Токен можно прочитать только в этом ответе - сервер хранит его хэш, а не сам токен.

Отзывает текущий общий доступ и любую ожидающую ссылку для профиля, а также обрывает доступ к прокси, выданный из-за неё. Что именно это отменяет и не отменяет - см. Отзыв выше.

Со стороны получателя: окружения, к которым вам открыт общий доступ. Каждая запись содержит id, name, config, ownerEmail, hasProxy и updatedAt.

Подписанные URL R2 для общего архива - GET для скачивания перед запуском, POST для URL загрузки после сессии. Это и есть механизм единого общего архива, описанного выше: обе стороны читают и пишут один и тот же объект.

Выдаёт временные учётные данные прокси для окружения на общем доступе, использующего управляемый прокси. Возвращает { proxyUrl }, либо { proxyUrl: null, reason }, когда выдавать нечего - no_proxy (владелец не использует прокси), owner_custom_proxy (см. Свой прокси) или unknown_proxy (настройки прокси окружения не читаются - клиент откажется запускаться напрямую, а не станет угадывать). Отозванный доступ отвечает 404.