Szybki link do aplikacji Face Liveness (wersja zapoznawcza)

W tym artykule wyjaśniono koncepcję szybkiego łącza dotyczącego aktywności rozpoznawania twarzy, sposobu użycia i powiązanych pojęć.

Introduction

Szybki link do usługi Azure Face Liveness to opcjonalna ścieżka integracji do wykrywania na żywo rozpoznawania twarzy. Wymienia token autoryzacji sesji sesji liveness na jednokrotnego użycia adres URL, który obsługuje przechwytywanie twarzy na stronie obsługiwanej przez platformę Azure. Usługa powraca do dostarczonego przez dewelopera końcowego punktu wywołania zwrotnego po zakończeniu operacji.

Szybki link do usługi Azure Liveness zapewnia klientom wiele korzyści:

• Nie musisz osadzać zestawu SDK klienta liveness. Umożliwia to łatwiejszą integrację po stronie aplikacji.
• Nie musisz śledzić aktualizacji klienta SDK do weryfikacji aktywności. Witryny obsługiwane przez Azure używają najnowszej wersji wykrywania aktywności.

Jak to działa

Możesz skorzystać ze strony internetowej szybkiego odsyłacza liveness, liveness.face.azure.com, aby przekształcić sesję w jednokrotnego użytku link do udostępnienia.

1. Rozpocznij sesję przy użyciu kodu po stronie serwera. Zaplecze aplikacji żąda nowej sesji liveness z interfejsu API rozpoznawania twarzy i otrzymuje krótkotrwały token autoryzacji reprezentujący sesję.

2. Zamień token sesji na link. Zaplecze aplikacji wysyła token do usługi szybkiego łącza, która tworzy jednorazowy adres URL połączony z sesją. Oto przykłady tego żądania POST:

   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>'
   

Poniżej znajduje się przykładowa odpowiedź:

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

3. Utwórz link i wyślij go do użytkownika. Użyj wartości odpowiedzi adresu URL, aby skonstruować stronę internetową szybkiego linku na żywo. Opcjonalnie możesz również dodać adres URL wywołania zwrotnego: https://liveness.face.azure.com/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f&&callbackUrl=<encoded url> możesz przekierować przeglądarkę lub wyświetlić przycisk — wszystko, co pozwala użytkownikowi otworzyć link na urządzeniu.
4. Platforma Azure hostuje środowisko przechwytywania. Po otwarciu linku strona obsługiwana przez Azure przeprowadzi użytkownika przez sekwencję weryfikacji żywotności, korzystając z najnowszego klienta webowego Liveness.
5. Pobierz wynik wywołania zwrotnego. Gdy tylko sprawdzanie zakończy się — lub jeśli użytkownik porzuci lub upłynął limit czasu — usługa szybkiego łącza powiadomi punkt końcowy wywołania zwrotnego, aby aplikacja mogła zdecydować, co się stanie dalej.

Obsługa szybkich linków URL

Adres URL zwracany przez serwis szybkiego łącza jest tajnym kluczem dostępu: każdy, kto posiada link, może zainicjować, ukończyć lub anulować skojarzoną sesję liveness. Jeśli złośliwy podmiot przechwyci link przed jego otwarciem przez docelowego użytkownika, może użyć lub sfałszować sesję i uniemożliwić uprawnionemu użytkownikowi ukończenie weryfikacji — stwarzając ryzyko odmowy i podszycia się. Aby zminimalizować to ryzyko, należy przesyłać link tylko za pośrednictwem chronionych kanałów, unikać utrwalania go w dziennikach lub analizie oraz, jeśli to możliwe, obniżając okres istnienia sesji aktywności.