Face Liveness 빠른 링크(미리 보기)

이 문서는 안면 생체 인식 빠른 링크의 개념, 사용 흐름 및 관련 개념을 설명합니다.

소개

Azure Face Liveness 빠른 링크는 얼굴 활동 감지를 위한 선택적 통합 경로입니다. 라이브니스 세션의 세션 권한 부여 토큰을 Azure 운영 페이지에서 얼굴 캡처 환경을 호스팅하는 일회용 URL로 교환합니다. 서비스는 작업을 완료한 후 개발자가 제공한 콜백 엔드포인트로 돌아갑니다.

Azure Liveness 빠른 링크는 고객에게 다음과 같은 여러 이점을 제공합니다.

• 라이브니스 클라이언트 SDK를 포함할 필요가 없습니다. 이를 통해 애플리케이션 쪽에서 더 쉽게 통합할 수 있습니다.
• 라이브니스 클라이언트 SDK 업데이트를 따라갈 필요가 없습니다. Azure로 운영되는 웹 사이트는 항상 최신 버전의 생체 인식을 사용합니다.

작동 방식

생체 인식 빠른 링크 웹 사이트인 liveness.face.azure.com을 사용하여 생체 인식 세션을 공유 가능한 일회용 링크로 전환할 수 있습니다.

1. 서버 쪽 코드로 세션을 시작합니다. 애플리케이션 백 엔드는 Face API에서 새 활동성 세션을 요청하고 해당 세션을 나타내는 수명이 짧은 권한 부여 토큰을 받습니다.

2. 링크에 대한 세션 토큰을 교환합니다. 애플리케이션 백 엔드는 토큰을 빠른 링크 서비스로 보내 세션에 연결된 일회성 URL을 만듭니다. 다음은 게시 요청의 예입니다.

   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());
   

   파이썬

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

다음은 응답의 예입니다.

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

3. 링크를 작성하여 사용자에게 보냈습니다. URL 응답 값을 사용하여 생체 인식 빠른 링크 웹 페이지를 생성합니다. 필요에 따라 콜백 URL을 추가할 수도 있습니다. https://liveness.face.azure.com/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f&&callbackUrl=<encoded url> 브라우저를 리디렉션하거나 사용자가 디바이스에서 링크를 열 수 있는 모든 단추를 표시할 수 있습니다.
4. Azure는 캡처 환경을 호스트합니다. 링크가 열리면 Azure 운영 페이지에서 최신 Liveness 웹 클라이언트를 사용하여 활동성 검사 시퀀스를 안내합니다.
5. 결과 콜백을 가져옵니다. 확인이 완료되거나 사용자가 중단되거나 시간이 초과되는 즉시 빠른 링크 서비스가 콜백 엔드포인트에 알리므로 애플리케이션에서 다음에 발생할 작업을 결정할 수 있습니다.

빠른 링크 URL 처리

빠른 링크 서비스에서 반환된 URL은 전달자 비밀입니다. 링크를 소유한 모든 사용자는 연결된 활동 세션을 시작, 완료 또는 취소할 수 있습니다. 의도된 사용자가 링크를 열기 전에 악의적인 당사자가 링크를 가로채면, 합법적인 사용자가 확인을 완료하지 못하게 세션을 소비하거나 스푸핑할 수 있습니다. 이 경우 부인 및 가장의 위험을 초래할 수 있습니다. 이러한 위험을 최소화하려면 보호된 채널을 통해서만 링크를 전송하고, 로그 또는 분석에서 링크를 유지하지 말고, 가능하면 활동성 세션의 수명을 낮춥니다.