İçeriğe geç
Bize ulaşın
Belgeler menüsüKaynaklar ve anahtarlar

Kaynaklar ve anahtarlar. Kim gönderiyor, neyle.

Uygulamaya veri gönderen her istemci bir kaynaktır ve kendi anahtarlarıyla kimliğini kanıtlar. Anahtarlar kaynağa ve ortama bağlıdır; birini iptal etmek diğer kaynakları etkilemez.

Kaynak türleri ve ortamlar

Kaynak türü oluşturulurken seçilir ve sonradan değişmez. Ortam, ekranların hangi trafiği göstereceğini belirler; varsayılan canlıdır.

TürNe için
webWeb sitesi ya da web uygulaması; script etiketi ya da npm paketi.
ios, androidMobil uygulama (mobil SDK sonraki aşamada; HTTP ile gönderilebilir).
serverÜrünün sunucusu; imzalı istek önerilir.
otherBaşka bir istemci, ör. Segment uyumlu bir kütüphane.

Yazma anahtarı (pk_…)

pk_live_ ya da pk_test_ ile başlar ve 32 karakter sürer. Tarayıcıda ve mobil uygulamada açıkta durabilir: yalnız veri gönderir, hiçbir şey okuyamaz. Veritabanında yalnız özeti tutulur.

İstekte HTTP Basic kullanıcı adı olarak (şifre boş, Segment uyumlu), Authorization: Bearer ile ya da tarayıcı beacon’ında gövdedeki writeKey alanıyla gönderilir.

İmza anahtarı (sk_…)

sk_live_ ya da sk_test_ ile başlar ve 48 karakter sürer. Yalnız sunucuda kullanılır ve isteği Metrics-Signature başlığıyla imzalar. Kaynakta İmza zorunlu açıksa imzasız istek 401 signature_required alır.

Test anahtarları

_test_ anahtarla gelen her olay test olarak işaretlenir; ekranlar test trafiğini varsayılan olarak dışlar. Canlı anahtarla gönderilen tek bir olayı test saymak için properties.test: true yazın.

İzinli alan adları ve hariç yollar

  • Web kaynaklarında tarayıcının Origin başlığı izinli alan adlarında değilse istek 403 origin_not_allowed alır.
  • Hariç yollar (/panel, /account/*, /**/private gibi desenler) otomatik yakalamayı kapatır; bu sayfalardan gönderilen olaylarda sayfa [excluded] olur.
  • İkisi de panelden değişir ve SDK’ya uzak yapılandırmayla (GET /v1/config/{writeKey}) ulaşır; kod değiştirmek gerekmez.

Anahtar yenileme

  • Yeni bir anahtar oluşturun ve dağıtın.
  • Eskisini bir geçiş süresiyle iptal edin: hemen, 1 saat, 24 saat ya da en çok 7 gün. Süre boyunca anahtar “sona eriyor” durumunda çalışır, sonra reddedilir.
  • İmza anahtarı yenilenirken istek birden çok v1= imzası taşıyabilir; geçerli olanlardan biri yeter.

İlgili sayfalar