إدارة المستخدمين والأدوار والأذونات

يحتوي موقع مستندات Apigee على معلومات شاملة حول إدارة أدوار المستخدمين و أذوناتهم. يمكن إدارة المستخدمين باستخدام كل من واجهة مستخدم New Edge وManagement API، بينما لا يمكن إدارة الأدوار و الأذونات إلا باستخدام Management API.

للحصول على معلومات عن المستخدمين وإنشائهم، يُرجى الاطّلاع على ما يلي:

تتطلّب العديد من العمليات التي تجريها لإدارة المستخدمين امتيازات مشرف النظام. في عملية تثبيت Edge المستندة إلى السحابة الإلكترونية، تعمل Apigee بدور مشرف النظام. في عملية تثبيت Edge for the Private Cloud، على مشرف النظام تنفيذ هذه المهام كما هو موضّح أدناه.

إضافة مستخدم

يمكنك إنشاء مستخدم باستخدام Edge API أو واجهة مستخدم New Edge أو أوامر Edge. يوضِّح هذا القسم كيفية استخدام Edge API وأوامر Edge. للحصول على معلومات عن إنشاء مستخدمين في واجهة مستخدم New Edge، يُرجى الاطّلاع على مقالة إنشاء مستخدمين عالميين.

بعد إنشاء المستخدم في مؤسسة، عليك تعيين دور له. تحدِّد الأدوار حقوق وصول المستخدم على Edge.

استخدِم الأمر التالي لإنشاء مستخدم باستخدام Edge API:

curl -H "Content-Type:application/xml" \
  -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD -X POST http://ms_IP:8080/v1/users \
  -d '<User> \
    <FirstName>New</FirstName> \
    <LastName>User</LastName> \
    <Password>NEW_USER_PASSWORD</Password> \
    <EmailId>foo@bar.com</EmailId> \
  </User>'

أو استخدِم أمر Edge التالي لإنشاء مستخدم:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision create-user -f configFile

حيث ينشئ configFile المستخدم، كما يوضِّح المثال التالي:

APIGEE_ADMINPW=SYS_ADMIN_PASSWORD    # If omitted, you will be prompted.
USER_NAME=foo@bar.com
FIRST_NAME=New
LAST_NAME=User
USER_PWD="NEW_USER_PASSWORD"
ORG_NAME=myorg

يمكنك بعد ذلك استخدام هذا الطلب لعرض معلومات عن المستخدم:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/users/foo@bar.com

تعيين المستخدم في دور في مؤسسة

قبل أن يتمكّن مستخدم جديد من إجراء أي عملية، يجب تعيينه في دور في مؤسسة. يمكنك تعيين المستخدم في أدوار مختلفة، بما في ذلك: orgadmin أو businessuser أو opsadmin أو user أو دور مخصّص محدّد في المؤسسة.

تؤدي عملية تعيين مستخدم في دور في مؤسسة إلى إضافة هذا المستخدم تلقائيًا إلى الـ مؤسسة. يمكنك تعيين مستخدم في مؤسسات متعددة من خلال تعيينه في دور في كل مؤسسة.

استخدِم الأمر التالي لتعيين المستخدم في دور في مؤسسة:

curl -X POST -H "Content-Type:application/x-www-form-urlencoded" \
  http://ms_IP:8080/v1/o/org_name/userroles/role/users?id=foo@bar.com \
  -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD

يعرض هذا الطلب جميع الأدوار المعيّنة للمستخدم. إذا أردت إضافة المستخدم، ولكن عرض الدور الجديد فقط، استخدِم الطلب التالي:

curl -X POST -H "Content-Type: application/xml" \
  http://ms_IP:8080/v1/o/org_name/users/foo@bar.com/userroles \
  -d '<Roles><Role name="role"/><Roles>' \
  -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD

يمكنك عرض أدوار المستخدم باستخدام الأمر التالي:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/users/foo@bar.com/userroles

لإزالة مستخدم من مؤسسة، عليك إزالة جميع الأدوار في تلك المؤسسة من المستخدم. استخدِم الأمر التالي لإزالة دور من مستخدم:

curl -X DELETE -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/o/org_name/userroles/role/users/foo@bar.com

إضافة مشرف نظام

يمكن لمشرف النظام إجراء ما يلي:

  • إنشاء مؤسسات
  • إضافة أجهزة توجيه ومعالجات رسائل ومكوّنات أخرى إلى عملية تثبيت Edge
  • ضبط طبقة النقل الآمنة/بروتوكول أمان طبقة النقل (TLS/SSL)
  • إنشاء مشرفي نظام إضافيين
  • تنفيذ جميع مهام إدارة Edge

على الرغم من أنّ مستخدمًا واحدًا فقط هو المستخدم التلقائي للمهام الإدارية، يمكن أن يكون هناك أكثر من مشرف نظام واحد. يحصل أي مستخدم عضو في دور "sysadmin" على أذونات كاملة للوصول إلى جميع الموارد.

يمكنك إنشاء المستخدم لمشرف النظام في واجهة مستخدم New Edge أو واجهة برمجة التطبيقات. ومع ذلك، عليك استخدام Edge API لتعيين المستخدم في دور "sysadmin". لا يمكن تعيين مستخدم في دور "sysadmin" في واجهة مستخدم New Edge.

لإضافة مشرف نظام، اتّبِع الخطوات التالية:

  1. أنشئ مستخدمًا في واجهة مستخدم New Edge أو واجهة برمجة التطبيقات.
  2. أضِف المستخدم إلى دور "sysadmin": 
    curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  -X POST http://ms_IP:8080/v1/userroles/sysadmin/users -d 'id=foo@bar.com'
  3. تأكَّد من أنّ المستخدم الجديد في دور "sysadmin": 
    curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/userroles/sysadmin/users

    يعرض عنوان البريد الإلكتروني للمستخدم:

    [ " foo@bar.com " ]
  4. تحقَّق من أذونات المستخدم الجديد: 
    curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/users/foo@bar.com/permissions

    فإنه يعرض:

    {
  "resourcePermission" : [ {
  "path" : "/",
    "permissions" : [ "get", "put", "delete" ]
  } ]
}
  5. بعد إضافة مشرف النظام الجديد، يمكنك إضافة المستخدم إلى أي مؤسسات.
  6. إذا أردت لاحقًا إزالة المستخدم من دور مشرف النظام، يمكنك استخدام واجهة برمجة التطبيقات التالية: 
    curl -X DELETE -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/userroles/sysadmin/users/foo@bar.com

    يُرجى العِلم أنّ هذا الطلب يزيل المستخدم من الدور فقط، ولا يحذفه.

تغيير مستخدم مشرف النظام التلقائي

عند تثبيت Edge، عليك تحديد عنوان البريد الإلكتروني لمشرف النظام. ينشئ Edge مستخدمًا بعنوان البريد الإلكتروني هذا، ويضبط هذا المستخدم ليكون مشرف النظام التلقائي. يمكنك لاحقًا إضافة مشرفي نظام إضافيين كما هو موضّح أعلاه.

يوضِّح هذا القسم كيفية تغيير مشرف النظام التلقائي ليكون مستخدمًا مختلفًا، وكيفية تغيير عنوان البريد الإلكتروني لحساب المستخدم لمشرف النظام التلقائي الحالي.

للاطّلاع على قائمة المستخدمين الذين تم ضبطهم حاليًا كمشرفي نظام، استخدِم طلب واجهة برمجة التطبيقات التالي:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms_IP:8080/v1/userroles/sysadmin/users

لتحديد مشرف النظام التلقائي الحالي، اطّلِع على الملف /opt/apigee/customer/defaults.sh. يحتوي الملف على السطر التالي الذي يعرض عنوان البريد الإلكتروني لمشرف النظام التلقائي الحالي:

ADMIN_EMAIL=foo@bar.com

لتغيير مشرف النظام التلقائي ليكون مستخدمًا مختلفًا، اتّبِع الخطوات التالية:

  1. أنشئ مشرف نظام جديدًا كما هو موضّح أعلاه، أو تأكَّد من أنّ حساب مستخدم مشرف النظام الجديد تم ضبطه من قبل كمشرف نظام.
  2. عدِّل /opt/apigee/customer/defaults.sh لـ اضبط ADMIN_EMAIL على عنوان البريد الإلكتروني لمشرف النظام الجديد.
  3. عدِّل ملف الإعدادات الصامت الذي استخدمته لتثبيت واجهة مستخدم New Edge لضبط الخصائص التالية: 
    ADMIN_EMAIL=NEW_SYS_ADMIN_EMAIL
APIGEE_ADMINPW=NEW_SYS_ADMIN_PASSWORD
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=foo@gmail.com
SMTPPASSWORD=bar
SMTPSSL=y

    يُرجى العِلم أنّه عليك تضمين خصائص بروتوكول SMTP لأنّه تتم إعادة ضبط جميع الخصائص في واجهة مستخدم New Edge.

  4. أعِد ضبط واجهة مستخدم New Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui start

إذا أردت فقط تغيير عنوان البريد الإلكتروني لحساب المستخدم لمشرف النظام التلقائي الحالي، عليك أولاً تعديل حساب المستخدم لضبط عنوان البريد الإلكتروني الجديد، ثم تغيير عنوان البريد الإلكتروني لمشرف النظام التلقائي:

  1. عدِّل حساب مستخدم مشرف النظام التلقائي الحالي بعنوان بريد إلكتروني جديد: 
    curl -H content-type:application/json -X PUT -u CURRENT_SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  http://ms_IP:8080/v1/users/CURRENT_SYS_ADMIN_EMAIL \
  -d '{"emailId": "NEW_SYS_ADMIN_EMAIL", "lastName": "admin", "firstName": "admin"}'
  2. كرِّر الخطوات 2 و3 و4 من الإجراء السابق لتعديل الملف /opt/apigee/customer/defaults.sh وتعديل واجهة مستخدم New Edge.

تحديد نطاق البريد الإلكتروني لمشرف النظام

كمستوى أمان إضافي، يمكنك تحديد نطاق البريد الإلكتروني المطلوب لمشرف نظام Edge. عند إضافة مشرف نظام، إذا لم يكن عنوان البريد الإلكتروني للمستخدم في النطاق المحدّد ، ستفشل عملية إضافة المستخدم إلى دور "sysadmin".

يكون النطاق المطلوب فارغًا تلقائيًا، ما يعني أنّه يمكنك إضافة أي عنوان بريد إلكتروني إلى الـ "sysadmin" دور.

لضبط نطاق البريد الإلكتروني، اتّبِع الخطوات التالية:

  1. افتح الملف management-server.properties في محرر: 
    vi /opt/apigee/customer/application/management-server.properties

    إذا لم يكن هذا الملف موجودًا، أنشئه.

  2. اضبط السمة conf_security_rbac.global.roles.allowed.domains على قائمة قيم مفصولة بفاصلة للنطاقات المسموح بها. على سبيل المثال: 
    conf_security_rbac.global.roles.allowed.domains=myCo.com,yourCo.com
  3. احفظ التغييرات.
  4. أعِد تشغيل خادم إدارة Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

    إذا حاولت الآن إضافة مستخدم إلى دور "sysadmin"، ولم يكن عنوان البريد الإلكتروني للمستخدم في أحد النطاقات المحدّدة، ستفشل عملية الإضافة.

حذف مستخدم

يمكنك إنشاء مستخدم باستخدام Edge API أو واجهة مستخدم New Edge. ومع ذلك، لا يمكنك حذف مستخدم إلا باستخدام واجهة برمجة التطبيقات.

للاطّلاع على قائمة المستخدمين الحاليين، بما في ذلك عنوان البريد الإلكتروني، استخدِم الأمر التالي: curl

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD http://ms-IP:8080/v1/users

استخدِم أمر curl التالي لحذف مستخدم:

curl -u SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD -X DELETE http://ms_IP:8080/v1/users/USER_EMAIL