Rychlý odkaz Face Liveness (Preview)

Tento článek vysvětluje koncept rychlého odkazu pro autentizaci obličeje, postup jeho použití a související koncepty.

Introduction

Jednoduchý odkaz Azure Face Liveness představuje volitelnou integrační cestu pro detekci živé tváře. Vymění autorizační token relace živosti za jednorázovou adresu URL, která zajišťuje prostředí pro zachycení tváře na stránce provozované na Azure. Služba se po dokončení operace vrátí do koncového bodu zpětného volání zadaného vývojářem.

Rychlý odkaz Azure Liveness poskytuje zákazníkům několik výhod:

• Klientskou sadu SDK liveness nemusíte vkládat. To umožňuje snadnější integraci na straně aplikace.
• Nemusíte sledovat aktualizace klientské sady SDK pro liveness. Weby provozované v Azure vždy používají nejnovější verzi detekce živé aktivity.

Jak to funguje

Pomocí webové stránky liveness.face.azure.com pro rychlé odkazy na liveness můžete převést relaci liveness na odkaz pro jedno použití, který je možné sdílet.

1. Zahajte relaci s vaším serverovým kódem. Back-end vaší aplikace požaduje novou relaci živé aktivity z rozhraní API pro rozpoznávání tváře a obdrží krátkodobý autorizační token, který představuje danou relaci.

2. Vyměňte relace token za odkaz Back-end vaší aplikace odešle token službě rychlého odkazu, která vytvoří jednorázovou adresu URL připojenou k relaci. Tady jsou příklady požadavku typu 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>'
   

Následuje příklad odpovědi.

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

3. Vytvořte odkaz a odešlete ho uživateli. Pomocí hodnoty odpovědi adresy URL vytvořte webovou stránku rychlého odkazu liveness. Volitelně můžete přidat také adresu URL zpětného volání: https://liveness.face.azure.com/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f&&callbackUrl=<encoded url> Prohlížeč můžete přesměrovat nebo zobrazit tlačítko – cokoli, co uživateli umožní otevřít odkaz na zařízení.
4. Azure hostuje prostředí pro zachytávání. Když se odkaz otevře, stránka spravovaná Azure provede uživatele sekvencí kontroly živosti pomocí nejnovější webové aplikace Liveness.
5. Získejte zpětné volání výsledku. Jakmile se kontrola dokončí, nebo pokud uživatel opustí systém či dojde k překročení časového limitu, služba rychlého propojení upozorní váš callback endpoint, aby vaše aplikace mohla rozhodnout, co se stane dál.

Zpracování adres URL rychlých odkazů

Adresa URL vrácená službou rychlých odkazů je tajný klíč typu bearer: kdokoli, kdo má tento odkaz, může zahájit, dokončit nebo zrušit přidruženou relaci ověření živosti. Pokud škodlivá strana zachytí odkaz před tím, než ho zamýšlený uživatel otevře, může relaci zneužít nebo podvrhnout a zabránit legitimnímu uživateli ve dokončení kontroly, čímž vzniká riziko popření a zosobnění. Pokud chcete toto riziko minimalizovat, předejte odkaz pouze přes chráněné kanály, vyhněte se jeho uložení v protokolech nebo analytice a pokud je to možné, snižte dobu trvání liveness relace.