Öğretici: Yüzlerdeki canlılığı algılama

Makale
09/25/2024

Yüz Canlılığı algılama, giriş video akışındaki bir yüzün gerçek mi (canlı) yoksa sahte mi (sahte) olduğunu belirlemek için kullanılır. Bu, bir fotoğraf, video, maske veya başka bir kişinin kimliğine bürünmek için başka bir araç kullanarak sahtekarların sisteme erişim kazanmasını önlemek için biyometrik kimlik doğrulama sistemindeki önemli bir yapı taşıdır.

Canlılık algılamanın amacı, sistemin kimlik doğrulaması sırasında fiziksel olarak mevcut ve canlı bir kişiyle etkileşimde bulunduğundan emin olmaktır. Dijital finans, uzaktan erişim denetimi ve çevrimiçi kimlik doğrulama süreçlerinin artmasıyla birlikte bu sistemler giderek daha da öneme sahiptir.

Azure AI Yüz Tanıma canlılığı algılama çözümü, kağıt çıktılar, 2B/3B maskeler ve telefon ve dizüstü bilgisayarlardaki sahte sunulardan oluşan çeşitli kimlik sahtekarlığı türlerine karşı başarıyla savunma sağlar. Canlılık algılama, giderek daha karmaşık hale gelen kimlik sahtekarlığı saldırılarına karşı sürekli iyileştirmeler yapılan aktif bir araştırma alanıdır. Genel çözüm yeni saldırı türlerine karşı daha sağlam hale geldikçe istemciye ve hizmet bileşenlerine zaman içinde sürekli iyileştirmeler sunulur.

Önemli

Canlılık için Yüz Tanıma istemcisi SDK'ları geçitli bir özelliktir. Yüz Tanıma giriş formunu doldurarak canlılık özelliğine erişim istemeniz gerekir. Azure aboneliğinize erişim verildiğinde Yüz Tanıma canlılığı SDK'sını indirebilirsiniz.

Giriş

Canlılık çözümü tümleştirmesi iki ayrı bileşenden oluşur: ön uç mobil/web uygulaması ve uygulama sunucusu/düzenleyici.

Ön uç uygulaması: Ön uç uygulaması, canlılık algılamayı başlatmak için uygulama sunucusundan yetkilendirme alır. Birincil amacı, canlılık algılama işlemi boyunca kamerayı etkinleştirmek ve son kullanıcılara doğru yol göstermektir.
Uygulama sunucusu: Uygulama sunucusu, canlılık algılama oturumları oluşturmak ve belirli bir oturum için Yüz Tanıma hizmetinden yetkilendirme belirteci almak için bir arka uç sunucusu görevi görür. Bu belirteç, ön uç uygulamasına canlılık algılaması gerçekleştirme yetkisi sağlar. Uygulama sunucusunun hedefleri oturumları yönetmek, ön uç uygulaması için yetkilendirme vermek ve canlılık algılama işleminin sonuçlarını görüntülemektir.

Ayrıca, kişinin belirttiğiniz belirli bir kişi olup olmadığını doğrulamak için yüz doğrulamayı canlılık algılama ile birleştiririz. Aşağıdaki tabloda canlılık algılama özelliklerinin ayrıntıları açıklanmaktadır:

Özellik	Açıklama
Canlılık algılama	Bir girişin gerçek veya sahte olduğunu belirleyin ve yalnızca uygulama sunucusunun canlılık denetimini başlatma ve sonucu sorgulama yetkisi vardır.
Yüz doğrulama ile canlılık algılama	Bir girişin gerçek veya sahte olduğunu belirleyin ve sağladığınız bir başvuru görüntüsüne göre kişinin kimliğini doğrulayın. Uygulama sunucusu veya ön uç uygulaması bir başvuru görüntüsü sağlayabilir. Yalnızca uygulama sunucusu canlılık denetimini başlatma ve sonucu sorgulama yetkisine sahiptir.

Bu öğreticide, çeşitli dil SDK'larında yüz doğrulama ile canlılık algılama ve canlılık algılama gerçekleştirmek için bir ön uç uygulamasının ve uygulama sunucusunun nasıl çalıştırıldığı gösterilmektedir.

Önkoşullar

Azure aboneliği - Ücretsiz olarak oluşturun
Sorumlu yapay zeka koşullarını kabul edebilmeniz ve bir kaynak oluşturabilmeniz için Azure hesabınızın atanmış bir Bilişsel Hizmetler Katkıda Bulunanı rolü olması gerekir. Bu rolün hesabınıza atanmasını sağlamak için Rol atama belgelerindeki adımları izleyin veya yöneticinize başvurun.
Azure aboneliğinizi aldıktan sonra anahtarınızı ve uç noktanızı almak için Azure portalında bir Yüz Tanıma kaynağı oluşturun. Dağıtıldıktan sonra Kaynağa git'i seçin.
- Uygulamanızı Yüz Tanıma hizmetine bağlamak için oluşturduğunuz kaynaktan anahtara ve uç noktaya ihtiyacınız vardır.
- Hizmeti denemek ve daha sonra üretim için ücretli bir katmana yükseltmek için ücretsiz fiyatlandırma katmanını (F0) kullanabilirsiniz.
Mobil cihazlar (IOS ve Android) ve web için Azure AI Vision Yüz Tanıma İstemci SDK'sına erişim. Başlamak için SDK'ya erişim elde etmek için Yüz Tanıma Sınırlı Erişim özelliklerine başvurmanız gerekir. Daha fazla bilgi için Yüz Tanıma Sınırlı Erişim sayfasına bakın.

Canlılık algılaması gerçekleştirmek için ön uç uygulamaları ve uygulama sunucularını ayarlama

Ön uç uygulamaları ve uygulama sunucuları için farklı dillerde SDK'lar sağlıyoruz. Ön uç uygulamalarınızı ve uygulama sunucularınızı ayarlamak için aşağıdaki yönergelere bakın.

Ön uç uygulaması için SDK'sını indirme

SDK'ya erişiminiz olduğunda, kullanıcı arabirimini ve kodu yerel mobil uygulamanızla tümleştirmek için azure-ai-vision-sdk GitHub deposundaki yönergeleri izleyin. Canlılık SDK'sı, Android mobil uygulamaları için Java/Kotlin, iOS mobil uygulamaları için Swift ve web uygulamaları için JavaScript'i destekler:

Swift iOS için iOS örneğindeki yönergeleri izleyin
Kotlin/Java Android için Android örneğindeki yönergeleri izleyin
JavaScript Web için Web örneğindeki yönergeleri izleyin

Kodu uygulamanıza ekledikten sonra SDK kamerayı başlatır ve son kullanıcıya konumunu ayarlama, canlılık yükünü oluşturma ve canlılık yükünü işlemek için Azure AI Yüz Tanıma bulut hizmetini çağırma konusunda yol gösterir.

Uygulama sunucusu için Azure AI Yüz Tanıma istemci kitaplığını indirme

Uygulama sunucusu/düzenleyici, canlılık oturumunun yaşam döngüsünü denetlemekle sorumludur. Uygulama sunucusunun canlılık algılaması gerçekleştirmeden önce bir oturum oluşturması gerekir ve ardından canlılık denetimi tamamlandığında sonucu sorgulayabilir ve oturumu silebilir. Uygulama sunucunuzu kolayca uygulamak için çeşitli dillerde bir kitaplık sunuyoruz. İstediğiniz paketi yüklemek için şu adımları izleyin:

C# için dotnet benioku başlığındaki yönergeleri izleyin
Java için Java benioku dosyasındaki yönergeleri izleyin
Python için Python benioku dosyasındaki yönergeleri izleyin
JavaScript için JavaScript benioku dosyasındaki yönergeleri izleyin

Ortam değişkenlerini oluşturma

Bu örnekte, kimlik bilgilerinizi uygulamayı çalıştıran yerel makinedeki ortam değişkenlerine yazın.

Azure portalına gidin. Önkoşullar bölümünde oluşturduğunuz kaynak başarıyla dağıtıldıysa, Sonraki Adımlar'ın altında Kaynağa git'i seçin. Anahtarınızı ve uç noktanızı Anahtarlar ve Uç Nokta sayfasındaki Kaynak Yönetimi'nin altında bulabilirsiniz. Kaynak anahtarınız Azure abonelik kimliğiniz ile aynı değildir.

Anahtarınızın ve uç noktanızın ortam değişkenini ayarlamak için bir konsol penceresi açın ve işletim sisteminiz ve geliştirme ortamınıza yönelik yönergeleri izleyin.

Ortam değişkenini FACE_APIKEY ayarlamak için değerini kaynağınızın anahtarlarından biriyle değiştirin <your_key> .
Ortam değişkenini FACE_ENDPOINT ayarlamak için değerini kaynağınızın uç noktasıyla değiştirin <your_endpoint> .

Önemli

API anahtarı kullanıyorsanız, bunu Azure Key Vault gibi başka bir yerde güvenli bir şekilde depolayın. API anahtarını doğrudan kodunuzla eklemeyin ve hiçbir zaman herkese açık olarak göndermeyin.

Yapay zeka hizmetleri güvenliği hakkında daha fazla bilgi için bkz . Azure AI hizmetlerine yönelik isteklerin kimliğini doğrulama.

Windows
Linux

setx FACE_APIKEY <your_key>

setx FACE_ENDPOINT <your_endpoint>

Ortam değişkenlerini ekledikten sonra, konsol penceresi de dahil olmak üzere ortam değişkenlerini okuyacak tüm çalışan programları yeniden başlatmanız gerekebilir.

export FACE_APIKEY=<your_key>

export FACE_ENDPOINT=<your_endpoint>

Ortam değişkenlerini ekledikten sonra, değişiklikleri etkili hale getirmek için konsol pencerenizden komutunu çalıştırın source ~/.bashrc .

Canlılık algılama gerçekleştirme

Canlılık düzenlemesinde yer alan üst düzey adımlar aşağıda gösterilmiştir:

Ön uç uygulaması canlılık denetimini başlatır ve uygulama sunucusuna bildirir.

Uygulama sunucusu, Azure AI Yüz Tanıma Hizmeti ile yeni bir canlılık oturumu oluşturur. Hizmet bir canlılık oturumu oluşturur ve bir session-authorization-token ile yanıt verir. Canlılık Oturumu Oluşturma İşlemi'nde canlılık oturumu oluştururken kullanılan her istek parametresiyle ilgili daha fazla bilgi sağlanır.

var endpoint = new Uri(System.Environment.GetEnvironmentVariable("FACE_ENDPOINT"));
var credential = new AzureKeyCredential(System.Environment.GetEnvironmentVariable("FACE_APIKEY"));

var sessionClient = new FaceSessionClient(endpoint, credential);

var createContent = new CreateLivenessSessionContent(LivenessOperationMode.Passive)
{
    DeviceCorrelationId = "723d6d03-ef33-40a8-9682-23a1feb7bccd",
    SendResultsToClient = false,
};

var createResponse = await sessionClient.CreateLivenessSessionAsync(createContent);
var sessionId = createResponse.Value.SessionId;
Console.WriteLine($"Session created.");
Console.WriteLine($"Session id: {sessionId}");
Console.WriteLine($"Auth token: {createResponse.Value.AuthToken}");

String endpoint = System.getenv("FACE_ENDPOINT");
String accountKey = System.getenv("FACE_APIKEY");

FaceSessionClient sessionClient = new FaceSessionClientBuilder()
    .endpoint(endpoint)
    .credential(new AzureKeyCredential(accountKey))
    .buildClient();

CreateLivenessSessionContent parameters = new CreateLivenessSessionContent(LivenessOperationMode.PASSIVE)
    .setDeviceCorrelationId("723d6d03-ef33-40a8-9682-23a1feb7bccd")
    .setSendResultsToClient(false);

CreateLivenessSessionResult creationResult = sessionClient.createLivenessSession(parameters);
System.out.println("Session created.");
System.out.println("Session id: " + creationResult.getSessionId());
System.out.println("Auth token: " + creationResult.getAuthToken());

endpoint = os.environ["FACE_ENDPOINT"]
key = os.environ["FACE_APIKEY"]

face_session_client = FaceSessionClient(endpoint=endpoint, credential=AzureKeyCredential(key))

created_session = await face_session_client.create_liveness_session(
    CreateLivenessSessionContent(
        liveness_operation_mode=LivenessOperationMode.PASSIVE,
        device_correlation_id="723d6d03-ef33-40a8-9682-23a1feb7bccd",
        send_results_to_client=False,
    )
)
print("Session created.")
print(f"Session id: {created_session.session_id}")
print(f"Auth token: {created_session.auth_token}")

const endpoint = process.env['FACE_ENDPOINT'];
const apikey = process.env['FACE_APIKEY'];

const credential = new AzureKeyCredential(apikey);
const client = createFaceClient(endpoint, credential);

const createLivenessSessionResponse = await client.path('/detectLiveness/singleModal/sessions').post({
    body: {
        livenessOperationMode: 'Passive',
        deviceCorrelationId: '723d6d03-ef33-40a8-9682-23a1feb7bccd',
        sendResultsToClient: false,
    },
});

if (isUnexpected(createLivenessSessionResponse)) {
    throw new Error(createLivenessSessionResponse.body.error.message);
}

console.log('Session created.');
console.log(`Session ID: ${createLivenessSessionResponse.body.sessionId}`);
console.log(`Auth token: ${createLivenessSessionResponse.body.authToken}`);

curl --request POST --location "%FACE_ENDPOINT%/face/v1.1-preview.1/detectliveness/singlemodal/sessions" ^
--header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%" ^
--header "Content-Type: application/json" ^
--data ^
"{ ^
    ""livenessOperationMode"": ""passive"", ^
    ""deviceCorrelationId"": ""723d6d03-ef33-40a8-9682-23a1feb7bccd"", ^
    ""sendResultsToClient"": ""false"" ^
}"

curl --request POST --location "${FACE_ENDPOINT}/face/v1.1-preview.1/detectliveness/singlemodal/sessions" \
--header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}" \
--header "Content-Type: application/json" \
--data \
'{
    "livenessOperationMode": "passive",
    "deviceCorrelationId": "723d6d03-ef33-40a8-9682-23a1feb7bccd",
    "sendResultsToClient": "false"
}'

Yanıt gövdesi örneği:

{
    "sessionId": "a6e7193e-b638-42e9-903f-eaf60d2b40a5",
    "authToken": "<session-authorization-token>"
}

Uygulama sunucusu, oturum yetkilendirme belirtecini ön uç uygulamasına geri sağlar.

Ön uç uygulaması, Azure AI Vision SDK'sının başlatılması sırasında oturum yetkilendirme belirtecini sağlar.

mServiceOptions?.setTokenCredential(com.azure.android.core.credential.TokenCredential { _, callback ->
    callback.onSuccess(com.azure.android.core.credential.AccessToken("<INSERT_TOKEN_HERE>", org.threeten.bp.OffsetDateTime.MAX))
})

serviceOptions?.authorizationToken = "<INSERT_TOKEN_HERE>"

azureAIVisionFaceAnalyzer.token = "<INSERT_TOKEN_HERE>"

SDK daha sonra kamerayı başlatır, kullanıcıya doğru konumlandırması için yol gösterir ve ardından yükü canlılık algılama hizmet uç noktasını çağırmak için hazırlar.
SDK, canlılık algılamasını gerçekleştirmek için Azure AI Vision Yüz Tanıma hizmetini çağırır. Hizmet yanıt verdikten sonra SDK, ön uç uygulamasına canlılık denetiminin tamamlandığını bildirir.
Ön uç uygulaması, canlılık denetimi tamamlama işlemini uygulama sunucusuna aktarır.

Uygulama sunucusu artık Azure AI Vision Yüz Tanıma hizmetinden canlılık algılama sonucunu sorgulayabilir.

var getResultResponse = await sessionClient.GetLivenessSessionResultAsync(sessionId);

var sessionResult = getResultResponse.Value;
Console.WriteLine($"Session id: {sessionResult.Id}");
Console.WriteLine($"Session status: {sessionResult.Status}");
Console.WriteLine($"Liveness detection request id: {sessionResult.Result?.RequestId}");
Console.WriteLine($"Liveness detection received datetime: {sessionResult.Result?.ReceivedDateTime}");
Console.WriteLine($"Liveness detection decision: {sessionResult.Result?.Response.Body.LivenessDecision}");
Console.WriteLine($"Session created datetime: {sessionResult.CreatedDateTime}");
Console.WriteLine($"Auth token TTL (seconds): {sessionResult.AuthTokenTimeToLiveInSeconds}");
Console.WriteLine($"Session expired: {sessionResult.SessionExpired}");
Console.WriteLine($"Device correlation id: {sessionResult.DeviceCorrelationId}");

LivenessSession sessionResult = sessionClient.getLivenessSessionResult(creationResult.getSessionId());
System.out.println("Session id: " + sessionResult.getId());
System.out.println("Session status: " + sessionResult.getStatus());
System.out.println("Liveness detection request id: " + sessionResult.getResult().getRequestId());
System.out.println("Liveness detection received datetime: " + sessionResult.getResult().getReceivedDateTime());
System.out.println("Liveness detection decision: " + sessionResult.getResult().getResponse().getBody().getLivenessDecision());
System.out.println("Session created datetime: " + sessionResult.getCreatedDateTime());
System.out.println("Auth token TTL (seconds): " + sessionResult.getAuthTokenTimeToLiveInSeconds());
System.out.println("Session expired: " + sessionResult.isSessionExpired());
System.out.println("Device correlation id: " + sessionResult.getDeviceCorrelationId());

liveness_result = await face_session_client.get_liveness_session_result(
    created_session.session_id
)
print(f"Session id: {liveness_result.id}")
print(f"Session status: {liveness_result.status}")
print(f"Liveness detection request id: {liveness_result.result.request_id}")
print(f"Liveness detection received datetime: {liveness_result.result.received_date_time}")
print(f"Liveness detection decision: {liveness_result.result.response.body.liveness_decision}")
print(f"Session created datetime: {liveness_result.created_date_time}")
print(f"Auth token TTL (seconds): {liveness_result.auth_token_time_to_live_in_seconds}")
print(f"Session expired: {liveness_result.session_expired}")
print(f"Device correlation id: {liveness_result.device_correlation_id}")

const getLivenessSessionResultResponse = await client.path('/detectLiveness/singleModal/sessions/{sessionId}', createLivenessSessionResponse.body.sessionId).get();

if (isUnexpected(getLivenessSessionResultResponse)) {
    throw new Error(getLivenessSessionResultResponse.body.error.message);
}

console.log(`Session id: ${getLivenessSessionResultResponse.body.id}`);
console.log(`Session status: ${getLivenessSessionResultResponse.body.status}`);
console.log(`Liveness detection request id: ${getLivenessSessionResultResponse.body.result?.requestId}`);
console.log(`Liveness detection received datetime: ${getLivenessSessionResultResponse.body.result?.receivedDateTime}`);
console.log(`Liveness detection decision: ${getLivenessSessionResultResponse.body.result?.response.body.livenessDecision}`);
console.log(`Session created datetime: ${getLivenessSessionResultResponse.body.createdDateTime}`);
console.log(`Auth token TTL (seconds): ${getLivenessSessionResultResponse.body.authTokenTimeToLiveInSeconds}`);
console.log(`Session expired: ${getLivenessSessionResultResponse.body.sessionExpired}`);
console.log(`Device correlation id: ${getLivenessSessionResultResponse.body.deviceCorrelationId}`);

curl --request GET --location "%FACE_ENDPOINT%/face/v1.1-preview.1/detectliveness/singlemodal/sessions/<session-id>" ^
--header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%"

curl --request GET --location "${FACE_ENDPOINT}/face/v1.1-preview.1/detectliveness/singlemodal/sessions/<session-id>" \
--header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}"

Yanıt gövdesi örneği:

{
    "status": "ResultAvailable",
    "result": {
        "id": 1,
        "sessionId": "a3dc62a3-49d5-45a1-886c-36e7df97499a",
        "requestId": "cb2b47dc-b2dd-49e8-bdf9-9b854c7ba843",
        "receivedDateTime": "2023-10-31T16:50:15.6311565+00:00",
        "request": {
            "url": "/face/v1.1-preview.1/detectliveness/singlemodal",
            "method": "POST",
            "contentLength": 352568,
            "contentType": "multipart/form-data; boundary=--------------------------482763481579020783621915",
            "userAgent": ""
        },
        "response": {
            "body": {
                "livenessDecision": "realface",
                "target": {
                    "faceRectangle": {
                        "top": 59,
                        "left": 121,
                        "width": 409,
                        "height": 395
                    },
                    "fileName": "content.bin",
                    "timeOffsetWithinFile": 0,
                    "imageType": "Color"
                },
                "modelVersionUsed": "2022-10-15-preview.04"
            },
            "statusCode": 200,
            "latencyInMilliseconds": 1098
        },
        "digest": "537F5CFCD8D0A7C7C909C1E0F0906BF27375C8E1B5B58A6914991C101E0B6BFC"
    },
    "id": "a3dc62a3-49d5-45a1-886c-36e7df97499a",
    "createdDateTime": "2023-10-31T16:49:33.6534925+00:00",
    "authTokenTimeToLiveInSeconds": 600,
    "deviceCorrelationId": "723d6d03-ef33-40a8-9682-23a1feb7bccd",
    "sessionExpired": false
}

Artık sonucunu sorgulamazsanız uygulama sunucusu oturumu silebilir.

await sessionClient.DeleteLivenessSessionAsync(sessionId);
Console.WriteLine($"The session {sessionId} is deleted.");

sessionClient.deleteLivenessSession(creationResult.getSessionId());
System.out.println("The session " + creationResult.getSessionId() + " is deleted.");

await face_session_client.delete_liveness_session(
    created_session.session_id
)
print(f"The session {created_session.session_id} is deleted.")
await face_session_client.close()

const deleteLivenessSessionResponse = await client.path('/detectLiveness/singleModal/sessions/{sessionId}', createLivenessSessionResponse.body.sessionId).delete();
if (isUnexpected(deleteLivenessSessionResponse)) {
    throw new Error(deleteLivenessSessionResponse.body.error.message);
}
console.log(`The session ${createLivenessSessionResponse.body.sessionId} is deleted.`);

curl --request DELETE --location "%FACE_ENDPOINT%/face/v1.1-preview.1/detectliveness/singlemodal/sessions/<session-id>" ^
--header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%"

curl --request DELETE --location "${FACE_ENDPOINT}/face/v1.1-preview.1/detectliveness/singlemodal/sessions/<session-id>" \
--header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}"

Yüz doğrulama ile canlılık algılama gerçekleştirme

Yüz doğrulamayı canlılık algılama ile birleştirmek, ilgili kişinin sistemde fiziksel olarak bulunduğuna ilişkin ek bir garanti ile biyometrik doğrulamayı sağlar. Canlılığı doğrulamayla tümleştirmenin iki bölümü vardır:

İyi bir başvuru görüntüsü seçin.
Doğrulama ile canlılık düzenlemesini ayarlayın.

Başvuru görüntüsü seçme

Giriş görüntülerinizin en doğru tanıma sonuçlarını vermesini sağlamak için aşağıdaki ipuçlarını kullanın.

Teknik gereksinimler

Desteklenen giriş görüntüsü biçimleri JPEG, PNG, GIF (ilk kare), BMP'dir.
Görüntü dosyası boyutu 6 MB'tan büyük olmamalıdır.

Geçerli algılama modellerini kullanırken yüz algılama işleminde özniteliğini, görüntünün yüz tanımayı deneyecek kadar kaliteli olup olmadığının genel bir yönergesi olarak kullanabilirsinizqualityForRecognition. Kişi kaydı için yalnızca "high" kaliteli görüntüler önerilir ve tanımlama senaryolarında veya üzerinde "medium" kalite önerilir.

Oluşturma gereksinimleri

Fotoğraf net ve keskindir, bulanık değildir, pikselleştirilmiş, bozuk veya hasarlı değildir.
Fotoğraf, yüz lekelerini veya yüz görünümünü kaldırmak için değiştirilmez.
Fotoğraf RGB rengi desteklenen bir biçimde olmalıdır (JPEG, PNG, WEBP, BMP). Önerilen Yüz Tanıma boyutu 200 piksel x 200 pikseldir. 200 piksel x 200 pikselden büyük yüz boyutları daha iyi yapay zeka kalitesine ve 6 MB'tan büyük boyuta neden olmaz.
Kullanıcı gözlük, maske, şapka, kulaklık, baş kaplama veya yüz kaplaması takmıyor. Yüz, herhangi bir engelden arınmalıdır.
Yüzünüzü gizlememeleri şartıyla yüz takılarına izin verilir.
Fotoğrafta yalnızca bir yüz görünür olmalıdır.
Yüz, her iki gözü açık, ağzı kapalı, aşırı yüz ifadeleri veya baş eğme olmadan nötr ön görünümde olmalıdır.
Yüz, gölgelerden veya kırmızı gözlerden arınmalıdır. Bunlardan herhangi biri gerçekleşirse fotoğrafı yeniden çekin.
Arka plan, herhangi bir gölge olmadan tekdüzen ve düz olmalıdır.
Yüz resmin içinde ortalanmalı ve resmin en az %50'sini doldurmalıdır.

Doğrulama ile canlılık düzenlemesini ayarlayın.

Doğrulama düzenlemesi ile canlılık konusunda üst düzey adımlar aşağıda gösterilmiştir:

Doğrulama başvuru görüntüsünü aşağıdaki iki yöntemden biriyle sağlama:

Uygulama sunucusu canlılık oturumu oluştururken başvuru görüntüsünü sağlar. Doğrulama ile canlılık oturumu oluştururken kullanılan her istek parametresiyle ilgili daha fazla bilgiye Oturum Oluşturma işlemini doğrulama ile canlılık bölümünden başvurulur.

var endpoint = new Uri(System.Environment.GetEnvironmentVariable("FACE_ENDPOINT"));
var credential = new AzureKeyCredential(System.Environment.GetEnvironmentVariable("FACE_APIKEY"));

var sessionClient = new FaceSessionClient(endpoint, credential);

var createContent = new CreateLivenessWithVerifySessionContent(LivenessOperationMode.Passive)
{
    DeviceCorrelationId = "723d6d03-ef33-40a8-9682-23a1feb7bccd"
};
using var fileStream = new FileStream("test.png", FileMode.Open, FileAccess.Read);

var createResponse = await sessionClient.CreateLivenessWithVerifySessionAsync(createContent, fileStream);

var sessionId = createResponse.Value.SessionId;
Console.WriteLine("Session created.");
Console.WriteLine($"Session id: {sessionId}");
Console.WriteLine($"Auth token: {createResponse.Value.AuthToken}");
Console.WriteLine("The reference image:");
Console.WriteLine($"  Face rectangle: {createResponse.Value.VerifyImage.FaceRectangle.Top}, {createResponse.Value.VerifyImage.FaceRectangle.Left}, {createResponse.Value.VerifyImage.FaceRectangle.Width}, {createResponse.Value.VerifyImage.FaceRectangle.Height}");
Console.WriteLine($"  The quality for recognition: {createResponse.Value.VerifyImage.QualityForRecognition}");

String endpoint = System.getenv("FACE_ENDPOINT");
String accountKey = System.getenv("FACE_APIKEY");

FaceSessionClient sessionClient = new FaceSessionClientBuilder()
    .endpoint(endpoint)
    .credential(new AzureKeyCredential(accountKey))
    .buildClient();

CreateLivenessWithVerifySessionContent parameters = new CreateLivenessWithVerifySessionContent(LivenessOperationMode.PASSIVE)
    .setDeviceCorrelationId("723d6d03-ef33-40a8-9682-23a1feb7bccd")
    .setSendResultsToClient(false);

Path path = Paths.get("test.png");
BinaryData data = BinaryData.fromFile(path);
CreateLivenessWithVerifySessionResult creationResult = sessionClient.createLivenessWithVerifySession(parameters, data);

System.out.println("Session created.");
System.out.println("Session id: " + creationResult.getSessionId());
System.out.println("Auth token: " + creationResult.getAuthToken());
System.out.println("The reference image:");
System.out.println("  Face rectangle: " + creationResult.getVerifyImage().getFaceRectangle().getTop() + " " + creationResult.getVerifyImage().getFaceRectangle().getLeft() + " " + creationResult.getVerifyImage().getFaceRectangle().getWidth() + " " + creationResult.getVerifyImage().getFaceRectangle().getHeight());
System.out.println("  The quality for recognition: " + creationResult.getVerifyImage().getQualityForRecognition());

endpoint = os.environ["FACE_ENDPOINT"]
key = os.environ["FACE_APIKEY"]

face_session_client = FaceSessionClient(endpoint=endpoint, credential=AzureKeyCredential(key))

reference_image_path = "test.png"
with open(reference_image_path, "rb") as fd:
    reference_image_content = fd.read()

created_session = await face_session_client.create_liveness_with_verify_session(
    CreateLivenessWithVerifySessionContent(
        liveness_operation_mode=LivenessOperationMode.PASSIVE,
        device_correlation_id="723d6d03-ef33-40a8-9682-23a1feb7bccd",
    ),
    verify_image=reference_image_content,
)
print("Session created.")
print(f"Session id: {created_session.session_id}")
print(f"Auth token: {created_session.auth_token}")
print("The reference image:")
print(f"  Face rectangle: {created_session.verify_image.face_rectangle}")
print(f"  The quality for recognition: {created_session.verify_image.quality_for_recognition}")

const endpoint = process.env['FACE_ENDPOINT'];
const apikey = process.env['FACE_APIKEY'];

const credential = new AzureKeyCredential(apikey);
const client = createFaceClient(endpoint, credential);

const createLivenessSessionResponse = await client.path('/detectLivenessWithVerify/singleModal/sessions').post({
    contentType: 'multipart/form-data',
    body: [
        {
            name: 'VerifyImage',
            // Note that this utilizes Node.js API.
            // In browser environment, please use file input or drag and drop to read files.
            body: readFileSync('test.png'),
        },
        {
            name: 'Parameters',
            body: {
                livenessOperationMode: 'Passive',
                deviceCorrelationId: '723d6d03-ef33-40a8-9682-23a1feb7bccd',
            },
        },
    ],
});

if (isUnexpected(createLivenessSessionResponse)) {
    throw new Error(createLivenessSessionResponse.body.error.message);
}

console.log('Session created:');
console.log(`Session ID: ${createLivenessSessionResponse.body.sessionId}`);
console.log(`Auth token: ${createLivenessSessionResponse.body.authToken}`);
console.log('The reference image:');
console.log(`  Face rectangle: ${createLivenessSessionResponse.body.verifyImage.faceRectangle}`);
console.log(`  The quality for recognition: ${createLivenessSessionResponse.body.verifyImage.qualityForRecognition}`)

curl --request POST --location "%FACE_ENDPOINT%/face/v1.1-preview.1/detectlivenesswithverify/singlemodal/sessions" ^
--header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%" ^
--form "Parameters=""{\\\""livenessOperationMode\\\"": \\\""passive\\\"", \\\""deviceCorrelationId\\\"": \\\""723d6d03-ef33-40a8-9682-23a1feb7bccd\\\""}""" ^
--form "VerifyImage=@""test.png"""

curl --request POST --location "${FACE_ENDPOINT}/face/v1.1-preview.1/detectlivenesswithverify/singlemodal/sessions" \
--header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}" \
--form 'Parameters="{
    \"livenessOperationMode\": \"passive\",
    \"deviceCorrelationId\": \"723d6d03-ef33-40a8-9682-23a1feb7bccd\"
}"' \
--form 'VerifyImage=@"test.png"'

Yanıt gövdesi örneği:

{
    "verifyImage": {
        "faceRectangle": {
            "top": 506,
            "left": 51,
            "width": 680,
            "height": 475
        },
        "qualityForRecognition": "high"
    },
    "sessionId": "3847ffd3-4657-4e6c-870c-8e20de52f567",
    "authToken": "<session-authorization-token>"
}

Ön uç uygulaması, SDK'yi başlatırken başvuru görüntüsünü sağlar. Bu senaryo web çözümünde desteklenmez.

val singleFaceImageSource = VisionSource.fromFile("/path/to/image.jpg")
mFaceAnalysisOptions?.setRecognitionMode(RecognitionMode.valueOfVerifyingMatchToFaceInSingleFaceImage(singleFaceImageSource))

if let path = Bundle.main.path(forResource: "<IMAGE_RESOURCE_NAME>", ofType: "<IMAGE_RESOURCE_TYPE>"),
   let image = UIImage(contentsOfFile: path),
   let singleFaceImageSource = try? VisionSource(uiImage: image) {
   try methodOptions.setRecognitionMode(.verifyMatchToFaceIn(singleFaceImage: singleFaceImageSource))
}

Not supported.

Uygulama sunucusu artık canlılık sonucuna ek olarak doğrulama sonucunu sorgulayabilir.

var getResultResponse = await sessionClient.GetLivenessWithVerifySessionResultAsync(sessionId);
var sessionResult = getResultResponse.Value;
Console.WriteLine($"Session id: {sessionResult.Id}");
Console.WriteLine($"Session status: {sessionResult.Status}");
Console.WriteLine($"Liveness detection request id: {sessionResult.Result?.RequestId}");
Console.WriteLine($"Liveness detection received datetime: {sessionResult.Result?.ReceivedDateTime}");
Console.WriteLine($"Liveness detection decision: {sessionResult.Result?.Response.Body.LivenessDecision}");
Console.WriteLine($"Verification result: {sessionResult.Result?.Response.Body.VerifyResult.IsIdentical}");
Console.WriteLine($"Verification confidence: {sessionResult.Result?.Response.Body.VerifyResult.MatchConfidence}");
Console.WriteLine($"Session created datetime: {sessionResult.CreatedDateTime}");
Console.WriteLine($"Auth token TTL (seconds): {sessionResult.AuthTokenTimeToLiveInSeconds}");
Console.WriteLine($"Session expired: {sessionResult.SessionExpired}");
Console.WriteLine($"Device correlation id: {sessionResult.DeviceCorrelationId}");

LivenessWithVerifySession sessionResult = sessionClient.getLivenessWithVerifySessionResult(creationResult.getSessionId());
System.out.println("Session id: " + sessionResult.getId());
System.out.println("Session status: " + sessionResult.getStatus());
System.out.println("Liveness detection request id: " + sessionResult.getResult().getRequestId());
System.out.println("Liveness detection received datetime: " + sessionResult.getResult().getReceivedDateTime());
System.out.println("Liveness detection decision: " + sessionResult.getResult().getResponse().getBody().getLivenessDecision());
System.out.println("Verification result: " + sessionResult.getResult().getResponse().getBody().getVerifyResult().isIdentical());
System.out.println("Verification confidence: " + sessionResult.getResult().getResponse().getBody().getVerifyResult().getMatchConfidence());
System.out.println("Session created datetime: " + sessionResult.getCreatedDateTime());
System.out.println("Auth token TTL (seconds): " + sessionResult.getAuthTokenTimeToLiveInSeconds());
System.out.println("Session expired: " + sessionResult.isSessionExpired());
System.out.println("Device correlation id: " + sessionResult.getDeviceCorrelationId());

liveness_result = await face_session_client.get_liveness_with_verify_session_result(
    created_session.session_id
)
print(f"Session id: {liveness_result.id}")
print(f"Session status: {liveness_result.status}")
print(f"Liveness detection request id: {liveness_result.result.request_id}")
print(f"Liveness detection received datetime: {liveness_result.result.received_date_time}")
print(f"Liveness detection decision: {liveness_result.result.response.body.liveness_decision}")
print(f"Verification result: {liveness_result.result.response.body.verify_result.is_identical}")
print(f"Verification confidence: {liveness_result.result.response.body.verify_result.match_confidence}")
print(f"Session created datetime: {liveness_result.created_date_time}")
print(f"Auth token TTL (seconds): {liveness_result.auth_token_time_to_live_in_seconds}")
print(f"Session expired: {liveness_result.session_expired}")
print(f"Device correlation id: {liveness_result.device_correlation_id}")

const getLivenessSessionResultResponse = await client.path('/detectLivenessWithVerify/singleModal/sessions/{sessionId}', createLivenessSessionResponse.body.sessionId).get();
if (isUnexpected(getLivenessSessionResultResponse)) {
    throw new Error(getLivenessSessionResultResponse.body.error.message);
}

console.log(`Session id: ${getLivenessSessionResultResponse.body.id}`);
console.log(`Session status: ${getLivenessSessionResultResponse.body.status}`);
console.log(`Liveness detection request id: ${getLivenessSessionResultResponse.body.result?.requestId}`);
console.log(`Liveness detection received datetime: ${getLivenessSessionResultResponse.body.result?.receivedDateTime}`);
console.log(`Liveness detection decision: ${getLivenessSessionResultResponse.body.result?.response.body.livenessDecision}`);
console.log(`Verification result: ${getLivenessSessionResultResponse.body.result?.response.body.verifyResult.isIdentical}`);
console.log(`Verification confidence: ${getLivenessSessionResultResponse.body.result?.response.body.verifyResult.matchConfidence}`);
console.log(`Session created datetime: ${getLivenessSessionResultResponse.body.createdDateTime}`);
console.log(`Auth token TTL (seconds): ${getLivenessSessionResultResponse.body.authTokenTimeToLiveInSeconds}`);
console.log(`Session expired: ${getLivenessSessionResultResponse.body.sessionExpired}`);
console.log(`Device correlation id: ${getLivenessSessionResultResponse.body.deviceCorrelationId}`);

curl --request GET --location "%FACE_ENDPOINT%/face/v1.1-preview.1/detectlivenesswithverify/singlemodal/sessions/<session-id>" ^
--header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%"

curl --request GET --location "${FACE_ENDPOINT}/face/v1.1-preview.1/detectlivenesswithverify/singlemodal/sessions/<session-id>" \
--header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}"

Yanıt gövdesi örneği:

{
    "status": "ResultAvailable",
    "result": {
        "id": 1,
        "sessionId": "3847ffd3-4657-4e6c-870c-8e20de52f567",
        "requestId": "f71b855f-5bba-48f3-a441-5dbce35df291",
        "receivedDateTime": "2023-10-31T17:03:51.5859307+00:00",
        "request": {
            "url": "/face/v1.1-preview.1/detectlivenesswithverify/singlemodal",
            "method": "POST",
            "contentLength": 352568,
            "contentType": "multipart/form-data; boundary=--------------------------590588908656854647226496",
            "userAgent": ""
        },
        "response": {
            "body": {
                "livenessDecision": "realface",
                "target": {
                    "faceRectangle": {
                        "top": 59,
                        "left": 121,
                        "width": 409,
                        "height": 395
                    },
                    "fileName": "content.bin",
                    "timeOffsetWithinFile": 0,
                    "imageType": "Color"
                },
                "modelVersionUsed": "2022-10-15-preview.04",
                "verifyResult": {
                    "matchConfidence": 0.9304124,
                    "isIdentical": true
                }
            },
            "statusCode": 200,
            "latencyInMilliseconds": 1306
        },
        "digest": "2B39F2E0EFDFDBFB9B079908498A583545EBED38D8ACA800FF0B8E770799F3BF"
    },
    "id": "3847ffd3-4657-4e6c-870c-8e20de52f567",
    "createdDateTime": "2023-10-31T16:58:19.8942961+00:00",
    "authTokenTimeToLiveInSeconds": 600,
    "deviceCorrelationId": "723d6d03-ef33-40a8-9682-23a1feb7bccd",
    "sessionExpired": true
}

Artık sonucunu sorgulamazsanız uygulama sunucusu oturumu silebilir.

await sessionClient.DeleteLivenessWithVerifySessionAsync(sessionId);
Console.WriteLine($"The session {sessionId} is deleted.");

sessionClient.deleteLivenessWithVerifySession(creationResult.getSessionId());
System.out.println("The session " + creationResult.getSessionId() + " is deleted.");

await face_session_client.delete_liveness_with_verify_session(
    created_session.session_id
)
print(f"The session {created_session.session_id} is deleted.")
await face_session_client.close()

const deleteLivenessSessionResponse = await client.path('/detectLivenessWithVerify/singleModal/sessions/{sessionId}', createLivenessSessionResponse.body.sessionId).delete();
if (isUnexpected(deleteLivenessSessionResponse)) {
    throw new Error(deleteLivenessSessionResponse.body.error.message);
}
console.log(`The session ${createLivenessSessionResponse.body.sessionId} is deleted.`);

curl --request DELETE --location "%FACE_ENDPOINT%/face/v1.1-preview.1/detectlivenesswithverify/singlemodal/sessions/<session-id>" ^
--header "Ocp-Apim-Subscription-Key: %FACE_APIKEY%"

curl --request DELETE --location "${FACE_ENDPOINT}/face/v1.1-preview.1/detectlivenesswithverify/singlemodal/sessions/<session-id>" \
--header "Ocp-Apim-Subscription-Key: ${FACE_APIKEY}"

Kaynakları temizleme

Azure AI hizmetleri aboneliğini temizlemek ve kaldırmak istiyorsanız, kaynağı veya kaynak grubunu silebilirsiniz. Kaynak grubunun silinmesi, kaynak grubuyla ilişkili diğer tüm kaynakları da siler.

Canlılık API'lerindeki diğer seçenekler hakkında bilgi edinmek için bkz. Azure AI Vision SDK başvurusu.

Canlılık çözümünü düzenlemeye yönelik özellikler hakkında daha fazla bilgi edinmek için Oturum REST API başvurusuna bakın.

Canlılık Oturumu İşlemleri

Aracılığıyla paylaş

Öğretici: Yüzlerdeki canlılığı algılama

Giriş

Önkoşullar

Canlılık algılaması gerçekleştirmek için ön uç uygulamaları ve uygulama sunucularını ayarlama

Ön uç uygulaması için SDK'sını indirme

Uygulama sunucusu için Azure AI Yüz Tanıma istemci kitaplığını indirme

Ortam değişkenlerini oluşturma

Canlılık algılama gerçekleştirme

Yüz doğrulama ile canlılık algılama gerçekleştirme

Başvuru görüntüsü seçme

Teknik gereksinimler

Oluşturma gereksinimleri

Doğrulama ile canlılık düzenlemesini ayarlayın.

Kaynakları temizleme

Geri Bildirim

Ek kaynaklar

Aracılığıyla paylaş

Öğretici: Yüzlerdeki canlılığı algılama

Giriş

Önkoşullar

Canlılık algılaması gerçekleştirmek için ön uç uygulamaları ve uygulama sunucularını ayarlama

Ön uç uygulaması için SDK'sını indirme

Uygulama sunucusu için Azure AI Yüz Tanıma istemci kitaplığını indirme

Ortam değişkenlerini oluşturma

Canlılık algılama gerçekleştirme

Yüz doğrulama ile canlılık algılama gerçekleştirme

Başvuru görüntüsü seçme

Teknik gereksinimler

Oluşturma gereksinimleri

Doğrulama ile canlılık düzenlemesini ayarlayın.

Kaynakları temizleme

İlgili içerik

Geri Bildirim

Ek kaynaklar