Yüz Canlılığı hızlı bağlantısı (önizleme)

Bu makalede Yüz canlılığı hızlı bağlantısı kavramı, kullanım akışı ve ilgili kavramlar açıklanmaktadır.

Introduction

Azure Yüz Tanıma Canlılığı hızlı bağlantısı, Yüz canlılığı algılama için isteğe bağlı bir tümleştirme yoludur. Canlılık oturumunun oturum yetkilendirme belirteci, Microsoft Azure tarafından işletilen bir sayfada yüz yakalama deneyimini barındıran tek kullanımlık bir URL ile değiştirilir. Hizmet, işlemi tamamladıktan sonra geliştirici tarafından sağlanan bir geri çağırma uç noktasına döner.

Azure Canlılık hızlı bağlantısı müşterilere birden çok avantaj sağlar:

• Canlılık istemci SDK'sını eklemeniz gerekmez. Bu, uygulama tarafında daha kolay tümleştirme sağlar.
• Canlılık istemci SDK güncellemelerini takip etmenize gerek yok. Azure tarafından çalıştırılan web siteleri her zaman canlılık algılamanın en son sürümünü kullanır.

Nasıl çalışır?

Canlılık oturumunu paylaşılabilir, tek kullanımlık bir bağlantıya dönüştürmek için canlılık hızlı bağlantı web sitesini liveness.face.azure.comkullanabilirsiniz:

1. Sunucu tarafı kodunuzla bir oturum başlatın. Uygulamanızın arka ucu Yüz Tanıma API'sinden yeni bir canlılık oturumu isteğinde bulunur ve bu oturumu temsil eden kısa süreli bir yetkilendirme belirteci alır.

2. Bağlantı için oturum belirtecini değiştirin. Uygulamanızın arka ucu belirteci hızlı bağlantı hizmetine gönderir ve bu da oturuma bağlı tek seferlik bir URL oluşturur. Gönderi isteği örnekleri aşağıda verilmiştir:

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

Aşağıda örnek bir yanıt gösterilmektedir:

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

3. Bağlantıyı oluşturup kullanıcıya gönderdi. URL yanıt değerini kullanarak canlılığın hızlı bağlantı web sayfasını oluşturun. İsteğe bağlı olarak bir geri arama URL'si de ekleyebilirsiniz: https://liveness.face.azure.com/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f&&callbackUrl=<encoded url> Tarayıcıyı yeniden yönlendirebilir veya kullanıcının bağlantıyı cihazda açmasına izin veren herhangi bir düğme gösterebilirsiniz.
4. Azure yakalama deneyimini sunuyor. Bağlantı açıldığında Azure tarafından çalıştırılan sayfa, en son Canlılık web istemcisini kullanarak kullanıcıya canlılık denetimi sırasında yol gösterir.
5. Sonuç geri çağrısını al. Denetim biter bitmez veya kullanıcı vazgeçer ya da oturum zaman aşımına uğrarsa, hızlı bağlantı hizmeti geri çağırma uç noktanızı bilgilendirir, böylece uygulamanız bundan sonra ne olacağına karar verebilir.

Hızlı bağlantı URL'si işleme

Hızlı bağlantı hizmeti tarafından döndürülen URL bir taşıyıcı gizli dizidir: bağlantıya sahip olan herkes ilişkili canlılık oturumunu başlatabilir, tamamlayabilir veya iptal edebilir. Kötü amaçlı bir taraf, bağlantıyı hedeflenen kullanıcı açmadan önce ele geçirirse, bir oturumu tüketebilir veya taklit edebilir ve meşru kullanıcının kontrolü tamamlamasını önleyerek reddetme ve taklit riski oluşturabilir. Bu riski en aza indirmek için bağlantıyı yalnızca korumalı kanallar üzerinden iletin, günlüklerde veya analizlerde kalıcı hale getirmeyin ve mümkün olduğunda etkin oturumun süresini kısaltın.