پرش به محتوای اصلی
ShieldID

داشبورد

یک داشبورد احراز هویت برای کلیدها، میزان استفاده و نتایج.

میزان استفادهٔ این ماه را ببینید، کلیدهای API مربوط به sandbox و محیط زنده را مدیریت کنید، صورت‌حساب را بررسی کنید و همهٔ نتایج احراز هویت را دقیقاً همان‌گونه که تیم شما می‌بیند بخوانید. به انگلیسی یا فرانسوی.

  • کلیدهای sandbox و زنده، جدا از هم
  • هر نتیجه به‌صورت نتایج جداگانهٔ هر بررسی
  • انگلیسی و فرانسوی، از ابتدا تا انتها

در پورتال

هر آنچه یک پورتال KYC باید به شما نشان دهد، در یک مکان.

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

مصرف این ماه

تعداد احراز هویت‌های انجام‌شده در این ماه در مقایسه با سهمیه‌ی طرح شما، که با رسیدن نتایج به‌روز می‌شود.

طرح و اشتراک

اینکه از کدام طرح استفاده می‌کنید، چه مواردی را شامل می‌شود و از کجا می‌توانید آن را تغییر دهید.

کلیدهای API

کلیدهای sandbox و کلیدهای زنده؛ هر کدام فقط یک بار به‌طور کامل نمایش داده می‌شوند و پس از آن فقط با یک پیشوند کوتاه نشان داده می‌شوند تا بتوانید آن‌ها را از هم تشخیص دهید.

سابقه‌ی مصرف

این ماه و سابقه‌ی ماه‌های قبل، تا افزایش ناگهانی یا ماه کم‌مصرف به‌راحتی دیده شود.

صورتحساب و فاکتورها

اشتراک شما، وضعیت آن و فاکتورهای قبلی در یک صفحه.

برندسازی، در طرح‌های واجد شرایط

نام شرکت، لوگو و رنگ تأکیدی را که متقاضیان در صفحهٔ راستی‌آزمایی میزبانی‌شده می‌بینند تنظیم کنید.

Sign-in

آن‌گونه که یک پورتال KYC باید ایمن باشد، ایمن شده است.

این پورتالی است که مسئول انطباق (compliance) شما وارد آن می‌شود، بنابراین خود فرایند ورود به همان اندازه‌ی بررسی‌های پشت آن مورد توجه قرار گرفته است.

  • گذرواژه‌ها هش می‌شوند و هرگز به‌صورت متن ساده ذخیره نمی‌شوند.
  • هشت بار ورود ناموفق، حساب را برای پانزده دقیقه قفل می‌کند، بنابراین اسکریپت حدس گذرواژه به جایی نمی‌رسد.
  • نشست (session) یک توکن تصادفی است؛ فقط هش آن روی سرور نگهداری می‌شود و کوکی با HttpOnly علامت‌گذاری شده است.
  • ورود دومرحله‌ای — به‌زودی.
  • ورود به سیستم و کل پورتال به زبان‌های انگلیسی و فرانسوی در دسترس است.

کلیدهای API

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

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

  • کلیدهای sandbox و کلیدهای زنده همیشه متمایز هستند، بنابراین یک اسکریپت آزمایشی هرگز نمی‌تواند به‌طور تصادفی به محیط عملیاتی دست بزند.
  • کلید کامل فقط یک بار، بلافاصله پس از ساخت، نمایش داده می‌شود. پس از آن فقط یک پیشوند کوتاه را به‌صورت آشکار نگه می‌داریم.
  • ابطال یک کلید بلافاصله اعمال می‌شود: درخواست بعدی با آن کلید رد می‌شود.
  • محدودیت نرخ درخواست برای هر کلید در همهٔ طرح‌ها وجود دارد.

کلیدهای API

داده‌های نمونه

کلید sandbox جدید ایجاد شد

vk_sand_8Kd93jXQmZp2AeBTUqk7RmS4

همین حالا آن را کپی کنید. دیگر نمایش داده نخواهد شد — پس از این فقط پیشوند آن قابل مشاهده می‌ماند.

  • پیش‌فرض sandbox

    vk_sand_8Kd9…

    Sandbox12 سپتامبر 2026فعال
  • محیط عملیاتی (Production)

    vk_live_2Qf1…

    زنده3 اوت 2026فعال
  • آزمون قدیمی یکپارچه‌سازی

    vk_sand_9Ta2…

    Sandbox18 فوریهٔ 2026ابطال‌شده

داده‌های نمونه

نتیجه چه شکلی دارد.

هر احراز هویت در قالب نتایج جداگانه و نام‌دار برمی‌گردد، نه یک امتیاز مبهم. این یک نمونه‌ی فرضی است: نام‌ها و سند ساختگی هستند، اما ساختار نتیجه واقعی است.

Jordan Reyes

Ontario driver's licence

داده‌های نمونهSandbox تأییدشده
سند
موفق
کارت شناسایی اصالت‌سنجی می‌شود: روی کارت، پشت کارت، بارکد و MRZ، در صورت وجود، همگی خوانده می‌شوند.
هویت
موفق
بارکد، MRZ و صفحه‌ی چاپی در تمام فیلدها با هم مطابقت دارند. منبعی که مغایرت داشته باشد علامت‌گذاری می‌شود و هرگز میانگین‌گیری نمی‌شود.
تطابق نام
موفق
نامی که یکپارچه‌سازی شما انتظار داشته با نام روی کارت شناسایی مطابقت دارد.
تشخیص زنده‌بودن
موفق
یک چالش هدایت‌شده که روی ۴۷۸ نقطه‌ی مشخصه‌ی چهره در دست‌کم ده فریم ردیابی می‌شود.
Anti-spoof
موفق
نه عکسِ یک عکس، نه بازپخش از روی صفحه‌نمایش و نه چهره‌ی چاپ‌شده.
دیپ‌فیک
موفق
نشانه‌ای از چهره‌ی مصنوعی یا دست‌کاری‌شده وجود ندارد.
ماسک
موفق
نشانه‌ای از ماسک سه‌بعدی یا پروتز وجود ندارد.
دستکاری
گزارش شد
یک سیگنال مشورتی روی تصویر سند، نه یک دروازه‌ی قبول/رد.
تطبیق چهره
موفق
چهره‌ی زنده با تصویر چهره‌ی روی سند مطابقت دارد و نتیجه در برابر یک مرز تصمیم‌گیری ثابت گزارش می‌شود. ما هرگز درصد را چاپ نمی‌کنیم.
تحریم‌ها
Add-on
فهرست‌های OFAC، UN، EU، Canada OSFI، UK HMT، Australia DFAT و OpenSanctions را برای حساب‌هایی که این گزینه را اضافه می‌کنند بررسی می‌کند؛ به‌روزرسانی فهرست‌ها به‌صورت دستی یا با همگام‌سازی زمان‌بندی‌شده‌ی بیرونی انجام می‌شود، نه با بازآوری روزانه‌ی خودکار.
نشانی
موفق
نشانی ثبت‌شده با نشانی چاپ‌شده یا رمزگذاری‌شده روی کارت شناسایی مطابقت دارد، در صورتی که نشانی برای مقایسه ارائه شده باشد.

کالبدشکافی یک نتیجه

یک نمونه احراز هویت، فیلد به فیلد.

داده‌های نمونه: یک نشست ساختگی برای یک متقاضی ساختگی، به همان شکلی که به داشبورد و دریافت‌کنندهٔ webhook شما می‌رسد.

داده‌های نمونه
شناسهٔ نشست
ses_7f2a91c0b3d4 — شناسه‌ای که نشست را با آن ایجاد کردید و همان شناسه‌ای که هر جست‌وجو و webhook بعدی از آن استفاده می‌کند.
وضعیت
VERIFIED، FAILED، PENDING، IN_PROGRESS یا EXPIRED.
محیط
Sandbox یا production، که روی نشست ثبت می‌شود و هرگز با هم مخلوط نمی‌شوند.
متقاضی
نام، تاریخ تولد، نوع مدرک، کشور و حوزهٔ قضایی مدرک و نشانی، به‌همان صورت که از مدرک شناسایی خوانده شده است.
نتیجهٔ هر بررسی
مدرک، زنده‌بودن (liveness)، ضدجعل (anti-spoof)، تطبیق چهره و در صورت فعال‌بودن، تحریم‌ها؛ هرکدام به‌تنهایی PASS، FAIL یا SKIPPED.
تطبیق چهره
با یک مرز تصمیم‌گیری ثابت مقایسه می‌شود. ما قبولی یا ردی را گزارش می‌کنیم، نه درصد.
راهنمای عکس‌برداری مجدد
در صورت شکست، کدام طرف — مدرک یا سلفی — واقعاً نیاز به عکس‌برداری دوباره دارد، به‌جای یک «دوباره تلاش کنید» کلی.
زمان تکمیل
زمانی که نشست به وضعیت نهایی خود رسید.
روش تحویل
یک webhook امضاشده به webhook_url شما، و همان نتیجه در داشبورد و API.

تصاویر مربوط به این نتیجه به‌صورت خودکار و با یک زمان‌سنج کوتاه، به‌طور پیش‌فرض هفت روز، پاک می‌شوند. خود نتیجه باقی می‌ماند.

بقیهٔ تصویر

بخش مدیریت، نقش‌ها و محدودیت‌ها، صادقانه.

دو نکته که بهتر است صریح گفته شود، نه اینکه خودتان بعداً کشف کنید.

بخش مدیریت

در پشت هر پورتال مشتری، یک کنسول داخلی جداگانه وجود دارد که تیم خودمان از آن استفاده می‌کند: میزان استفاده و صورت‌حساب هر حساب در یک جست‌وجو، تغییر طرح‌ها و تنظیمات مشترک تشخیص که در محدوده‌های ثابت و آزمایش‌شده تنظیم می‌شوند. این کنسول بخشی از حساب شما نیست و آن را نخواهید دید.

به‌زودی

نقش‌ها و محدودیت‌ها

در حال حاضر هر حساب یک ورود دارد. دعوت از هم‌تیمی‌ها با نقش مخصوص خودشان — مدیر، صورت‌حساب، فقط‌خواندنی — به‌زودی ارائه می‌شود. محدودیت نرخ درخواست برای هر کلید در همهٔ طرح‌ها وجود دارد؛ اِعمال آن در API زنده به‌زودی ارائه می‌شود، پس محدودیت طرح خود را عددی بدانید که باید طراحی را بر مبنای آن انجام دهید، نه هنوز مانعی که API اِعمال می‌کند.

Quick-start

از ثبت‌نام تا اولین نتیجهٔ شما.

پورتال برای این ساخته شده که شما را سریع به یک نتیجهٔ واقعی برساند، نه اینکه ابتدا مجبور شوید راهنما بخوانید.

  1. حساب خود را ایجاد کنید

    در پورتال ثبت‌نام کنید و انگلیسی یا فرانسوی را انتخاب کنید. برای sandbox نیازی به کارت نیست.
  2. کلید sandbox خود را کپی کنید

    فقط یک بار، بلافاصله پس از ایجاد نمایش داده می‌شود. آن را در محیط (environment) خود قرار دهید، نه در کنترل نسخهٔ سورس.
  3. یک نشست ایجاد کنید

    یک فراخوانی API با نشانی بازگشت و نشانی webhook. پیوندی را که برمی‌گرداند برای متقاضی بفرستید.
  4. نتیجه را بخوانید

    آن را در داشبورد ببینید، یا به‌محض رسیدن از روی webhook امضاشده بخوانید.

بیشتر تیم‌ها همان بعدازظهر به یکپارچه‌سازی کارآمد sandbox می‌رسند.

پرسش‌ها

پاسخ‌های روشن درباره داشبورد.

شروع کنید

وارد شوید و خودتان ببینید.

سریع‌ترین راه برای شناخت داشبورد این است که آن را باز کنید: یک کلید sandbox بسازید، یک احراز هویت اجرا کنید و نتیجه را لحظه‌به‌لحظه ببینید.