Preview Protection

Preview деплои могут содержать незавершённый функционал или конфиденциальные данные. ONREZA предоставляет несколько способов защиты.

Способы защиты

Метод	Описание	План
OAuth Protection	Вход через ONREZA аккаунт	Все
Password Protection	Доступ по паролю	Pro
Bypass Secrets	Токены для CI/CD и автоматизации	Pro

OAuth Protection

При включённой OAuth защите, для просмотра preview деплоя нужно войти через ONREZA.

Как работает

1. Пользователь открывает URL preview деплоя
2. Перенаправляется на страницу входа ONREZA
3. После успешного входа получает доступ к деплою
4. Доступ сохраняется в сессии

Кто имеет доступ

• Участники workspace с любой ролью
• Владелец проекта

Заметка

OAuth Protection проверяет только членство в workspace. Если пользователь имеет доступ к workspace — он увидит все preview деплои.

Включение OAuth Protection

1. Откройте настройки проекта

   Перейдите в проект → Settings → Security

2. Найдите секцию Preview Protection

3. Включите OAuth Protection

   Активируйте переключатель

Bypass для автоматизации

При включённой защите системные проверки (smoke testing) используют внутренний bypass автоматически.

Для CI/CD и внешней автоматизации используйте Bypass Secrets.

Password Protection

Доступно на плане Pro

Позволяет защитить preview деплои простым паролем.

Как работает

1. Пользователь открывает URL preview деплоя
2. Видит форму ввода пароля
3. После ввода правильного пароля получает доступ
4. Пароль сохраняется в cookie браузера

Настройка пароля

1. Откройте настройки проекта

   Перейдите в проект → Settings → Security

2. Найдите секцию Password Protection

3. Нажмите Set Password

4. Введите пароль

   Минимум 8 символов, максимум 100

5. Сохраните

Смена пароля

1. Откройте Settings → Security
2. Нажмите Change Password
3. Введите новый пароль
4. Сохраните

Удаление пароля

1. Откройте Settings → Security
2. Нажмите Remove Password
3. Подтвердите удаление

Осторожно

После удаления пароля все preview деплои станут публичными (если не включена OAuth Protection).

Комбинирование методов

Вы можете использовать оба метода одновременно:

1. OAuth Protection — для членов команды
2. Password Protection — для внешних стейкхолдеров

Пользователь может пройти аутентификацию любым способом.

Bypass Secrets

Доступно на плане Pro

Bypass Secrets — токены для программного доступа к защищённым preview деплоям. Идеальны для CI/CD, мониторинга и автоматизированного тестирования.

Как работает

1. Создайте bypass secret в настройках проекта
2. Используйте токен при запросах к preview деплою
3. Запрос обходит OAuth и Password защиту
4. ONREZA отслеживает использование каждого секрета

Создание Bypass Secret

1. Откройте настройки проекта

   Перейдите в проект → Settings → Security

2. Найдите секцию Bypass Secrets

3. Нажмите Create

4. Введите название

   Укажите для чего используется секрет (например, “GitHub Actions”, “Monitoring”). Максимум 200 символов.

5. Скопируйте секрет

   Секрет показывается только один раз. Сохраните его в безопасном месте.

Осторожно

Bypass secret показывается только при создании. Если потеряете — создайте новый.

Заметка

Создание и перегенерация bypass secrets доступны только на Pro плане. Просмотр и удаление существующих секретов доступны на всех планах.

Использование

Через HTTP заголовок:

X-Onreza-Protection-Bypass: YOUR_SECRET

Через query параметр:

https://myproject-git-feature-workspace.onreza.app?_bypass=YOUR_SECRET

Совет

HTTP заголовок безопаснее — секрет не попадёт в логи сервера и историю браузера.

Примеры интеграций

GitHub Actions:

jobs:
  e2e-tests:
    steps:
      - name: Run tests against preview
        env:
          ONREZA_BYPASS_SECRET: ${{ secrets.ONREZA_BYPASS }}
        run: |
          # Используйте bypass secret в запросах к preview URL
          curl -H "X-Onreza-Protection-Bypass: $ONREZA_BYPASS_SECRET" \
            https://myproject-git-feature-workspace.onreza.app

Playwright:

playwright.config.ts

export default {
  use: {
    extraHTTPHeaders: {
      'X-Onreza-Protection-Bypass': process.env.ONREZA_BYPASS_SECRET
    }
  }
}

Monitoring:

health-check.sh

#!/bin/bash
# Проверка доступности preview через bypass secret
status=$(curl -s -o /dev/null -w "%{http_code}" \
  -H "X-Onreza-Protection-Bypass: your-secret" \
  https://myproject-git-feature-workspace.onreza.app)

if [ "$status" != "200" ]; then
  echo "Health check failed: HTTP $status"
  exit 1
fi

Управление секретами

Лимиты:

• Максимум 10 секретов на проект

Просмотр:

• Список всех секретов в Settings → Security
• Для каждого видно: название, первые символы, дата создания, последнее использование

Перегенерация:

1. Найдите секрет в списке
2. Нажмите меню (⋮) → Regenerate
3. Скопируйте новый секрет
4. Обновите во всех системах

Удаление:

1. Найдите секрет в списке
2. Нажмите меню (⋮) → Delete
3. Подтвердите удаление

Осторожно

После перегенерации или удаления старый токен перестаёт работать немедленно.

Безопасность

• Храните секреты в переменных окружения или secrets managers
• Не коммитьте секреты в репозиторий
• Используйте разные секреты для разных систем
• Регулярно ротируйте секреты
• Мониторьте “Last used” для неиспользуемых секретов

Production vs Preview

Настройка	Production	Preview
OAuth Protection	Не применяется	Применяется
Password Protection	Не применяется	Применяется
Bypass Secrets	Не применяется	Применяется

Заметка

Защита применяется только к preview деплоям. Production деплои всегда публичны.

Share Link

Для быстрого доступа к preview деплою можно создать share link:

1. Откройте страницу деплоя
2. Нажмите Share
3. Скопируйте ссылку

Share link включает:

• URL деплоя
• Bypass token (если включена защита)

Это позволяет поделиться деплоем без необходимости входа.

Осторожно

Share link обходит защиту. Делитесь им только с доверенными людьми.

Troubleshooting

”Unauthorized” при открытии preview

1. Убедитесь что вы вошли в ONREZA
2. Проверьте что у вас есть доступ к workspace
3. Попробуйте выйти и войти снова

Пароль не принимается

1. Проверьте правильность пароля (case-sensitive)
2. Попробуйте ввести заново
3. Очистите cookies браузера
4. Проверьте что пароль не был изменён

Smoke Testing не работает

При включённой защите smoke testing использует bypass. Если есть проблемы:

1. Проверьте что bypass token сгенерирован (он создаётся автоматически)
2. Обратитесь в поддержку если проблема сохраняется

См. также

• Деплои — обзор деплоев
• Окружения — настройка окружений
• Биллинг — планы и функции