defineApplicationRole() (انظر دور الدالة الافتراضي أدناه).
src/roles/restricted-company-role.ts
الدور الافتراضي للوظيفة
عند إنشاء هيكل لتطبيق جديد، ينشئ CLI ملف دور افتراضي مُصرَّحًا به باستخدامdefineApplicationRole():
src/roles/default-role.ts
defineApplicationRole() غلافًا بسيطًا حول defineRole() يشير إلى الدور المستخدم كإعداد افتراضي لتطبيقك وقت التثبيت. يتطابق التحقق من الصحة مع defineRole، لكن خط تجميع البناء يربط تلقائيًا قيمة universalIdentifier بصفة defaultRoleUniversalIdentifier في بيان التطبيق (manifest)، وبالتالي لا تحتاج إلى الإشارة إليه من defineApplication بنفسك.
الملاحظات:
- يُسمح بوجود استدعاء واحد فقط لـ
defineApplicationRole(...)لكل تطبيق — سيفشل إنشاء بيان التطبيق (manifest) إذا عثر على أكثر من واحد. - استخدم
defineRole()(وليسdefineApplicationRole()) لأي أدوار إضافية يأتي بها تطبيقك. - لا يزال تعيين
defaultRoleUniversalIdentifierصراحةً علىdefineApplication()مدعومًا للتوافق مع الإصدارات السابقة، ولكنه مُهمَل لصالحdefineApplicationRole().
أفضل الممارسات
- ابدأ من الدور المُنشأ تلقائيًا، ثم قم بتقييده تدريجيًا — إذ يمنح الإعداد الافتراضي صلاحيات قراءة واسعة، وهو ما نادرًا ما تريده في بيئة الإنتاج.
- استبدل
objectPermissionsوfieldPermissionsبالكائنات والحقول الدقيقة التي تحتاجها وظائفك فعليًا. permissionFlagUniversalIdentifiersتتحكم في الوصول إلى القدرات على مستوى المنصة. اجعلها في حدّها الأدنى.- اطّلع على مثال عملي:
hello-world/src/roles/function-role.ts.