Skip to main content
Public API’yi kullanmak için OAuth’a ihtiyacınız yoktur. Özel, sunucu tarafı bir entegrasyon için kapsamı sınırlandırılmış bir API anahtarıyla başlayın ve hızlı başlangıç kılavuzunu izleyin. Güvenlik politikanız kısa ömürlü erişim belirteçleri gerektiriyorsa veya entegrasyon platformunuz bu akışı zaten destekliyorsa OAuth istemci kimlik bilgilerini seçin. Her iki seçenek de bir hizmet hesabı kullanır. Hizmet hesabı, entegrasyonun kimliğidir; üçüncü bir kimlik doğrulama yöntemi değildir.

​
Bileşenler birbiriyle nasıl uyum sağlar

Her entegrasyon için bir hizmet hesabı oluşturun. Bu hesap için bir API anahtarı veya bir OAuth istemcisi seçin; her API isteğinde her iki yöntemi birden kullanmanız gerekmez. Hiçbir kimlik bilgisi hesabın geçerli izinlerini aşamaz. Hızlı başlangıç kılavuzu Basic kimlik doğrulamasını kullanır. API anahtarları için Bearer üst bilgisi de desteklenir; bu üst bilgiyi kullanmak bir OAuth istemcisine ihtiyacınız olduğu anlamına gelmez.

​
Basit bir entegrasyon için API anahtarını seçin

Gizli değerin gizli anahtar yöneticinizde saklanması güvenlik gereksinimlerinize uygunsa, kendi zamanlanmış işleriniz, raporlama betikleriniz, veri hatlarınız veya diğer arka uç hizmetleriniz için bir API anahtarı kullanın.
  • Kimliği doğrulanmış istekleri doğrudan yapın; belirteç değişimi gerekmez.
  • Yalnızca iş yükünün ihtiyaç duyduğu izinleri seçin ve bir son kullanma tarihi belirleyin.
  • Anahtarı çakışma süresini kullanarak yenileyin veya açığa çıkması durumunda hemen iptal edin.
API anahtarı kullanan bir entegrasyon için OAuth istemcisi gerekmez. Hızlı başlangıç kılavuzuyla başlayın, ardından oluşturma ve yenileme için API anahtarları sayfasına bakın.

​
Kısa ömürlü erişim belirteçleri için OAuth’u seçin

Kuruluşunuz süresi dolan erişim belirteçleri gerektiriyorsa veya bir entegrasyon aracı client_credentials akışını bekliyorsa, gizli bir arka uç hizmeti için OAuth istemci kimlik bilgilerini kullanın.
  1. Hizmet hesabı için kapsamı sınırlandırılmış bir OAuth istemcisi oluşturun.
  2. Kurulum sırasında sağlanan istemci kimlik doğrulama yöntemini kullanarak istemcinin kimliğini bölgesel belirteç uç noktanızda doğrulayın.
  3. Elde edilen erişim belirtecini API isteklerinizle birlikte gönderin. Geçerli belirtecin süresi dolmadan yeni bir belirteç alın.
OAuth, entegrasyonunuza belirteç edinme ve süre sonu yönetimi ekler. İstemci gizli değerinin yine de güvenli biçimde saklanması ve yenilenmesi gerekir; kısa ömürlü belirteçler bu sorumluluğu ortadan kaldırmaz. İstemci kimlik bilgileri akışı yenileme belirteçleri kullanmaz: yeni bir erişim belirteci almak için istemcinin kimliğini yeniden doğrulayın. OAuth erişiminin kuruluşunuz için etkinleştirilmiş olması gerekir. Etkinleştirilmemişse bir API anahtarı kullanın veya gereksinimleriniz hakkında Living Security Destek ekibiyle iletişime geçin. İstemci oluşturma, tek seferlik gizli değerler, iptal ve kurtarma hakkında bilgi için OAuth istemci kimlik bilgileri sayfasına bakın.

​
Kimlik bilgilerini arka uçta tutun

Hizmet hesabı API anahtarları ve OAuth istemci gizli değerleri sunucu tarafı gizli anahtar depolama alanında bulunmalıdır. Bunları tarayıcı koduna, mobil uygulamalara, kaynak kontrolüne veya günlüklere koymayın. Hizmet hesabı kimlik bilgisi iş yükü olarak hareket eder; bir kişinin oturum açmasını sağlamaz ve müşteri onayı akışı sunmaz. Her iki yöntemle de kuruluşunuz için bölgesel API ana bilgisayarını kullanın. Kimlik doğrulama yöntemlerini değiştirmek kaynak URL’sini, API sürümünü veya bir işlemin gerektirdiği izinleri değiştirmez.