# Saudi Identity

> Saudi digital identity verification via Nafath and Yakeen APIs

- **Type:** Skill
- **Install:** `agentstack add skill-moshe-ship-hurmoz-saudi-identity`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Moshe-ship](https://agentstack.voostack.com/s/moshe-ship)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Moshe-ship](https://github.com/Moshe-ship)
- **Source:** https://github.com/Moshe-ship/hurmoz/tree/main/saudi-identity

## Install

```sh
agentstack add skill-moshe-ship-hurmoz-saudi-identity
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# الهوية الرقمية السعودية (نفاذ + يقين)

دليل التكامل مع خدمات التحقق من الهوية الرقمية في المملكة العربية السعودية.

> **تنبيه مهم**: واجهات نفاذ ويقين البرمجية تتطلب ترخيصاً رسمياً. لا تستخدم أرقام هوية وطنية حقيقية في بيئة التطوير أو الاختبار. استخدم فقط أرقام الاختبار التي توفرها الجهة المرخِّصة ضمن بيئة الـ Sandbox. احذف السجلات بعد الانتهاء.

---

## نفاذ (Nafath) — الهوية الرقمية الوطنية

نفاذ هو نظام الهوية الرقمية الوطني الذي يوفر مصادقة متعددة العوامل (MFA) للخدمات الحكومية والخاصة.

### الحصول على الترخيص (مطلوب)

يتطلب الوصول لواجهات نفاذ البرمجية ترخيصاً من شركة TCC-ICT:

1. **تقديم طلب ترخيص**: https://tcc-ict.com
2. **التسجيل في منصة المطورين**: https://developer.tcc-ict.com
3. بعد الموافقة، ستحصل على بيانات الوصول لبيئة الـ Sandbox أولاً
4. بعد اجتياز اختبارات التكامل، يُفعّل الوصول لبيئة الإنتاج
5. ستحصل على `Bearer Token` للمصادقة

> **ملاحظة**: عنوان الـ API الفعلي يُقدَّم ضمن وثائق الترخيص بعد الموافقة. لا يوجد عنوان عام — كل مرخَّص له بيئة خاصة.

### واجهات نفاذ البرمجية

#### 1. إنشاء طلب مصادقة

```bash
# عنوان الـ API يُقدَّم مع الترخيص — استبدل YOUR_NAFATH_BASE_URL
curl -X POST "${YOUR_NAFATH_BASE_URL}/ExtNafath/request" \
  -H "Authorization: Bearer ${NAFATH_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "nationalId": "1000000000",
    "service": "login"
  }'
```

الاستجابة تتضمن `transId` ورقم عشوائي يظهر للمستخدم في تطبيق نفاذ.

#### 2. التحقق من حالة الطلب

```bash
curl -X POST "${YOUR_NAFATH_BASE_URL}/ExtNafath/status" \
  -H "Authorization: Bearer ${NAFATH_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "transId": "TRANSACTION_ID"
  }'
```

الحالات: `WAITING` | `COMPLETED` | `EXPIRED` | `REJECTED`

#### 3. جلب بيانات المستخدم بعد التحقق

```bash
curl -X GET "${YOUR_NAFATH_BASE_URL}/ExtNafath/details/TRANSACTION_ID" \
  -H "Authorization: Bearer ${NAFATH_TOKEN}"
```

يعيد بيانات الهوية المُتحقق منها (الاسم، رقم الهوية، تاريخ الميلاد، إلخ).

### حزمة GitHub جاهزة

```
github.com/mohamad-zatar/saudi-nafath-integration
```

---

## يقين (Yakeen by Elm) — التحقق من بيانات الهوية

يقين هي خدمة من شركة علم للتحقق من بيانات المواطنين والمقيمين.

### الحصول على الترخيص (مطلوب)

يتطلب الوصول لواجهات يقين عقداً رسمياً مع شركة علم:

1. **التقديم عبر موقع علم**: https://elm.sa
2. **بوابة المطورين**: https://developer.elm.sa
3. يتطلب سجل تجاري سعودي ساري
4. بعد التعاقد، يتم توفير بيانات الوصول لبيئة الاختبار ثم الإنتاج

> **ملاحظة**: عنوان الـ API الفعلي يُقدَّم ضمن وثائق العقد. لا يوجد عنوان عام.

### الطرق المتاحة

| الطريقة | الوصف | الاستخدام |
|---------|-------|-----------|
| `CitizenInfo` | بيانات المواطن بالهوية الوطنية | التحقق من بيانات المواطنين |
| `AlienInfoByIqama` | بيانات المقيم برقم الإقامة | التحقق من بيانات المقيمين |

### مثال استدعاء (REST)

```bash
# عنوان الـ API يُقدَّم مع العقد — استبدل YOUR_YAKEEN_BASE_URL
curl -X POST "${YOUR_YAKEEN_BASE_URL}/api/v1/CitizenInfo" \
  -H "Authorization: Bearer ${YAKEEN_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "nin": "1000000000",
    "dateOfBirth": "1410-01-01"
  }'
```

```bash
curl -X POST "${YOUR_YAKEEN_BASE_URL}/api/v1/AlienInfoByIqama" \
  -H "Authorization: Bearer ${YAKEEN_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "iqamaNumber": "2000000000",
    "dateOfBirth": "1980-01-01"
  }'
```

### مجموعة Postman

```
postman.com/crimson-crater-793597/yakeen-collection/
```

---

## عرض النتيجة

```
تم التحقق من الهوية
الاسم: {{ fullName }}
رقم الهوية: {{ nationalId }}
الحالة: {{ status }}
```

---

## متى تستخدم

استخدم هذه المهارة عندما يسأل المستخدم عن:
- التحقق من الهوية السعودية أو الهوية الرقمية
- نفاذ (Nafath) أو المصادقة الرقمية الوطنية
- يقين (Yakeen) أو التحقق من بيانات المواطن/المقيم
- ربط تطبيق بالهوية الرقمية السعودية
- Elm identity services

---

## المراجع

- توثيق نفاذ: https://documentation.azakaw.com/docs/apis/core/nafath
- حزمة نفاذ: https://github.com/mohamad-zatar/saudi-nafath-integration
- شركة علم: https://elm.sa
- بوابة مطوري علم: https://developer.elm.sa
- رخصة TCC: https://tcc-ict.com
- بوابة مطوري TCC: https://developer.tcc-ict.com
- مجموعة يقين Postman: https://postman.com/crimson-crater-793597/yakeen-collection/

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Moshe-ship](https://github.com/Moshe-ship)
- **Source:** [Moshe-ship/hurmoz](https://github.com/Moshe-ship/hurmoz)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-moshe-ship-hurmoz-saudi-identity
- Seller: https://agentstack.voostack.com/s/moshe-ship
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.