API anahtarı güvenliği

API anahtarı, bağlı olduğu MailGraf hesabının public API'sine erişir. MailGraf'ta henüz anahtar bazında daha dar yetki tanımlanamaz. Bu nedenle her anahtarı şifre gibi koruyun ve hangi servise ait olduğunu açıkça belirtin.

Her anahtarın kullanımını sınırlayın

• Her servis ve ortam için ayrı anahtar oluşturun. Örneğin CRM canlı ve CRM test adlarını kullanabilirsiniz.
• Anahtarı gizli anahtar yöneticisinde veya sunucunun korunan ortam değişkeninde tutun.
• Tarayıcı koduna, mobil uygulamaya, herkese açık depoya, destek talebine veya ekran görüntüsüne eklemeyin.
• Kullanılmayan anahtarları kaldırın. Son kullanım bilgisi ve API istek monitörü, aktif anahtarları bulmanıza yardımcı olur.

API anahtarlarını yalnızca hesap sahibi ve yöneticiler yönetebilir. Anahtar, kendisini oluşturan kullanıcıya değil hesaba erişim verir.

Anahtarı güvenle yenileyin

1. Yeni anahtar oluşturun

   Ayarlar > API sayfasını açın, API anahtarı oluştur butonuna tıklayın ve servisle ortamı belli eden bir ad kullanın.

2. Bağlı servisi güncelleyin

   Servisin gizli anahtar yapılandırmasında eski anahtarı yenisiyle değiştirin ve değişikliği yayına alın.

3. Yeni anahtarın kullanıldığını doğrulayın

   İlk API isteğinizi gönderin yazısındaki salt okunur isteği gönderin. Eski anahtarı kaldırmadan önce Son kullanım bilgisini veya API istek monitörü bölümünü kontrol edin.

4. Eski anahtarı iptal edin

   Eski anahtarın menüsünü açın ve İptal et seçeneğine tıklayın. Bu anahtarla gönderilen istekler hemen 401 yanıtı vermeye başlar.

Açığa çıkan anahtarı değiştirin

Anahtarın kopyalandığından veya yayınlandığından şüpheleniyorsanız anahtarı hemen iptal edin. Kullanılıp kullanılmadığını öğrenmek için beklemeyin. Yeni anahtar oluşturun, ilgili servisi güncelleyin ve API istek monitörü bölümünde tanımadığınız kaynak, IP adresi veya yanıt kodu olup olmadığını kontrol edin.

Tam referans nerede

Bearer kimlik doğrulama sözleşmesini ve her endpointin döndürebileceği hataları API referansında bulabilirsiniz.