تحديد مشاكل SAML وحلّها على السحابة الإلكترونية الخاصة

Edge for Private Cloud v4.18.01

إذا تعذّر إتمام عملية التثبيت أو الضبط، يجب أولاً التأكّد من أن جميع المنافذ اللازمة مفتوحة ويمكن الوصول إليها:

  • يجب أن تتمكّن العقدة apigee-sso من الوصول إلى عقدة Postgres في المنفذ 5432.
  • يجب فتح المنفذ 9099 على العقدة apigee-sso للوصول إلى بروتوكول HTTP من خلال واجهة مستخدم Edge وموفِّر الهوية (IdP) المستنِد إلى SAML. في حال تفعيل SAML لواجهة برمجة تطبيقات BaaS، يجب الوصول إلى المنفذ من بوابة BaaS وعُقد BaaS Stack. في حال ضبط بروتوكول أمان طبقة النقل على apigee-sso، قد يكون رقم المنفذ مختلفًا.
  • يجب أن تتمكّن العقدة apigee-sso من الوصول إلى موفِّر هوية SAML على عنوان URL المحدَّد من خلال السمة SSO_SAML_IDP_MetaDATA_URL.
  • يجب أن تتمكّن العقدة apigee-sso من الوصول إلى المنفذ 8080 في عقدة خادم الإدارة.

إذا كانت جميع المنافذ اللازمة مفتوحة ويمكن الوصول إليها، يمكنك إعادة تشغيل خطوات الضبط:

  • بالنسبة إلى apigee-sso:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-sso Setup -f configFile
  • بالنسبة إلى واجهة مستخدم Edge:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-uiconfigure-sso -f configFile

إذا نجحت إعادة الضبط، يمكنك حذف قاعدة بيانات Postgres التي يستخدمها apigee-sso، ثم إعادة ضبط apigee-sso وواجهة مستخدم Edge:

  1. يجب إيقاف SAML على واجهة مستخدم Edge كما هو موضّح في إيقاف SAML.
  2. أوقِف apigee-sso:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-sso stop
  3. سجِّل الدخول إلى عقدة Postgres وإفلات قاعدة بيانات Postgres:
    > psql -U postgres_username -p postgres_port -h postgres_host -c "dropDatabase \"apigee_sso\""

    حيث:
    • postgres_username هو اسم مستخدم Postgre الذي حدّدته عند تثبيت Edge. والقيمة التلقائية لهذه المعلّمة هي apigee.
    • postgres_port هو منفذ Postgres الذي حدّدته عند تثبيت Edge. ستكون القيمة التلقائية 5432.
    • postgres_host هي اسم عنوان IP أو نظام أسماء النطاقات لعقدة Postgres.
  4. أعِد ضبط apigee-sso:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-sso Setup -f configFile
  5. إعادة ضبط واجهة مستخدم Edge:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-uiconfigure-sso -f configFile