تتضمّن واجهة برمجة التطبيقات SAS Portal API عدة أدوار موضّحة أدناه، ويمنح كل دور منها المستخدم إذنًا بإجراء طلبات معيّنة من واجهة برمجة التطبيقات. يتم تعيين الأدوار إلى حساب المستخدم على Google.
أول مستخدم في مؤسسة أحد عملاء SAS هو المشرف، ويتم إضافته تلقائيًا أثناء عملية الاشتراك. يمكن للمشرف بعد ذلك إضافة مستخدمين آخرين وتعيين أدوار لهم، بما في ذلك دور المشرف.
أدوار المستخدمين
هناك دورَان يمكن إسنادهما للمستخدمين:
role_admin
يتمتع هذا الدور بامتيازات إدارية كاملة لجميع الموارد الفرعية ضمن المورد الرئيسي الذي تم منح الإذن بالوصول إليه. ويقومون بإعداد بنية المؤسسة ضمن "بوابة SAS" وإدارة إذن وصول المستخدمين.
role_cpi
هذا الدور مخصّص للمستخدمين الذين يحملون شهادة اعتماد كفنيي تركيب محترفين (CPI). للحصول على هذا الدور،
على المستخدمين إثبات أنّ لديهم شهادة اعتماد نشطة في "مؤشر أسعار المستهلك". ويتم ذلك باستخدام الطريقة
ValidateInstaller(). يمكن فقط للمستخدمين الذين لديهم دور role_cpi تم التحقّق منه استخدام طريقة SignDevice() لإرسال مَعلمات التثبيت الخاصة بأجهزة CBSD التي تتطلّب تثبيت CPI.
الطُرق
يوضّح الجدول التالي الأدوار التي يمكنها استخدام كل نوع من أنواع الطرق:
| الطُرق | الأدوار |
|---|---|
GetCustomer() |
|
ListCustomers() |
|
CreateDevice() |
|
GetDevice() |
|
ListDevices() |
|
UpdateDevice() |
|
CreateSignedDevice() |
|
UpdateSignedDevice() |
|
GenerateSecret() |
|
ValidateInstaller() |
|
SignDevice() |
role_cpi (تم التحقّق من صحتها) |