OAuth erişimi kuruluşunuz için etkinleştirilmiş olmalıdır. Kurulumunuz; bölgesel belirteç uç noktasını, veren tarafı (issuer), hedef kitleyi (audience) ve istemci kimlik doğrulama yöntemini sağlar. Bu ayarlara ihtiyacınız varsa veya istemci yönetimine erişemiyorsanız Living Security Destek ekibiyle iletişime geçin.
Başlamadan önce
- Yalnızca entegrasyonun ihtiyaç duyduğu izinlere sahip bir hizmet hesabı oluşturun.
- Yeni istemciye vermek istediğiniz
service_account:manageve her izne sahip bir yönetim kimlik bilgisi kullanın. Hedef hesap da bu izinlere sahip olmalıdır. Bir istemci, hiçbir hesabın yetkisini genişletemez. - Kuruluşun bölgesini seçin. API kimlik bilgileri ve OAuth erişim belirteçleri, eşleşen bölgesel API ana bilgisayarına ait olmalıdır.
- İstemci gizli anahtarını ve belirteçleri sunucu tarafındaki gizli anahtar deponuzda saklayın. Bunları hiçbir zaman tarayıcı koduna, mobil uygulamalara, kaynak kontrolüne veya istek günlüklerine eklemeyin.
İstemci oluşturma
POST /v1/oauth_clients için service_account_id, açık scopes içeren boş olmayan bir liste ve bir Idempotency-Key gereklidir. Joker karakterler kabul edilmez. Bir istemci, toplam uzunluğu en fazla 4.096 karakter olan en çok 100 kapsamı destekler. Her hizmet hesabı en fazla 20 istemciye veya çözümlenmemiş oluşturma/temizleme işlemine sahip olabilir. İptal işlemi API erişimini hemen reddeder. Bir istemci veya belirsiz bir sağlayıcı oluşturma işlemi, uzak temizleme onaylanana kadar sınıra dahil edilmeye devam eder. Terk edilmiş bir rezervasyon veya sağlayıcı işlemi başlamadan önce başarısız olduğu kanıtlanmış bir oluşturma işlemi, yuvasını güvenle serbest bırakabilir. Bu işlemin yeniden deneme anahtarı yine ilk denemeye aittir; yerine yenisini oluşturmaya karar vermeden önce bu makbuzu kurtarın.
Bu oluşturma denemesi için bir yeniden deneme anahtarı seçin ve isteği göndermeden önce kalıcı olarak saklayın. Boşluk içermeyen, 1–255 görünür ASCII karakteri kullanın. Yanıt kaybolduktan sonra aynı hesap, kapsamlar, yönetim sorumlusu, bölge ve API sürümüyle aynı anahtarı yeniden kullanın. Aynı hizmet hesabı altında yönetim kimlik bilgisini döndürmek yeni bir yeniden deneme kimliği oluşturmaz.
Python’un requests paketini yükleyin. Aşağıdaki ortam değerlerini normal gizli anahtar ve yapılandırma yönetiminiz aracılığıyla yükleyin:
Python
201 kullanır ve id, service_account_id, client_id, scopes, status, created_at ve client_secret içeren bir oauth_client kaynağı barındırır. Yanıtlar Cache-Control: no-store olarak işaretlenir.
idplatform kaynağını tanımlar. Almak ve iptal etmek için kaydedin.client_idbelirteç değişimi sırasında istemciyi tanımlar. Platform kaynak kimliği değildir. Oluşturma beklemedeykennullolabilir.client_secretyalnızca oluşturmayı tamamlayan isteğe döndürülür. Başarılı yanıtın kaybolmasından sonraki yeniden deneme dahil, tekrarlanan her oluşturma isteğinulldöndürür. Alma işlemi hiçbir zaman gizli anahtar döndürmez.
Kaybolan veya kesintiye uğrayan yanıttan kurtarma
Kaynak makbuzunu kurtarmak için kaydedilmiş yeniden deneme anahtarıyla aynı oluşturma isteğini tekrarlayın. Makbuz güncel durumu yansıtır; bu nedenle iptal edilmiş bir istemci iptal edilmiş olarak kalır. Bu işlem, genel 24 saatlik önbelleğe alınmış yanıtı yeniden oynatma sözleşmesini kullanmaz veIdempotent-Replayed üst bilgisi döndürmez.
İstek kimlikleri ve kurtarma ayrıntıları için hatalar sayfasına bakın. Destek talebiyle birlikte hiçbir zaman istemci gizli anahtarı veya erişim belirteci göndermeyin.
İnceleme ve iptal
Yönetim kimlik bilgilerinizi ve platform kaynağıid değerini kullanın:
İptal işlemi, daha önce verilmiş belirteçlerle yapılan istekler dahil olmak üzere istemcinin sonraki API isteklerini engeller. API tarafından önceden kabul edilmiş işleri iptal etmez. Uzak kimlik bilgisi temizliği daha sonra tamamlanabilir. İptal işlemini tekrarlamak güvenlidir ve yeniden deneme anahtarı gerektirmez. İptal edilen istemcinin kendisi bir API çağıranıysa yönetim kimlik bilgisini kullanmaya devam edin.

