# Agentic Secrets Handling

> API anahtarları, kubeconfig ve Juju credential için saklama sırası ve log maskeleme kurallarını uygularken kullan.

- Skill: `aibot88/agentic-secrets-handling` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add aibot88/agentic-secrets-handling`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aibot88/agentic-secrets-handling/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: aibot88 (https://skillmd.com/u/aibot88)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/aibot88/agentic-secrets-handling

---


## Amaç

Sırlar için öncelik sırası: **secret manager / vault (tercih)** > **ortam değişkeni** > **kısıtlı izinli dosya** (ör. `chmod 600`). `.env` dosyası **asla** commit edilmez; `.env.example` yalnız placeholder içerir. Log ve trajectory çıktılarında **maskeleme** zorunlu. Env isimleri `LLM_PROVIDERS.md` ile uyumlu tutulur (`SENTINEL_API_KEY`, `ANTHROPIC_API_KEY`, `SENTINEL_LOCAL_*`, vb.).

## Kapsam

### Dahil

- LLM API anahtarları, isteğe bağlı OAuth/token (ürün kararı).
- `kubeconfig`, Juju credentials, cloud config dosyaları.

### Hariç

- Vault ürününün kurulum rehberi (harici dokümantasyon).

## Kurallar

- Repo içinde gerçek anahtar tespitinde: rotate + `git history` temizliği (proje prosedürü).
- Debug log seviyesinde bile anahtar ve JWT benzeri stringler **redact**.
- CI’da fork PR’lar için secret yok varsayımı (`agentic-ci-github-actions`).

## Kontrol listesi

- [ ] `.gitignore` `.env` ve yerel credential dosyalarını kapsıyor mu?
- [ ] Uygulama başlangıcında “env’de key var mı” kontrolü kullanıcıya güvenli mesajla mı dönüyor?
- [ ] Trajectory kaydında PII/secret filtreleri tanımlı mı?

## Hata ve geri dönüş

| Tipik sorun | Kontrol | Sonraki adım |
|-------------|---------|--------------|
| Anahtar loga düştü | Log handler | Maskeleme kuralı ekle, anahtarı rotate et |
| Yanlış env okundu | Profil önceliği | `agentic-config-layers` sırasını doğrula |

## İlgili belgeler ve skill'ler

- `../documantations/LLM_PROVIDERS.md`
- `../agentic-cli-logging/SKILL.md`
- `../agentic-config-env-reference/SKILL.md`
- `../agentic-trajectory-recording/SKILL.md`