تفعيل SAML لـ BaaS لواجهة برمجة التطبيقات

الإصدار 4.17.09 من Edge for Private Cloud

بعد تفعيل SAML في Edge، يمكنك تفعيل SAML في واجهة برمجة التطبيقات BaaS. يتطلب دعم SAML لـ API BaaS أن تكون قد قمت بالفعل بتثبيت وتكوين وحدة Edge SSO على عقدة خادم إدارة Edge.

في ما يلي العملية العامة لتفعيل SAML لـ API BaaS:

1. اضبط SAML على Edge كما هو موضّح في تثبيت SAML وإعدادها لـ Edge.
2. ثبِّت API BaaS وتأكَّد من أنّ عملية التثبيت تعمل بشكل صحيح. ويشمل ذلك إنشاء مؤسسات BaaS. يُرجى الاطّلاع على تثبيت واجهة برمجة التطبيقات BaaS.
3. بالنسبة إلى جميع مستخدمي BaaS الحاليين، بما في ذلك مشرف نظام BaaS ومشرفي مؤسسة BaaS، أنشئ مستخدمًا مطابقًا في موفِّر الهوية. يجب أن يكون عنوان البريد الإلكتروني للمستخدم في موفِّر الهوية هو نفسه الذي تم استخدامه لإنشاء مستخدم BaaS.
4. اضبط SAML على API BaaS.

ضبط SAML على API BaaS

لضبط SAML على واجهة برمجة تطبيقات BaaS، عليك تفعيلها على كلّ من بوابة BaaS وStack، بهذا الترتيب.

عليك أولاً إنشاء ملف إعداد لضبط SAML:

# IP address of BaaS Portal
IP1=11.111.11.111

# IP address of apigee-sso node
IP2=22.222.22.222

# Information about apigee-sso.
# Externally accessible IP or DNS of apigee-sso.
SSO_PUBLIC_URL_HOSTNAME=$IP2
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on apigee-sso.
SSO_PUBLIC_URL_SCHEME=http

# SSO admin credentials as set when you installed apigee-sso.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=Secret123

# The name of the OAuth client used to connect to apigee-sso.
# The default client name is "baas". 
BAAS_SSO_CLIENT_NAME=baas

# If set, the existing BAAS client is deleted and new one is created.
# The default value is "n".
# Set to "y" when you reconfigure SAML and change the value of 
# any of the BAAS_* properties.
BAAS_SSO_CLIENT_OVERWRITE=y

# API BaaS Portal properties:
BAAS_SSO_ENABLED=y

# Comma separated list of URLs for the BAAS portal, 
# in the format:  http_or_https://IP_or_hostname_of_UI:9000. 
# You can have multiple URLs when you have multiple installations
# of the BAAS portal or you have multiple data centers.
BAAS_PUBLIC_URIS=http_or_https://IP_or_hostname_of_BAAS:9000
BAAS_SSO_REGISTERED_PUBLIC_URIS=$BAAS_PUBLIC_URIS

# API BaaS Stack properties
BAAS_SSO_ENABLED=y

لضبط واجهة برمجة التطبيقات BaaS لتفعيل دعم SAML:

1. نفِّذ الأمر التالي لضبط SAML على بوابة BaaS:
   > /opt/apigee/apigee-service/bin/apigee-service baas-portal configure-sso -f samlConfigFile
   
   حيث samlConfigFile هو ملف إعداد SAML.
2. نفِّذ الأمر التالي لإعادة تشغيل البوابة الإلكترونية:
   > /opt/apigee/apigee-service/bin/apigee-service baas-portal restart
3. نفِّذ الأمر التالي لضبط SAML على جميع عُقد BaaS Stack:
   > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure-sso -f samlConfigFile

لتغيير هذه القيم لاحقًا، عدِّل ملفات الإعداد ونفِّذ هذه الخطوات مرة أخرى.

إيقاف SAML على API BaaS

لإيقاف SAML على API BaaS:

1. عدِّل ملف الإعداد الذي استخدمته لضبط SAM لضبط:
   BAAS_SSO_ENABLED=n
2. اضبط بوابة BaaS:
   > /opt/apigee/apigee-service/bin/apigee-service baas-portal configure-sso -f configFile
   
   ملاحظة: على المستخدمين الذين لم يسبق لهم ضبط كلمة مرور BaaS اختيار رابط إعادة ضبط كلمة المرور في صفحة تسجيل الدخول لضبط كلمة مرور جديدة.
3. شغِّل الأمر التالي لإعادة تشغيل البوابة:
   > /opt/apigee/apigee-service/bin/apigee-service baas-portal restart
4. اضبط حزمة BaaS:
   > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure-sso -f configFile