Skip to main content
Anahtar yenileme, bir projenin alım anahtarını (ingest key) değiştirir. Projeyi veya projede saklanan telemetriyi değiştirmez. Anahtarları hesap kimlik doğrulamasıyla yönetin. Alım anahtarı yalnızca telemetri gönderebilir. Anahtarları yönetemez. Başlamadan önce CLI’ı kurun ve giriş yapın. LOGBREW_PROJECT_ID değişkenine proje UUID’sini yazın. LOGBREW_API_URL değişkenine https://api.logbrew.co adresini yazın. Örnekler Bash, curl 7.76.0 veya daha yeni bir sürüm ve jq kullanır. Planlı bir yenilemede eski anahtarı iptal etmeden önce yeni anahtarı oluşturun, dağıtın ve test edin. Yenileme sıklığını güvenlik politikanızda belirleyin. Anahtarın bir son kullanma tarihi varsa onu bu tarihten önce değiştirin.
Açığa çıkmış bir anahtar bir güvenlik olayıdır. Yeni anahtar dağıtılmamış olsa bile onu hemen iptal edin. İptal edilmiş bir anahtarı kullanmaya devam eden uygulamalar telemetri gönderemez.
1

Yeni anahtarı oluşturun

POST /api/projects/{project_id}/ingest-keys, en fazla 120 karakterlik boş olmayan bir label kabul eder. kind değeri cli, sdk, browser, server veya artifact olur. artifact anahtarı telemetri gönderemez. İsteğe bağlı expires_at değeri gelecekteki bir RFC3339 zamanı olmalıdır.Eski anahtarla aynı kind değerini kullanın. --kind seçeneğini vermezseniz CLI sdk kullanır. --label seçeneğini vermezseniz CLI-created SDK key kullanır. CLI’da son kullanma tarihi için bir seçenek yoktur. expires_at değerini ayarlamak için API’yi kullanın.CLI, tek seferlik tokenı kaynak kontrolü dışındaki yeni bir dosyaya kaydeder. Bu dosyayı yalnızca sahibi okuyabilir. CLI tokenı değil, meta verileri yazdırır:
Yalnızca komut başarılı olduktan sonra devam edin. NEW_KEY_ID değişkenine dönen ingest_key.id değerini yazın.Sonuç belirsizse aynı komutu yeniden çalıştırın. CLI bekleyen yeniden deneme anahtarını tekrar kullanır. Bu yeniden denemede --abandon-retry kullanmayın.Doğrudan API istemcisi tokenı yanıtta yalnızca bir kez alır. Yeniden denemek için aynı gövdeyle aynı Idempotency-Key başlığını gönderin. 24 saat boyunca bu yeniden deneme aynı anahtarı döndürür. Tokenı asla yazdırmayın, commit etmeyin veya paylaşmayın.
2

Eski anahtar etkinken yeni anahtarı dağıtın

Yeni tokenı korumalı dağıtım ayarına koyun. Uygulamayı dağıtın. Eski anahtarı etkin tutun. İki tokenı da kaynak koddan, derleme çıktısından ve loglardan uzak tutun.
3

Tek bir test olayı gönderin

Yeni tokenı new_ingest_key kabuk değişkenine aktarın. Tokenı yazdırmayın. Yeni anahtarla tek bir test logu gönderin, ardından geri okuyun:
Yalnızca okuma bu logu aynı occurred_at değeriyle döndürdüğünde devam edin. Daha eski bir yenileme kontrol logu, yeni anahtarın çalıştığını kanıtlamaz. Dağıtılan uygulamanın telemetri gönderdiğini de doğrulayın. Bir komut başarısız olursa durun ve yanıtı okuyun. Açığa çıkmadıysa eski anahtarı etkin tutun.
4

Gizli bilgi içermeyen anahtar meta verilerini listeleyin

LOGBREW_ACCOUNT_BEARER değişkenini hesap kimlik doğrulamanızdan ayarlayın. Eski anahtarın kimliğini bulun. NEW_KEY_ID anahtarının active olduğunu doğrulayın:
Yanıt, token içermeyen anahtar meta verilerinden oluşan bir dizidir. Durum active, expired veya revoked olur. expires_at zamanı geçen anahtar expired olur.
5

Yalnızca eski anahtarı iptal edin

OLD_KEY_ID değişkenini listeden ayarlayın. Komut eski anahtarı yalnızca iki kimlik farklıysa iptal eder:
DELETE idempotent bir işlemdir. Anahtar meta verilerini status: "revoked" ve dolu bir revoked_at ile döndürür. Belirsiz bir yanıttan sonra komutu güvenle tekrarlayabilirsiniz.unset new_ingest_key komutunu çalıştırın. Anahtar dosyasını gizli bilgi politikanıza göre yönetin.

Güvenle kurtarın

Yenileme yine başarısız olursa sorun bildirin. Yalnızca anahtar meta verilerini paylaşın. Kimlik bilgilerini, başlıkları, ham telemetriyi, müşteri verilerini, yerel yolları veya kaynak kodu eklemeyin.