Method: projects.apps.exchangeAppAttestAttestation

Akceptuje atest CBOR App Attest i weryfikuje go w Apple przy użyciu wstępnie skonfigurowanych identyfikatorów zespołów i pakietów. Jeśli jest prawidłowy, zwraca artefakt atestu, który można później wymienić na AppCheckToken za pomocą apps.exchangeAppAttestAssertion ,

Dla wygody i wydajności obiekt odpowiedzi tej metody będzie też zawierał AppCheckToken (jeśli weryfikacja się powiedzie).

Żądanie HTTP

POST https://firebaseappcheck.googleapis.com/v1/{app=projects/*/apps/*}:exchangeAppAttestAttestation

Adres URL używa Transkodowanie gRPC składni.

Parametry ścieżki

Parametry
app

string

Wymagane. Względna nazwa zasobu aplikacji na iOS, w formacie: 

projects/{project_number}/apps/{app_id}

W razie potrzeby project_number element można zastąpić identyfikatorem projektu Firebase. Więcej informacji o korzystaniu z identyfikatorów projektów znajdziesz na stronie AIP 2510 standardowy.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "attestationStatement": string,
  "challenge": string,
  "keyId": string,
  "limitedUse": boolean
}
Pola
attestationStatement

string ( bytes format)

Wymagane. Instrukcja App Attest zwrócona przez interfejs App Attest API po stronie klienta. Jest to obiekt CBOR zakodowany w base64url w odpowiedzi JSON.

Ciąg zakodowany w formacie base64.

challenge

string ( bytes format)

Wymagane. Jednorazowe wyzwanie zwrócone przez bezpośrednie połączenie do apps.generateAppAttestChallenge ,

Ciąg zakodowany w formacie base64.

keyId

string ( bytes format)

Wymagane. Identyfikator klucza dla aplikacji klienckiej wygenerowany przez App Attest.

Ciąg zakodowany w formacie base64.

limitedUse

boolean

Określa, czy ten atest jest używany w ograniczone użycie ( true ) lub na podstawie sesji ( false ). Aby włączyć ten atest używany z ochrona przed ponownym odtwarzaniem funkcji, ustaw tę wartość na true , Wartość domyślna to false ,

Treść odpowiedzi

Wiadomość z odpowiedzią dla apps.exchangeAppAttestAttestation .

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "artifact": string,
  "appCheckToken": {
    object (AppCheckToken)
  }
}
Pola
artifact

string ( bytes format)

Artefakt, którego można użyć w przyszłych wywołaniach funkcji apps.exchangeAppAttestAssertion ,

Ciąg zakodowany w formacie base64.

appCheckToken

object ( AppCheckToken )

Obejmuje token Sprawdzania aplikacji.