الجوال والشاشات
تطبيق الجوال (Okta Mobile)
تطبيق أوكتا للجوال يعرض كروت خدمات للمستخدم. يمكن لتطبيقك أن يقدّم خدمة تظهر ككارد داخله. هذا الإعداد مرتبط بكل إصدار على حدة — إصدار لاحق يستطيع تفعيله دون لمس الإصدار الأصلي.
أين تُفعِّله
لوحة الشريك → التطبيق → الإصدار → تبويب التكامل → بطاقة «خدمات داخل تطبيق أوكتا للجوال» → فعّل الخيار، ثم قدّم الإعدادات.
الأوضاع الثلاثة — اختر واحداً لكل إصدار
| الوضع | ما تشحنه | أين | يُعرَض |
|---|---|---|---|
native |
كود Dart حقيقي (Flutter) | okta_app/native/<entry>/lib/ |
واجهة أصلية داخل تطبيق أوكتا |
webview |
ملفات ويب | okta_app/webview/ |
داخل WebView محصور |
external |
لا شيء — تستضيفه بنفسك | رابط HTTPS عندك | WebView على رابطك |
native هو الوضع الوحيد الذي يعطيك واجهة أصلية، وهو الوحيد الذي يصل
عتاد الجهاز عبر نداءات Okta.*. الوضعان الآخران يمرّان بنموذج صلاحيات
المتصفح الذي لا تتوسّطه المنصة.
الإعدادات التي تقدّمها
| الإعداد | الوصف |
|---|---|
| نوع العرض (mode) | native (كود Dart — واجهة أصلية) أو webview (ملفات ويب داخل مستودعك) أو external (رابط تستضيفه أنت). |
| نقطة الدخول (entry) | للـ native: ملف .dart تحت okta_app/native/<entry>/lib/. للـ webview: مسار نسبي داخل okta_app/webview/. للـ external: رابط HTTPS كامل. |
| أرضية العقد (min_contract) | لوضع native فقط. أدنى عقد مضيف يحتاجه كودك — لكل نوع حساب، تحت مدخل كل صفّ في قائمة أنواع حسابات تطبيق أوكتا؛ النوع الذي لا يعلنها يرث افتراض الكتلة، وmobile.minContract المُصدَّر مرآةُ النوع الأساسي. |
| الأصول المسموحة (allowed origins) | للـ external فقط: قائمة أصول HTTPS يُسمح بتحميل الصفحة منها. |
| الصلاحية المطلوبة (required scope) | اختياري. الكارد يظهر فقط إذا كان الدور النشط للمستخدم يملك هذه الصلاحية (من الصلاحيات الممنوحة للإصدار). فارغ = يظهر لأي دور يصل للتطبيق. |
| تمرير الدور (pass role claim) | اختياري، للـ external فقط. يضيف claim الدور داخل JWT الموقّع. لا وصول لقاعدة بيانات في كل الأحوال. |
هيكلة الملفات (وضع webview)
ضع كل ما يُعرض في الجوال داخل مجلد okta_app/webview/ في جذر مستودع تطبيقك:
mobile/
├── README.md
├── manifest.json ← بيانات وصفية اختيارية للسطح الجوّال
├── screens/ ← ملفات نقطة الدخول التي تُعرض في WebView
│ └── dashboard.blade.php
└── assets/ ← css / js / صور هذه الشاشات
نقطة الدخول مثال: okta_app/webview/screens/dashboard.blade.php.
السياسة (مُلزِمة)
خدمات الجوال محصورة في نطاق okta_app/webview/ المخصّص:
entryللـwebviewيجب أن يكون مساراً نسبياً داخلokta_app/webview/حصراً — بدون بروتوكول (http(s)://) وبدون خروج بـ... يُرفض غير ذلك عند الحفظ/المراجعة.- شاشات الجوال لا يُسمح لها بالربط أو الانتقال أو التضمين لأي صفحة
منصّة/مستأجر خارج نطاق
okta_app/webview/. - يُفرض هذا أيضاً وقت التشغيل عبر middleware
app.webviewعلى okta-web (السطح الجوّال محصور على نطاق/app). - في وضع
externalلا تشحن ملفات هنا — تستضيف الصفحة بنفسك، والعزل يكون عبرallowed origins+ صفر ربط بيانات.