Что дает подключение
Подключение Gcore WAAP (защиты веб-приложений и API от Gcore) позволяет просматривать домены, защищенные вашей собственной Gcore WAAP, и переключать режим межсетевого экрана для каждого домена прямо из вашей панели управления Zinn®.
Перед началом работы
Наличие собственной учетной записи Gcore с включенной службой WAAP. Это решение поддерживает только собственный аккаунт пользователя (bring-your-own): мы не перепродаем WAAP, поэтому продукт, договор и счета оформляются между вами и Gcore, а все расходы за использование сервиса списываются с вашего счета в Gcore, а не с вашего тарифного плана Zinn®.
1. Создание ключа в Gcore
В Портале клиента Gcore нажмите на свой аватар в правом верхнем углу, затем перейдите в раздел Профиль → API-токены → Создать токен. Задайте ему имя, выберите вариант Бессрочно или укажите срок действия, а также назначьте роль для каждого необходимого продукта. Gcore отображает токен только один раз — скопируйте его сразу.
Один и тот же токен подходит для любого подключаемого продукта Gcore, поэтому если вы уже подключили один продукт Gcore, вы можете использовать тот же токен повторно, если его роли также охватывают этот продукт. Токену нельзя назначить роль выше, чем у вашей собственной учетной записи.
2. Подключение здесь
Откройте раздел Интеграции в вашей панели управления и выберите Подключить учетную запись. Выберите Межсетевой экран веб-приложений в качестве группы и Gcore WAAP в качестве учетной записи, укажите API-токен и нажмите Подключить учетную запись.
Мы проверяем введенные данные перед сохранением. Неработающий ключ никогда не сохраняется, а в сообщении указывается причина ошибки. Работающий ключ хранится в зашифрованном виде в нашем хранилище секретов (но не в нашей базе данных) и больше никогда не отображается, даже вам.
Что происходит дальше
- Ваши защищенные домены и текущий режим каждого из них отображаются в разделе Ваши собственные сервисы, доступ к которому осуществляется с помощью кнопки Открыть ваши собственные сервисы в карточке подключения в разделе Интеграции.
- Вы можете переключать режим домена между значениями блок (совпадающие запросы отклоняются), мониторинг (совпадения только регистрируются, а трафик продолжает проходить) и выключено. Мы отображаем и записываем тот режим, который сообщает Gcore после выполнения изменения, а не тот, который запрашивался.
- ⚠️ Режим мониторинга не обеспечивает защиту. Он полезен при проверке того, что правило не заблокирует реальных посетителей, и пока домен находится в этом режиме, блокировки не выполняются.
Если подключение не удается
Сообщение о том, что продукт не включен. Токен действителен, но служба WAAP не активирована для данной учетной записи Gcore, поэтому Gcore отклоняет все запросы на чтение. Включите ее в Портале клиента Gcore (или обратитесь в службу поддержки Gcore), а затем повторите подключение. Токен, роль которого не включает WAAP, вызывает такой же отказ; создайте токен с соответствующими правами.
Сообщение о том, что домен заблокирован. Gcore блокирует режим домена самостоятельно, как правило, по причинам, связанным с учетной записью или выставлением счетов, и заблокированный режим нельзя изменить отсюда. Урегулируйте этот вопрос в собственной панели управления Gcore.
Сообщение об отклонении ключа. Почти всегда это связано с одной из трех причин: вместе с ключом был скопирован пробел или символ перевода строки, срок действия ключа истек, либо ключ был отозван или создан заново после того, как вы его скопировали. Создайте новый ключ и вставьте его снова.
Подключение прошло успешно, но в дальнейшем происходит сбой. Ключ проходит аутентификацию, но ему не хватает разрешения, необходимого для выполнения действия. Создайте новый ключ с правами, указанными выше, затем разорвите старое соединение и подключите новый ключ.
Отключение
Откройте раздел Интеграции, найдите учетную запись и нажмите Отключить. Это немедленно удалит сохраненный ключ. Любые процессы, использующие его, прекратят работу при следующем действии, а зависящие от него экраны сообщат об этом вместо того, чтобы завершаться с тихим сбоем.
Отключение не отменяет уже выполненных действий: записи, развертывания или настройки, измененные нами в вашей учетной записи, остаются прежними. Если вы подозреваете, что сам ключ мог бытькомпрометирован, дополнительно отзовите его у поставщика; отключение удаляет нашу копию, но не их.