Link rápido do Face Liveness (pré-visualização)

Este artigo explica o conceito de link rápido de vivacidade facial, seu fluxo de uso e conceitos relacionados.

Introduction

O link rápido do Azure Vivacidade Facial é um caminho de integração opcional para a deteção de vivacidade facial. Ele troca o token de autorização de sessão de uma sessão ao vivo por uma URL de uso único que hospeda a experiência de captura de rosto em uma página operada pelo Azure. O serviço retorna a um endpoint de callback fornecido pelo programador após a conclusão da operação.

O link rápido do Azure Liveness oferece vários benefícios aos clientes:

• Não é necessário incorporar o SDK do cliente liveness. Isso permite uma integração mais fácil no lado do aplicativo.
• Você não precisa acompanhar as atualizações do SDK do cliente Liveness. Os sites operados pelo Azure sempre usam a versão mais recente da deteção de vivacidade.

Como funciona

Você pode usar o site de links rápidos de liveness, liveness.face.azure.com, para transformar uma sessão de liveness em um link compartilhável de uso único:

1. Inicie uma sessão com o código do lado do servidor. O back-end da aplicação solicita uma nova sessão de verificação ao vivo da API do Face e recebe um token de autorização de curta duração que representa essa sessão.

2. Troque o token de sessão por um link. O back-end do aplicativo envia o token para o serviço de link rápido, que cria uma URL única conectada à sessão. Aqui estão exemplos da solicitação de postagem:

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

Segue-se um exemplo de resposta:

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

3. Componha o link e envie-o para o usuário. Use o valor de resposta de URL para construir a página da Web de link rápido de liveness. Opcionalmente, você também pode adicionar uma URL de retorno de chamada: https://liveness.face.azure.com/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f&&callbackUrl=<encoded url> você pode redirecionar o navegador ou mostrar um botão — qualquer coisa que permita ao usuário abrir o link em um dispositivo.
4. O Azure hospeda a experiência de captura. Quando o link é aberto, a página operada pelo Azure orienta o usuário pela sequência de verificação de vivacidade usando o cliente Web Liveness mais recente.
5. Obtenha a chamada de retorno do resultado. Assim que a verificação terminar, ou se o utilizador abandonar ou exceder o tempo limite, o serviço de link rápido notificará o seu endpoint de callback, de modo que a sua aplicação possa decidir o que fazer a seguir.

Tratamento rápido de URLs de links

O URL retornado pelo serviço de link rápido é um segredo do portador: qualquer pessoa que possua o link pode iniciar, completar ou cancelar a sessão de liveness associada. Se uma parte mal-intencionada intercetar o link antes que o usuário pretendido o abra, ele poderá consumir ou falsificar a sessão e impedir que o usuário legítimo conclua a verificação, criando um risco de repúdio e falsificação de identidade. Para minimizar esse risco, transmita o link apenas por canais protegidos, evite persisti-lo em logs ou análises e, quando possível, reduza o tempo de vida da sessão de liveness.