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

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

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

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