Method: oauthClients.exchangeAppAttestAttestation

App Attest CBOR onayını kabul eder ve önceden yapılandırılmış ekibinizi ve paket kimliklerinizi kullanarak bunu Apple ile doğrular. Geçerliyse daha sonra oauthClients.exchangeAppAttestAssertion kullanılarak AppCheckToken ile değiştirilebilecek bir onay yapısı döndürür.

Kolaylık ve performans için bu yöntemin yanıt nesnesi, bir AppCheckToken de içerir (doğrulama başarılı olursa).

HTTP isteği

POST https://firebaseappcheck.googleapis.com/v1beta/{app=oauthClients/*}:exchangeAppAttestAttestation

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
app

string

Zorunlu. iOS uygulamasının şu biçimdeki göreli kaynak adı: 

projects/{project_number}/apps/{app_id}

Gerekirse project_number öğesi, Firebase projesinin proje kimliğiyle değiştirilebilir. Google'ın AIP 2510 standardında proje tanımlayıcıları kullanma hakkında daha fazla bilgi edinin.

Alternatif olarak, bu yöntem Uygulama Kontrolü tarafından korunan bir OAuth istemcisi için çağrılıyorsa, bu alan şu biçimde de olabilir: 

oauthClients/{oauth_client_id}

OAuth istemcilerinizin OAuth istemci kimliğini Google Cloud konsolunda görebilirsiniz. Şu anda yalnızca iOS OAuth istemcilerinin desteklendiğini ve bu istemcilerin ilgili iOS Firebase uygulamalarına bağlı olması gerektiğini unutmayın. Daha fazla bilgi için lütfen belgelere göz atın.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "attestationStatement": string,
  "challenge": string,
  "keyId": string,
  "limitedUse": boolean
}
Alanlar
attestationStatement

string ( bytes format)

Zorunlu. İstemci tarafı App Attest API tarafından döndürülen App Attest ifadesi. Bu, JSON yanıtındaki base64url kodlamalı bir CBOR nesnesidir.

Base64 kodlu bir dize.

challenge

string ( bytes format)

Zorunlu. Hemen önce oauthClients.generateAppAttestChallenge numarasına yapılan bir çağrı tarafından döndürülen tek seferlik sorgulama.

Base64 kodlu bir dize.

keyId

string ( bytes format)

Zorunlu. İstemci uygulaması için App Attest tarafından oluşturulan anahtar kimliği.

Base64 kodlu bir dize.

limitedUse

boolean

Bu onayın sınırlı kullanım ( true ) veya oturum tabanlı ( false ) bağlamda kullanım için mi olduğunu belirtir. Bu onayın tekrar oynatma koruması özelliğiyle birlikte kullanılmasını sağlamak için bunu true olarak ayarlayın. Varsayılan değer: false .

Yanıt gövdesi

Başarılı olursa yanıt gövdesi, ExchangeAppAttestAttestationResponse öğesinin bir örneğini içerir.