Продвинутый

Инцидент с GitBook: чеклист действий для команд

greyhat
greyhat
Специалист по безопасности5 ноября 2026 г.12 мин чтения

Разбор инцидента с утечкой в GitBook: что проверить в репозиториях, как ротировать секреты и какие меры принять, чтобы защитить документацию команды.

Инцидент с GitBook: чеклист действий для команд

Разбор инцидента с утечкой в GitBook: что проверить в репозиториях, как ротировать секреты и какие меры принять, чтобы защитить документацию команды.

Что известно об инциденте GitBook

Что известно об инциденте GitBook

Хронология и ответ поддержки

Инцидент с GitBook повторяет типовую схему утечки через публично доступное пространство документации. Команда поддержки действует по заранее отработанному сценарию: признаёт инцидент, отзывает скомпрометированные токены, рассылает уведомления и публикует постмортем. С точки зрения безопасности, этого недостаточно. Поддержка сообщает то, что выгодно вендору, а не то, что нужно вашей команде.

На практике я видел случай, когда компания поверила заявлению «все секреты ротированы», а через месяц в логах аутентификации появились попытки входа со старых ключей. Не доверяйте на слово — проверяйте самостоятельно.

Пример: как проверить историю Git-репозитория, связанного с документацией, на наличие секретов:

bash
# Поиск ключей и токенов в всей истории коммитов
git log --all -p | grep -Ei '(api[_-]?key|secret|token|password|passwd|private[_-]?key|ssh-rsa|BEGIN [A-Z ]*PRIVATE KEY)'

# Быстрый скан через gitleaks, если инструмент установлен
gitleaks detect --source . --verbose

Каждая строка в выводе — потенциальный инцидент. Если нашли что-то, относящееся к вашей инфраструктуре, считать скомпрометированным и ротировать немедленно.

Какие данные могли утечь

В документации команды часто хранят больше, чем предполагают. Типовая ошибка — дублировать конфигурационные файлы, примеры скриптов или фрагменты логов в публичное пространство GitBook «для удобства доступа».

Что могло попасть в открытый доступ:

  • API-токены и ключи доступа к облачным сервисам;
  • Пароли от баз данных и внутренних сервисов;
  • Приватные ключи SSH и сертификаты;
  • Внутренние URL и IP-адреса инфраструктуры;
  • Имена пользователей, адреса электронной почты, фрагменты логов с персональными данными.

Если в GitBook хранились ссылки на репозитории, где в коммитах светились секреты, риск возрастает. Используйте OmniDiff — ultrafast Git difftool на Rust для сравнения версий конфигурационных файлов до и после инцидента — так быстрее найти, что именно попало в публичный доступ.

Проверка рабочей копии на случайные секреты:

bash
# Рекурсивный поиск по текущей директории, исключая .git
grep -rnEi '(api[_-]?key|secret|token|password|passwd)' --exclude-dir=.git .

# Поиск приватных ключей
grep -rn 'BEGIN [A-Z ]*PRIVATE KEY' --exclude-dir=.git .

Если нашли совпадение — не удаляйте файл и не правьте коммит в надежде, что „никто не заметил“. История Git хранит всё. Секрет считается скомпрометированным с момента первого коммита.

Категорически не рекомендуется полагаться на «security by obscurity» — надежду, что документацию никто не найдёт. Публичное пространство индексируется поисковыми системами и сканируется автоматизированными инструментами в течение минут после публикации.

Оценка рисков для команд и репозиториев

Оценка рисков для команд и репозиториев

Инцидент с GitBook показывает: документация — это не просто справочник, а часть периметра. Если в открытом доступе оказались внутренние API, схемы сети или учётные данные, атакующий получает карту инфраструктуры без сканирования. Ниже — что проверить в репозиториях и какие секреты ротировать.

Публичная и приватная документация

Проверьте visibility каждого пространства (space) в GitBook. Типовая ошибка — оставить пространство публичным, потому что при импорте из GitHub репозитория visibility наследуется не всегда корректно.

Что делать:

  • Откройте настройки пространства и убедитесь, что режим доступа соответствует классификации информации. Внутренняя архитектура, список сотрудников, внутренние IP — только приватный доступ.
  • Проверьте, не индексируются ли страницы поисковыми системами. Если документация была публичной хоть один день, считайте, что она попала в кэш и в архивы (Wayback Machine, Common Crawl).
  • Пройдитесь по страницам на наличие встроенных ссылок на внутренние ресурсы: http://10.0.0.x, http://localhost:8080, http://internal-api.company.com. Даже неактивные ссылки выдают атакующему структуру сети.
  • Если документация синхронизируется с публичным GitHub-репозиторием, проверьте, нет ли в коммитах файлов, которые не должны попадать в открытый доступ: .env, config.yaml, id_rsa, secrets.json.

Пример проверки доступности пространства через curl:

bash
curl -sI https://team.gitbook.com/space-name \
  | head -n 1

Если ответ HTTP/2 200 без авторизации — пространство открыто для всех. Закройте его и перепроверьте через несколько часов, чтобы кэш CDN не отдавал старые страницы.

С точки зрения безопасности, приватный флаг в настройках не гарантирует отсутствия утечки: сотрудники могли экспортировать страницы в PDF или скопировать содержимое в сторонние вики. Проверить это можно только по логам доступа, если они есть.

Токены, ключи и интеграции с Git

GitBook часто подключают к GitHub, GitLab или Bitbucket через OAuth-приложение или персональный токен. Такой токен имеет доступ к репозиториям, а иногда и к вебхукам. Если токен попал в лог, в issue или в коммит — считайте его скомпрометированным.

Что делать:

  1. Посмотрите список интеграций в настройках GitBook. Удалите неиспользуемые приложения и отзовите их токены на стороне GitHub/GitLab.
  2. Ротируйте все токены, которые использовались для синхронизации: GitBook API-токены, персональные токены доступа (PAT), вебхук-секреты.
  3. Проверьте историю репозитория на вставленные секреты. На практике я видел случай, когда разработчик положил .env с базой токенов в репозиторий, а GitBook синхронизировал его в открытое пространство.

Не делайте так: не храните токен в комментарии к коду или в README, даже временно.

Поиск секретов в истории:

bash
gitleaks detect --source . --report-path gitleaks-report.json --verbose

Или, если используете TruffleHog:

bash
trufflehog filesystem . --only-verified

Для быстрого просмотра изменений в истории удобно использовать difftool, например OmniDiff — ultrafast Git difftool на Rust.

Если нашли токен — не удаляйте файл и не делайте git push --force без плана. Удаление из текущей ветки не стирает коммит из истории. Нужно ротировать секрет, а потом чистить историю через git filter-repo или BFG Repo-Cleaner.

Категорически не рекомендуется хранить токены в репозитории, даже в зашифрованном виде. Если без токена не обойтись — используйте секретное хранилище (Vault, AWS Secrets Manager, GitHub Secrets) и подменяйте значения на этапе сборки документации.

Настоятельно рекомендуется ограничить scope токена только тем, что нужно для GitBook: чтение репозитория, без прав на запись и без доступа к организациям.


Чеклист: что сделать сразу

  • Проверить visibility всех пространств в GitBook; закрыть публичные, если там внутренняя информация.
  • Проверить кэш поисковых систем и архивы на копии утечённых страниц.
  • Пройтись по документации на наличие ссылок на внутренние хосты и API.
  • Отозвать все токены интеграции GitBook с Git/GitLab/GitHub.
  • Ротировать API-токены, PAT и вебхук-секреты.
  • Прогнать репозитории через gitleaks или TruffleHog.
  • Удалить секреты из истории через git filter-repo, если они там есть.
  • Проверить права доступа к репозиториям: кто может пушить в ветку, синхронизируемую с GitBook.

Неотложные действия после инцидента

Ротация секретов и отзыв токенов

При утечке конфиденциальных данных первоочередной задачей является немедленная смена всех утечек и отозвание недействительных токенов. Это минимизирует окно уязвимости и предотвращает дальнейшее использование компрометированных учётных записей.

Смена секретов в репозитории

Если утечка произошла через код или конфигурацию, необходимо заменить утечённые значения на новые. Например, если в репозитории GitBook хранятся API‑ключи для внешних сервисов, их нужно переустановить через систему управления секретами.

bash
# Проверка наличия утечек в репозитории
git grep -r "AKIA[0-9A-Z]{16}" --include="*.yml" --include="*.yaml" --include="*.json"

# Сброс токенов в CI/CD конфигурации
# Пример: обновление secret-менеджера в GitHub Actions
echo "new_secret_value" >> .github/secrets/gitbook-secrets
git add .github/secrets/gitbook-secrets
git commit -m "Rotate leaked secrets after GitBook incident"
git push

Отзыв токенов и подключений

После смены секретов необходимо отозвать все старые токены, которые могли быть использованы для доступа к ресурсам. Это включает:

  • OAuth‑токены для интеграций с внешними сервисами
  • API‑ключи для платежных систем и CI/CD
  • SSH‑ключи, если они были утечены
bash
# Отзыв OAuth‑токенов в Google Cloud (пример)
gcloud iam service-accounts disable-iam-role \
  --iam-role "projects/my-project/locations/global/serviceAccounts/gitbook-sa" \
  --project=my-project

# Отзыв токенов в AWS (если используется)
aws iam delete-user-credential \
  --user-name "gitbook-access-token" \
  --region us-east-1

# Удаление утечек из Git
git rm -r --cached leaked-secret-file
git commit -m "Remove leaked file"
git push

Автоматизация ротации

Для предотвращения подобных инцидентов внедряйте автоматические проверки:

yaml
# .github/workflows/secret-rotation.yml
name: Rotate Secrets
on:
  schedule:
    - cron: '0 2 * * *'  # ежедневно в 2 часа ночи
jobs:
  rotate:
    runs-on: ubuntu-latest
    steps:
      - name: Check for leaked secrets
        run: |
          git grep -r "AKIA[0-9A-Z]{16}" --include="*.yml" --include="*.yaml" --include="*.json"
      - name: Rotate secrets
        run: |
          # Создаём новые секреты через Vault или HashiCorp Vault CLI
          vault write secret/gitbook/production new_api_key="new_key_12345"
          vault write secret/gitbook/production new_auth_token="new_token_67890"
      - name: Revoke old tokens
        run: |
          # Отзыв старых токенов через API
          vault revoke secret/gitbook/production

Аудит логов доступа к аккаунту

После ротации секретов необходимо провести глубокий анализ логов, чтобы понять масштаб утечки и определить, какие системы были скомпрометированы. Мониторинг и логирование — это первый рубеж обороны после инцидента.

Проверка системных логов

Сначала извлеките информацию о входе и выходе из репозитория GitBook:

bash
# Аудит GitLab/SourceHawk/похожих платформ
git log --oneline --since="24h" --all

# Проверка аудита доступа к конфигурационным файлам
git ls-files -s | grep -i "secret\|token\|key"

# Анализ коммитов с изменениями в секретах
git log --all --grep="secret\|token\|key" --oneline

Анализ логов доступа к аккаунтам

Если утечка произошла через веб‑интерфейс, необходимо проверить логи авторизации и аудит доступа:

bash
# Просмотр системных логов (systemd/journald)
journalctl -u gitbook-service --since "24h ago" | grep -i "auth\|login\|token"

# Проверка CloudWatch / Azure Monitor / ELK логов
# Пример запроса к CloudWatch Logs
aws logs filter-log-events \
  --log-group-name /gitbook-service \
  --filter-pattern "Failed Login|Token Exceeded|Unauthorized Access"

# Анализ веб‑логов (если используется Nginx/Apache)
sudo tail -f /var/log/gitbook/access.log | grep -E "192[0-9]{1,3}\.[0-9]+\.[0-9]+\.[0-9]+"

Идентификация подозрительной активности

Следите за следующими индикаторами:

  • Необычные IP‑адреса, пытающиеся доступ к API репозитория
  • Попытки изменения конфигурационных файлов в период инцидента
  • Служебные запросы к внутренним эндпоинтам с неавторизованных источников
bash
# Поиск аномальных запросов в логах
awk '/Failed Login/ {print $1, $2}' /var/log/gitbook/access.log | sort | uniq -c | sort -rn | head -20

# Проверка на несанкционированные изменения файлов
git diff --name-only --since="24h" | grep -E "secret|token|key|password"

Верификация защиты

После аудита убедитесь, что меры по защите уже применены:

  • Включён мониторинг подозрительных действий (например, через WAF или SIEM)
  • Настроены алерты на попытки доступа с неизвестных IP
  • Обновлены правила фильтрации в firewall (iptables/nftables)

OmniDiff — ultrafast Git difftool на Rust
Ubuntu не выпустил патч для критической RCE уязвимости Linux
Skills for Real Engineers: Инструменты и практика
OmniDiff: сверхбыстрый Git difftool на Rust
Навыки для настоящих инженеров: коллекция из .agents

После выполнения всех указанных действий команда должна провести целевой аудит, пересмотреть политику доступа и обновить инструкции для команды. Документируйте каждое действие в incident‑report для будущего анализа.

Заключение: чеклист действий и ответы на вопросы

Заключение: чеклист действий и ответы на вопросы

Чеклист: что сделать в первые 24 часа

После инцидента с утечкой в GitBook команде рекомендуется выполнить следующий порядок действий:

1. Изоляция и фиксация уязвимости

  • Оцените масштаб утечки — определите, какие данные были снят и насколько они критичны. Проверьте, были ли в репозитории файлы с секретами, API-ключи или токены.
  • Блокируйте доступ к репозиторию — если утечка произошла через публичный доступ, немедленно отключите доступ к конкретному ветку или репозиторию в системе контроля версий.
  • Сделайте снимок состояния — зафиксируйте текущее состояние инцидента в системе мониторинга для последующего анализа.
bash
# Проверка наличия секретов в репозитории (исключаем .gitignore)
git ls-files | grep -iE '(secret|token|api|key|password)'

# Проверка конфигурационных файлов на наличие хардкодных значений
grep -r "PASSWORD\|SECRET\|TOKEN\|API_KEY" . --include="*.yaml" --include="*.yml" --include="*.json" | head -20

2. Ротация секретов

  • Смените все обнаруженные секреты — используйте автоматизированные скрипты для поиска и замены хардкодных значений.
  • Обновите CI/CD конфигурации — убедитесь, что секреты не добавляются в будущие коммиты через .gitignore и CI-скрипты.
yaml
# Пример .gitignore для предотвращения утечек
# GitBook инфраструктура
.gitbook/
.env
secrets/
configs/production.yaml
bash
# Ротация секретов через скрипт (пример)
#!/bin/bash
# Файл: rotate-secrets.sh
# Запуск: chmod +x rotate-secrets.sh && ./rotate-secrets.sh

# Генерация новых токенов и замена в файлах
for secret in PASSWORD API_KEY TOKEN; do
    new_value=$(openssl rand -base64 32)
    # Замена через sed (только для демонстрации — в проде используйте git replacements)
    sed -i "s/^${secret}=.*/${secret}=${new_value}/" configs/production.yaml
    echo "Ротация секрета: ${secret} -> ${new_value}"
done

3. Аудит инфраструктуры

  • Проверьте настройки монтирования — убедитесь, что контейнеры не имеют доступ к хостовой файловой системе без необходимости.
  • Очистите логи — извлеките и анализируйте логи, но не храните их без необходимости.
  • Включите дополнительный мониторинг — настройте алерты на подозрительную активность в инфраструктуре.
bash
# Проверка открытых портов и брандмауэра
nmap -sT -p 1-65535 your-gitbook-host | grep -E '(LISTEN|LISTEN|LISTEN)'

# Проверка настройки iptables/nftables
iptables -L -n | grep -E '(INPUT|FORWARD|OUTPUT)'

4. Восстановление и тестирование

  • Проверьте целостность документации — убедитесь, что все страницы отображаются корректно после репликации.
  • Протестируйте доступ — проверьте, что новые секреты работают в CI/CD и что документация доступна безопасным пользователям.

Часто задаваемые вопросы

Q1: Что делать, если утечка произошла через публичный URL?

Ответ: немедленно отключите доступ к репозиторию и блокируйте публичный веб-эндпоинт. Затем выполните ротацию всех секретов, которые могли быть утечены. Используйте OmniDiff — ultrafast Git difftool на Rust для быстрого сравнения состояний до и после инцидента. Для детального разбора уязвимостей Linux-систем рекомендуется обратиться к статье Ubuntu не выпустил патч для критической RCE уязвимости.

Q2: Как правильно ротировать секреты в GitBook?

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

yaml
# .gitlab-ci.yml — секция для ротации секретов
rotate_secrets:
  stage: deploy
  script:
    - ./rotate-secrets.sh
    - git add configs/production.yaml
    - git commit -m "Rotate secrets: ${GIT_COMMIT}"
  only:
    - main

Q3: Нужно ли немедленно удалять документацию с секретами?

Ответ: если документация содержит открытые секреты, удалите её из публичных репозиториев и создайте отдельный канал для обновления. Для предотвращения подобных инцидентов используйте Skills for Real Engineers: Инструменты и практика, где описаны методы защиты конфигурационных файлов.

Q4: Как настроить мониторинг для раннего обнаружения утечек?

Ответ: настройте алерты на необычную активность в системе мониторинга, включая попытки доступа к репозиториям с ненужными правами. Инструменты вроде Security Onion или Wazuh могут помочь отслеживать подозрительные действия. Включите логирование аутентификации и проверку на записи с необычных IP-адресов.

Q5: Что делать, если инцидент повлиял на пользователей?

Ответ: сообщите затраченные пользователи о ситуации, предоставьте инструкции по действиям и предложите компенсацию при необходимости. Включите в процедуру уведомления механизм Fail2ban для блокировки подозрительных IP-адресов. Для проверки TLS-настроек используйте Certbot и инструменты анализа сертификатов.


Этот чеклист помогает минимизировать последствия инцидентов и восстановить доверие к команде.

Поделиться:TelegramX / TwitterVK

Читайте также