Kapsam dar tutulsun
Dış sistem yalnızca görev yazacaksa anahtara silme ve üye daveti vermeyin. Ontra’da izin listesi anahtar kaydında durur; sonradan daraltılabilir, genişletmek yeni anahtar ister. `api_keys.manage` rol yetkisidir, her üyenin işi değildir. Tek anahtarla “her şeyi bağlarız” cümlesi altı ay sonra sızıntı olur. Dış zamanlayıcı `tasks.write` ile yaşar. Üye listesini çekmek ayrı bir anahtardır.
Anahtar isimlendirilir, “test” bırakılmaz. Kullanılmayan iptal edilir. CI için ayrı, dar kapsamlı anahtar. Log hangi anahtarın ne zaman koştuğunu gösterir. Kayıp anahtar yenilenir; eski hemen düşer. Oluşturma ekranı gizli değeri bir kez gösterir. Ekran görüntüsü wiki’ye yapıştırılmaz. Değer bir sır deposuna gider, sohbete değil.
- Silme ve davet yetkisini dış sisteme vermeyin
- Anahtarı “test” diye bırakmayın
- Kayıp anahtar yenilenir, eskisi düşer
- Log hangi anahtarın ne zaman koştuğunu gösterir
- CI için ayrı, dar kapsamlı, isimli anahtar
Entegrasyon senaryoları
Gece job’u açık görevleri dış ERP’ye yazacaksa yalnız okuma + dar yazma yeter. Chat bot’u kart açacaksa `tasks.create` yeter; proje silme yoktur. Raporu dış BI’ya çekmek `reports.read` ile sınırlı bir anahtardır, admin değildir. Her senaryo ayrı anahtar ister. Paylaşılan “entegrasyon admin’i” kaba yetkinin API halidir.
Anahtar da koltuk gibi bakılır: kimin, ne için, hâlâ gerekiyor mu? Çeyreklik denetimde kullanılmayan düşer. Sızan anahtar rotasyonu bir runbook’tur, kahramanlık değil. Workspace’i “her şeyi yeniden kur” ile kurtarmazsınız; dar kapsam sızıntının yarıçapını küçültür. Bu yüzden genişletmek yeni anahtar ister — eski değeri şişirmek kolay, geri almak zordur.
Sırrı nereye koymayın
Repo, wiki, Slack, ekran görüntüsü, e-posta, “geçici” bir not. Bunların hiçbiri sır deposu değildir. CI değişkeni, vault, ortam dosyası (gite girmeyen). Anahtar bir kez gösterilir çünkü ikinci gösterim alışkanlık yapar. Kaybeden yeniler. Bu kural insanları cezalandırmaz; sızıntı yüzeyini küçültür.
Anahtar envanteri ve sızıntı yarıçapı
Her entegrasyon kendi anahtarını ister. Gece job’u ERP’ye görev yazıyorsa dar yazma. Chat bot kart açıyorsa `tasks.create`. BI rapor çekiyorsa `reports.read`. Paylaşılan “entegrasyon admin’i” kaba yetkinin API halidir. `api_keys.manage` her üyenin işi değildir. Genişletmek yeni anahtar ister; eski değeri şişirmek kolay, geri almak zordur. Dar kapsam sızıntının yarıçapını küçültür. Workspace’i “her şeyi yeniden kur” ile kurtarmazsınız.
Oluşturma ekranı sırrı bir kez gösterir. Ekran görüntüsü wiki’ye yapışmaz. Değer vault’a gider, Slack’e değil. İsim “test” bırakılmaz. CI ayrı, dar, isimli anahtardır. Log hangi anahtarın ne zaman koştuğunu gösterir. Kayıp yenilenir, eski düşer. Çeyreklik tur: kimin, ne için, hâlâ gerekiyor mu? Kullanılmayan iptal edilir. Repo, e-posta, “geçici not” sır deposu değildir.
Sızan anahtar rotasyonu runbook’tur, kahramanlık değil. İlk iş: eski anahtarı düşür. İkinci: kapsamı daha da daraltarak yenisini çıkar. Üçüncü: log’da son kullanımları oku. Dördüncü: sırrın düştüğü yeri (repo, sohbet, ekran) temizle. Beşinci: “neden tek anahtarla her şey bağlıydı?” sorusunu çeyrek maddesine yaz. Tekrar etmemek için kapsam politikası yazılı olsun.
Anahtarın yaşam döngüsü
Her entegrasyon kendi anahtarını ister. ERP gece job’u dar yazma. Bot tasks.create. BI reports.read. Entegrasyon admin’i kaba yetkinin API halidir. api_keys.manage her üyenin işi değildir. Genişletmek yeni anahtar ister. Dar kapsam yarıçapı küçültür. Her şeyi yeniden kurarak kurtulamazsınız.
Sır bir kez gösterilir. Wikiye yapışmaz. Vault’a gider. İsim test değildir. CI ayrı dar isimli anahtardır. Log zamanı gösterir. Kayıp yenilenir eski düşer. Çeyrek: kimin ne için hâlâ gerekiyor mu. Kullanılmayan iptal. Repo e-posta geçici not sır deposu değildir.
Sızıntı runbook’u: eskiyi düşür, daha dar yenisini çıkar, log’u oku, düştüğü yeri temizle, neden tek anahtardı sorusunu çeyreğe yaz. Politika yazılı olsun. Silme ve daveti dış sisteme vermeyin.
Anahtar da koltuk gibi bakılır. Unutulan test anahtarı altı ay sonra production’da çalışır. Unutulan staj koltuğu da yetki bırakır. İkisi aynı disiplindir. Çeyrek turu ikisini birden sorar.
Entegrasyon senaryosu
Dış zamanlayıcı yalnız görev yazacaksa `tasks.write` yeter. Üye listesini çekmek ayrı bir anahtardır. Tek anahtarla “her şeyi bağlarız” cümlesi altı ay sonra sızıntı olur.
Diğer yazılar
Ürün
Görev ile doküman aynı kayıt olunca iş dağılmaz
Liste, pano ve yol haritası ayrı araçlar değil; aynı kaydın görünümleridir. Karar bir yerde alınır, her yüzeyde aynı gerçeği gösterir. Bu yazı dağınık araç yığınının teslimi nasıl geciktirdiğini ve Ontra’da tek kaydın nasıl kurulduğunu anlatır.
Güvenlik
Yetki kaba değil kılcal olunca ekip ferahlar
Herkes her projeyi görmek zorunda değil. Rolün yanına proje, klasör ve liste düzeyi eklenince gizlilik varsayılan olur. Ajans ve holdinglerde sızıntının kaynağı kötü niyet değil, fazla geniş “yönetici her şeyi görsün” kısayoludur.
Kurulum
7 günlük demoda workspace’i bitirin, aracı değil
Kredi kartı yok. Süre bitince uygulama kapanır, veriler durur. İlk hafta gezmek yerine bir gerçek iş yükleyin: proje, roller, aktif sprint, doküman ağacı ve ilk rapor. Vitrin turu araç seçtirmez; oturan kayıt seçtirir.
