Инцидент с 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:
bashcurl -sI https://team.gitbook.com/space-name \
| head -n 1
Если ответ HTTP/2 200 без авторизации — пространство открыто для всех. Закройте его и перепроверьте через несколько часов, чтобы кэш CDN не отдавал старые страницы.
С точки зрения безопасности, приватный флаг в настройках не гарантирует отсутствия утечки: сотрудники могли экспортировать страницы в PDF или скопировать содержимое в сторонние вики. Проверить это можно только по логам доступа, если они есть.
Токены, ключи и интеграции с Git
GitBook часто подключают к GitHub, GitLab или Bitbucket через OAuth-приложение или персональный токен. Такой токен имеет доступ к репозиториям, а иногда и к вебхукам. Если токен попал в лог, в issue или в коммит — считайте его скомпрометированным.
Что делать:
- Посмотрите список интеграций в настройках GitBook. Удалите неиспользуемые приложения и отзовите их токены на стороне GitHub/GitLab.
- Ротируйте все токены, которые использовались для синхронизации: GitBook API-токены, персональные токены доступа (PAT), вебхук-секреты.
- Проверьте историю репозитория на вставленные секреты. На практике я видел случай, когда разработчик положил
.envс базой токенов в репозиторий, а GitBook синхронизировал его в открытое пространство.
Не делайте так: не храните токен в комментарии к коду или в README, даже временно.
Поиск секретов в истории:
bashgitleaks detect --source . --report-path gitleaks-report.json --verbose
Или, если используете TruffleHog:
bashtrufflehog 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 и инструменты анализа сертификатов.
Этот чеклист помогает минимизировать последствия инцидентов и восстановить доверие к команде.