Direktlink „Gesichtslebendigkeit“ (Vorschau)

In diesem Artikel wird das Konzept des Quicklinks „Gesichtslebendigkeit", der Verwendungsfluss und verwandte Konzepte erläutert.

Einführung

Azure Gesichtslebendigkeit Quick Link ist ein optionaler Integrationspfad für die Gesichtslebendigkeits-Erkennung. Es austauscht das Sitzungsautorisierungstoken einer Liveness-Sitzung für eine einmalige URL, die die Gesichtserfassungserfahrung auf einer von Azure betriebenen Seite hostt. Der Dienst kehrt nach Abschluss des Vorgangs an einen vom Entwickler bereitgestellten Rückrufendpunkt zurück.

Azure Liveness-Schnelllink bietet Kunden mehrere Vorteile:

• Sie müssen das Liveness-Client-SDK nicht einbetten. Dies ermöglicht eine einfachere Integration auf der Anwendungsseite.
• Sie müssen keine Liveness-Client-SDK-Updates nachverfolgen. Von Azure verwaltete Websites verwenden immer die neueste Version der Lebendigkeitsprüfung.

So funktioniert es

Sie können die Lebendigkeits-Quicklink-Website liveness.face.azure.com verwenden, um eine Lebendigkeits-Sitzung in einen freigabefähigen, einmaligen Link umzuwandeln:

1. Starten Sie eine Sitzung mit Ihrem serverseitigen Code. Ihr Anwendungs-Back-End fordert eine neue Liveness-Sitzung von der Face-API an und empfängt ein kurzlebiges Autorisierungstoken, das diese Sitzung darstellt.

2. Tauschen Sie das Sitzungstoken für einen Link aus. Ihr Anwendungs-Back-End sendet das Token an den Schnelllinkdienst, der eine einmalige URL erstellt, die mit der Sitzung verbunden ist. Hier sind Beispiele für die Postanforderung:

   C#

   var client = new HttpClient();
   var request = new HttpRequestMessage
   {
       Method = HttpMethod.Post,
       RequestUri = new Uri("https://liveness.face.azure.com/api/quicklink"),
       Headers =
       {
           { "authorization", "Bearer  <session-authorization-token>" },
       },
   };
   using (var response = await client.SendAsync(request))
   {
       response.EnsureSuccessStatusCode();
       var body = await response.Content.ReadAsStringAsync();
       Console.WriteLine(body);
   }
   

   Java

   HttpRequest request = HttpRequest.newBuilder()
       .uri(URI.create("https://liveness.face.azure.com/api/quicklink"))
       .header("authorization", "Bearer <session-authorization-token>")
       .method("POST", HttpRequest.BodyPublishers.noBody())
       .build();
   HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
   System.out.println(response.body());
   

   Python

   import http.client
   
   conn = http.client.HTTPSConnection("liveness.face.azure.com")
   
   headers = {
       'authorization': "Bearer <session-authorization-token>"
       }
   
   conn.request("POST", "/api/quicklink", headers=headers)
   
   res = conn.getresponse()
   data = res.read()
   
   print(data.decode("utf-8"))
   
   

   JavaScript

   fetch("https://liveness.face.azure.com/api/quicklink", {
     "method": "POST",
     "headers": {
       "authorization": "Bearer <session-authorization-token>"
     }
   })
   .then(response => {
     console.log(response);
   })
   .catch(err => {
     console.error(err);
   });
   

   REST(Windows)

   curl --request POST ^
     --url https://liveness.face.azure.com/api/quicklink ^
     --header 'authorization: Bearer <session-authorization-token>'
   

   REST(Linux)

   curl --request POST \
     --url https://liveness.face.azure.com/api/quicklink \
     --header 'authorization: Bearer <session-authorization-token>'
   

Hier sehen Sie eine Beispielantwort:

{
  "url": "/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f"
}

3. Verfassen Sie den Link, und senden Sie ihn an den Benutzer. Verwenden Sie den URL-Antwortwert, um die Liveness-Schnelllink-Webseite zu erstellen. Optional können Sie auch eine Rückruf-URL hinzufügen: https://liveness.face.azure.com/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f&&callbackUrl=<encoded url> Sie können den Browser umleiten oder eine Schaltfläche anzeigen – alles, was dem Benutzer das Öffnen des Links auf einem Gerät ermöglicht.
4. Azure hostet die Erfassungserfahrung. Wenn der Link geöffnet wird, führt die von Azure betriebene Seite den Benutzer mithilfe des neuesten Liveness-Webclients durch die Liveness-Prüfsequenz.
5. Rufen Sie den Ergebnisrückruf ab. Sobald die Überprüfung abgeschlossen ist – oder wenn der Benutzer das Zeitüberschreitungsverhalten verlässt – benachrichtigt der Quicklinkdienst Ihren Rückrufendpunkt, damit Ihre Anwendung entscheiden kann, was als Nächstes geschieht.

Url-Verarbeitung von Schnelllinks

Die URL, die vom Quicklink-Dienst zurückgegeben wird, ist ein Übertragungsgeheimnis: Jeder, der den Link besitzt, kann die zugehörige Liveness-Sitzung initiieren, abschließen oder abbrechen. Wenn eine böswillige Partei den Link abfängt, bevor der beabsichtigte Benutzer ihn öffnet, kann sie die Sitzung nutzen oder fälschen und verhindern, dass der berechtigte Benutzer die Überprüfung abschließt – wodurch ein Abstreitungs- und Identitätsrisiko entsteht. Um dieses Risiko zu minimieren, übertragen Sie den Link nur über geschützte Kanäle, vermeiden Sie es in Protokollen oder Analysen, und verringern Sie nach Möglichkeit die Lebensdauer der Lebendigkeits-Sitzung.