احراز هویت تصویری

افزونه احراز هویت تصویری شامل چندین عملکرد است که امکان مدیریت و استفاده از قابلیت‌های eKYC را فراهم می‌کند. این عملکردها به شرح زیر هستند:

1. ekyc/generateToken

این عملکرد برای تولید توکن احراز هویت تصویری استفاده می‌شود. این متد باید فراخوانی شود تا عملیات احراز هویت شروع شود. این عملکرد نیاز به 3 یا 4 پارامتر دارد: آدرس بازگشتی، دامنه، شماره سریال کارت و (اختیاری) اطلاعات اضافی.

فراخوانی در اسکریپت با استفاده از Appsan.runAction():

Appsan.runAction("ekyc/generateToken('SCOPE', 'CARD_SERIAL_NO')");

فراخوانی در XML:

<Button onclick="ekyc/generateToken('SCOPE', 'CARD_SERIAL_NO')" />

در ورودی scope می توانید از مقدار 0300000 استفاده نمایید و ورودی دوم سریال پشت کارت ملی می باشد.

2. ekyc/getTokenData

این عملکرد اطلاعات مرتبط با توکن تولید شده را برمی‌گرداند و برای دریافت داده‌های احراز هویتی استفاده می‌شود. این متد به سه پارامتر نیاز دارد: نام اپلیکیشن، نوع داده احراز هویت، و نوع استعلام.

فراخوانی در اسکریپت با استفاده از Appsan.runAction():

Appsan.runAction("ekyc/getTokenData('authenticationType', 'inquiryType')");

فراخوانی در XML:

<Button onclick="ekyc/getTokenData('authenticationType', 'inquiryType')" />

ورودی اول نوع پاسخ را مشخص میکند و یکی از مقادیر زیر به صورت عدد داخل string می باشد.

public enum AuthenticationData {

 @SerializedName("1")

 AUTHENTICATION_RESULT((byte) 1),

 @SerializedName("2")

 SELFIE_PICTURE((byte) 2),

 @SerializedName("3")

 VIDEO((byte) 3),

 @SerializedName("4")

 SPEECH((byte) 4),

 @SerializedName("5")

 SIGNATURE((byte) 5);

}

ورودی دوم نوع داده را مخص می کند

enum InquiryType {

 GET_TOKEN_DATA = 0;

 GET_CITIZEN_TOKENS_BY_NATIONAL_ID = 1;

 GET_CITIZEN_LAST_AUTHENTICATED_DATA = 2;

// REFRESH_AND_GET_TOKEN_DATA = 3;

}

این نمونه‌ها نشان می‌دهند که چگونه می‌توانید هر یک از عملکردهای افزونه "احراز هویت تصویری" را با استفاده از دو روش Appsan.runAction() و فراخوانی مستقیم در XML فراخوانی کنید.

نمونه کد تست

<page title="احراز هویت تصویری" scrollable="false">

 <button text="Generate Token" onclick="ekyc/generateToken('SCOPE', '123456')" />

 <button text="Get Token Data" onclick="ekyc/getTokenData('1','GET_TOKEN_DATA')->script/s:result2($data)" />

 <script id="s1">

 function res(data) {

 console.log(data);

 }

 function result2(res) {

 console.log(res);

 }

 </script>

</page>

برای اطلاع از ورودی و خروجی دقیق متد ها به مستندات ekyc اصلی مراجعه شود.