Что дает подключение
Подключение Gcore WAAP (защита веб-приложений и API от Gcore) позволяет просматривать домены, которые защищает ваш собственный Gcore WAAP, и переключать режим файрвола каждого домена прямо из вашей панели управления Zinn®.
Перед началом работы
Вам потребуется собственный аккаунт Gcore с включенным WAAP. Действует модель исключительно со своими учетными записями: мы не перепродаем WAAP, поэтому продукт, договор и счета оформляются между вами и Gcore, а используемые там ресурсы списываются с вашего счета Gcore, а не по тарифу Zinn®.
1. Создайте ключ в Gcore
В Личном кабинете Gcore нажмите на свой аватар в правом верхнем углу, затем выберите Profile → API tokens → Create token. Задайте ему имя, выберите Never expire или дату окончания срока действия и назначьте роль для каждого необходимого продукта. Gcore показывает токен только один раз; сразу скопируйте его.
Один и тот же токен подходит для всех подключаемых продуктов Gcore, поэтому, если вы уже подключили один продукт Gcore, вы можете вставить этот же токен снова — при условии, что его роли охватывают и данный продукт. Токену нельзя назначить роль выше, чем у вашей собственной учетной записи.
2. Подключите его здесь
Откройте раздел Integrations в вашей панели управления и выберите Connect an account. Выберите Web app firewall в качестве группы и Gcore WAAP в качестве аккаунта, заполните поле API token и нажмите Connect account.
Мы проверяем вставляемые данные перед сохранением. Неработающий ключ никогда не сохраняется, а в ответе указывается, что именно с ним не так. Работающий ключ хранится в зашифрованном виде в нашем хранилище секретов — ни в коем случае не в нашей базе данных — и больше никогда не отображается, даже вам.
Что происходит дальше
- ваши защищенные домены и текущий режим каждого из них перечислены в разделе Your own services, куда можно перейти по кнопке подключения Open your own services на странице Integrations.
- вы можете переключать домен между режимами block (совпадающие запросы отклоняются), monitor (совпадения только фиксируются в журнале, а трафик проходит) и off. Мы отображаем и записываем тот режим, о котором Gcore сообщает после изменения, а не тот, который был запрошен.
- ⚠️ Режим monitor не является защитой. Он полезен, пока вы проверяете, не заблокирует ли правило реальных посетителей; пока домен находится в этом режиме, ничего не блокируется.
Если подключение не удается
Появляется сообщение о том, что продукт не включен. Токен действителен, но WAAP не активирован для этой учетной записи Gcore — в этом случае Gcore отклоняет любое чтение. Включите его в Личном кабинете Gcore (или обратитесь с запросом в Gcore), затем выполните подключение снова. Токен, роль которого не включает WAAP, вызывает такой же отказ; создайте токен с необходимой ролью.
У домена отображается статус locked. Gcore сам блокирует режим домена, обычно по причинам, связанным с учетной записью или оплатой, и заблокированный режим нельзя изменить отсюда. Устраните проблему в собственной панели управления Gcore.
Появляется сообщение о том, что ключ отклонен. Почти всегда причина в одном из трех факторов: вместе с ключом был скопирован пробел или перевод строки, истек срок действия ключа, либо ключ был отозван или сгенерирован заново после того, как вы его скопировали. Создайте новый ключ и вставьте его снова.
Подключение проходит успешно, но позже возникает сбой. Ключ проходит аутентификацию, но ему не хватает разрешения, необходимого для выполнения действия. Создайте новый ключ с указанными выше разрешениями, затем разорвите старое соединение и подключите новый ключ.
Отключение
Откройте раздел Integrations, найдите учетную запись и нажмите Disconnect. Это действие сразу же удалит сохраненный ключ. Все процессы, которые его использовали, остановятся при следующем действии, а экраны, зависевшие от него, сообщат об ошибке вместо тихого сбоя.
Отключение не отменяет уже выполненные действия — записи, развертывания или настройки, измененные нами в вашем аккаунте, останутся без изменений. Если вы считаете, что сам ключ мог быть скомпрометирован, также отзовите его на стороне поставщика; отключение удаляет нашу копию, а не их.