فعال‌سازی و تنظیمات شاهکار

ورود ثبت‌نام
← بازگشت به راهنما

فعال‌سازی و تنظیمات شاهکار



> version: 2.5 | last_updated: 2026-09-29 | audience: admin

منو



**تنظیمات → تنظیمات اصلی → تب تنظیمات شاهکار**

مسیر: `/panel/main-settings/compliance-provider-configs`
(مسیر قدیمی `/panel/compliance-provider-configs` ریدایرکت می‌شود)

برای هر شرکت **فقط یک** صفحه تنظیمات وجود دارد (نه لیست چندتایی). اتصال و سیاست استعلام همگی از همین‌جا است.

مدل



| مدل | وضعیت |
|-----|--------|
| **اپراتوری** | فعال — آدرس/IP، کد ۴رقمی، یوزر، پسورد (Basic Auth) |
| **api.ir** | فعال — توکن از `p.api.ir`؛ شاهکار (تطبیق کدملی/موبایل) + بایومتریک روی `s.api.ir` |
| **NSCRA** | فقط انتخاب مدل؛ جزئیات اتصال و API بعداً |

اگر مدل NSCRA باشد و سرویس برای یک trigger روشن باشد، ذخیره مشتری بلاک می‌شود.

اتصال اپراتوری



  • `base_url` — مثلاً `http://45.9.252.67:9580`

  • `shahkar_code` — کد ۴رقمی

  • `username` / `password` — Basic Auth

  • دکمه **تست اتصال** → `POST …/rest/shahkar/hc`


    • **منبع واحد:** کارتابل (`{{shahkar_base_url}}` / `{{shahkar_authorization}}`) و گیت ثبت‌نام/ویرایش فقط از همین منو می‌خوانند.
    شاهکار دیگر در **سرورهای بیرونی** قابل تعریف نیست.

    اتصال api.ir



  • `api_token` — Bearer از پنل p.api.ir

  • `api_base_url` — پیش‌فرض `https://s.api.ir`

  • `shahkar_method` — `Shahkar` (رمزشده) یا `ShahkarLite`

  • دکمه **تست اتصال** → درخواست سبک به `ShahkarLite`


    • **تفسیر پاسخ شاهکار api.ir:** فیلد `success=true` فقط یعنی درخواست قبول شده؛ نتیجهٔ تطبیق در `data` است (`true`/`false`). اگر `data=false` باشد (مثلاً پیام «عدم انطباق اطلاعات وارد شده») سیستم آن را **رد** می‌کند و ثبت‌نام/ذخیره بلاک می‌شود — نه تأیید. بعد از استعلام موفق، `party.metadata.shahkar_verified` هم به‌روز می‌شود تا صفحهٔ احراز هویت پورتال با تاریخچه هم‌خوان باشد.

    بایومتریک (فقط مدل api.ir)



    سرویس جدا با triggerهای همان چهار مسیر:

    | متد | ورودی |
    |-----|--------|
    | FaceMatch / FaceMatchLite | عکس سلفی + سریال کارت + تاریخ تولد |
    | VideoMatch / VideoLive | ویدئو سلفی + سریال + تاریخ تولد |

    در فرم ثبت‌نام/ویرایش پورتال و نماینده، وقتی بایومتریک برای آن trigger روشن باشد فیلدها نمایش داده می‌شوند. نتایج با `provider = gate.biometric` در گزارش شاهکار.

    **توجه:** `service match` روی api.ir نیست؛ فقط مدل اپراتوری.

    وب‌سرویس‌ها روی ثبت‌نام / ویرایش



    به تفکیک فعال می‌شوند؛ برای هر کدام زمان اجرا جداست:

  • ثبت‌نام از پنل ریسلر

  • ویرایش از پنل ریسلر

  • ثبت‌نام از پنل مشتری

  • ویرایش از پنل مشتری


    • | سرویس | متد | رفتار شکست |
    |--------|------|------------|
    | استعلام / تطبیق موبایل | اپراتوری: `estelaam` — api.ir: `Shahkar`/`ShahkarLite` | پاسخ ناموفق → **جلو ذخیره** |
    | service match | فقط اپراتوری `serviceID-matching` | بدون `serviceNumber` هم بلاک |
    | بایومتریک | فقط api.ir Face/Video | بدون عکس/ویدئو یا سریال → بلاک |

    نتایج در **گزارش‌گیری → گزارش شاهکار** با `provider = gate.estelaam` / `gate.service_match` / `gate.biometric` ثبت می‌شوند.

    کارتابل (lifecycle)



    متدهای `put` / `update` / `close` / … جدا هستند؛ نوع سرویس از `provisioning_config.shahkar_service_type` محصول می‌آید.
    مستندات: [shahkar-workflow-actions.md](./shahkar-workflow-actions.md)