الهوية الوطنية

Nafath (نفاذ) — ELM · المرحلة 1

المواصفات

الميزات المعتمدة عليه

• user_signup
• 2fa_alternative
• kyc

الاستخدام في الـ Code

use App\Integrations\Contracts\IdentityProvider;

class MyController {
    public function __construct(
        private readonly IdentityProvider $service,
    ) {}

    public function action() {
        // $this->service يتحقن تلقائياً (mock أو production)
        // حسب config('sakeenah.integrations.identity.driver')
    }
}

لرفع التكامل إلى Production

1. اطلب credentials من الموزود الرسمي
   تواصل مع: Nafath (نفاذ) — ELM
2. ابنِ Production Adapter

   // app/Integrations/Production/NafathAdapter.php
   namespace App\Integrations\Production;
   
   use App\Integrations\Contracts\IdentityProvider;
   use Illuminate\Support\Facades\Http;
   
   class NafathAdapter implements IdentityProvider {
       public function __construct(
           private string $apiKey = config('sakeenah.integrations.identity.api_key'),
       ) {}
   
       // Implement all interface methods using real HTTP calls
       // Use Laravel's Http::withToken($this->apiKey)->post(...)
   }

3. ضع credentials في .env

   IDENTITY_DRIVER=production
   IDENTITY_API_KEY=your_real_key_here

4. اختبر — كتب feature test يستخدم mock أولاً، ثم integration test على staging
5. أعد تشغيل — php artisan config:clear

موافقات + Compliance

• تحقق من شروط الموزود الرسمي (في الـ docs URL أعلاه)
• وثّق DPA (Data Processing Agreement) موقّع
• أضف الموزود إلى قائمة الـ subprocessors المنشورة للمستخدمين
• إذا الموزود يخزّن PHI، تأكد أنه ضمن السعودية (data residency)

المتعلق

• ← العودة لدليل التكاملات
• لوحة حالة التكاملات (admin)
• وثائق الموزود الرسمية