Entegrasyon

Scoped API anahtarı bir kez gösterilir, sonra gizlenir

Tam yetkili gizli anahtar sızınca workspace düşer. Kapsamı dar tutun, değeri bir kez kopyalayın, kullanılmayanı iptal edin. CI için ayrı anahtar şarttır.

Ontra merkezinde bağlı iş araçları

3 Temmuz 2026 · 7 dk okuma

Kapsam dar tutulsun

Dar kapsamlı API izni

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ı

Anahtar oluşturma ve tek kopya

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

CI ve otomasyon anahtarları

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.