Tautan cepat Face Liveness (pratinjau)

Artikel ini menjelaskan konsep tautan cepat untuk keaktifan wajah, alur penggunaannya, dan konsep terkait.

Pendahuluan

Tautan cepat Wajah Azure Liveness adalah jalur integrasi opsional untuk deteksi keaktivitas Wajah. Ini menukar token otorisasi sesi untuk sesi liveness dengan URL sekali pakai yang menghosting pengalaman penangkapan wajah di halaman yang dioperasikan oleh Azure. Layanan kembali ke titik akhir panggilan balik yang disediakan pengembang setelah menyelesaikan operasi.

Tautan cepat Azure Liveness memberikan beberapa manfaat bagi pelanggan:

• Anda tidak perlu menyematkan SDK klien liveness. Hal ini memungkinkan integrasi yang lebih mudah di sisi aplikasi.
• Anda tidak perlu melacak pembaruan SDK klien liveness. Situs web yang dioperasikan Azure selalu menggunakan deteksi liveness versi terbaru.

Cara kerjanya

Anda dapat menggunakan situs web tautan cepat liveness, liveness.face.azure.com, untuk mengubah sesi liveness menjadi tautan penggunaan tunggal yang dapat dibagikan:

1. Mulai sesi dengan kode sisi server Anda. Backend aplikasi Anda meminta sesi keaktifan baru dari Face API dan menerima token otorisasi berumur pendek yang mewakili sesi tersebut.

2. Tukar token sesi dengan tautan. Backend aplikasi Anda mengirimkan token ke layanan tautan instan, yang membuat tautan sekali pakai terhubung dengan sesi. Berikut adalah contoh permintaan postingan:

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

Berikut adalah contoh respons:

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

3. Buat tautan dan kirimkan ke pengguna. Gunakan nilai respons URL untuk membangun halaman web tautan cepat liveness. Secara opsional Anda juga dapat menambahkan URL panggilan balik: https://liveness.face.azure.com/?s=60c3980c-d9f6-4b16-a7f5-f1f4ad2b506f&&callbackUrl=<encoded url> Anda dapat mengalihkan browser atau menampilkan tombol—apa pun yang memungkinkan pengguna membuka tautan di perangkat.
4. Azure menghosting sistem perekaman. Saat tautan terbuka, halaman yang dioperasikan Azure memandu pengguna melalui urutan pemeriksaan keaktivaan menggunakan klien web Liveness terbaru.
5. Dapatkan panggilan balik hasil akhir. Segera setelah pemeriksaan selesai—atau jika pengguna meninggalkan atau kehabisan waktu—layanan tautan cepat memberi tahu titik akhir panggilan balik Anda sehingga aplikasi Anda dapat memutuskan apa yang terjadi selanjutnya.

Pemrosesan URL tautan langsung

URL yang dikembalikan oleh layanan tautan cepat adalah rahasia pembawa: siapa pun yang memiliki tautan dapat memulai, menyelesaikan, atau membatalkan sesi liveness terkait. Jika pihak berbahaya mencegat tautan sebelum pengguna yang dimaksudkan membukanya, mereka dapat mengonsumsi atau memalsukan sesi dan menghalangi pengguna sah untuk menyelesaikan pemeriksaan—menciptakan risiko kesalahan dan peniruan. Untuk meminimalkan risiko ini, kirimkan tautan hanya melalui saluran yang dilindungi, hindari mempertahankannya di log atau analitik, dan, jika memungkinkan, menurunkan masa pakai sesi keaktifan.