Безопасность
Храните секреты в secret store
Заголовок раздела «Храните секреты в secret store»Никогда не коммитьте токены в git. Используйте:
- Переменные окружения (
.env- в.gitignore). - Менеджеры секретов (1Password, Vault, AWS Secrets Manager, GCP Secret Manager).
- KeyVault облачного провайдера.
Минимальные scopes
Заголовок раздела «Минимальные scopes»См. Scopes - выдавайте ровно то что нужно. Если интеграция читает задачи и не пишет - tasks:read достаточно.
Короткий expiration
Заголовок раздела «Короткий expiration»Чем короче срок жизни ключа, тем меньше окно для злоупотребления при утечке. Для CI/CD рассмотрите ключи на 30 дней с автоматической ротацией.
Мониторинг last-used
Заголовок раздела «Мониторинг last-used»В UI и через GET /api/v1/accounts/{a}/api-keys доступны lastUsedAt / lastUsedIp каждого ключа. Если ключ внезапно «оживает» с незнакомого IP - это сигнал.
Ротация при подозрении
Заголовок раздела «Ротация при подозрении»При любом подозрении на утечку - сразу Rotate Secret или Revoke. Старый секрет немедленно становится невалидным.
TLS обязателен
Заголовок раздела «TLS обязателен»API доступен только по HTTPS. Никаких HTTP-вариантов в production. Webhooks ваших систем тоже должны быть HTTPS.
Не логируйте токены
Заголовок раздела «Не логируйте токены»В логах вашего приложения никогда не печатайте Authorization header. Маскируйте: Bearer fw_live_AbCd...****.