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

Edge for Private Cloud v4.18.05

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

  • يجب أن تتمكّن العقدة apigee-sso من الوصول إلى عقدة Postgres في المنفذ 5432.
  • يجب فتح المنفذ 9099 على العقدة apigee-sso للوصول عبر HTTP خارجيًا من خلال واجهة مستخدم Edge وموفِّر الهوية (IdP) المستنِد إلى SAML. في حال ضبط بروتوكول أمان طبقة النقل على 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-ui configure-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 "drop database \"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-ui configure-sso -f configFile