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

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

• يجب أن تتمكّن العقدة 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