إيقاف المصادقة الأساسية على Edge

بعد تفعيل SAML أو LDAP على Edge، يمكنك إيقاف المصادقة الأساسية. ومع ذلك، قبل إيقاف المصادقة الأساسية:

• تأكَّد من إضافة جميع مستخدمي Edge، بما في ذلك مشرفي النظام، إلى IDP.
• تأكَّد من اختبار مصادقة موفِّر الهوية (IdP) بدقة على واجهة مستخدم New Edge وواجهة برمجة تطبيقات إدارة Edge.

عرض ملف الأمان الحالي

يمكنك الاطّلاع على ملف أمان Edge لتحديد الإعداد الحالي ومعرفة ما إذا كانت المصادقة الأساسية وموفّر الهوية الخارجي مفعّلين حاليًا. استخدِم طلب بيانات من واجهة برمجة التطبيقات لإدارة Edge التالي على خادم إدارة Edge لعرض ملف الأمان الحالي الذي يستخدمه Edge:

curl -H "accept:application/xml" http://localhost:8080/v1/securityprofile -u sysAdminEmail:pWord

إذا لم يسبق لك ضبط موفِّر هوية خارجي، ستظهر الاستجابة كما هو موضّح أدناه، ما يعني أنّ المصادقة الأساسية مفعَّلة:

<SecurityProfile enabled="true" name="securityprofile">
    <UserAccessControl enabled="true">
    </UserAccessControl>
</SecurityProfile>

إذا سبق لك تفعيل موفِّر هوية خارجي، من المفترض أن يظهر العنصر <ssoserver> في الاستجابة:

<SecurityProfile enabled="true" name="securityprofile">
    <UserAccessControl enabled="true">
        <SSOServer>
            <BasicAuthEnabled>true</BasicAuthEnabled>
            <PublicKeyEndPoint>/token_key</PublicKeyEndPoint>
            <ServerUrl>http://35.197.37.220:9099</ServerUrl>
        </SSOServer>
    </UserAccessControl>
</SecurityProfile>

يُرجى العِلم أنّ الإصدار الذي تم فيه تفعيل موفّر هوية خارجي يعرض أيضًا <BasicAuthEnabled>true</BasicAuthEnabled>، ما يعني أنّ المصادقة الأساسية لا تزال مفعّلة.

إيقاف المصادقة الأساسية

استخدِم طلب بيانات Edge Management API التالي على خادم Edge Management لإيقاف المصادقة الأساسية.

لإيقاف المصادقة الأساسية، عليك تمرير عنصر XML الذي تم عرضه في القسم السابق كحمولة. والفرق الوحيد هو أنّك تضبط <BasicAuthEnabled> على false، كما يوضّح المثال التالي:

curl -H "Content-Type: application/xml"
http://localhost:8080/v1/securityprofile  -u sysAdminEmail:pWord -d
 '<SecurityProfile enabled="true" name="securityprofile">
  <UserAccessControl enabled="true">
    <SSOServer>
      <BasicAuthEnabled>false</BasicAuthEnabled>
      <PublicKeyEndPoint>/token_key</PublicKeyEndPoint>
      <ServerUrl>http://35.197.37.220:9099</ServerUrl>
  </SSOServer>
 </UserAccessControl>
</SecurityProfile>'

بعد إيقاف المصادقة الأساسية، سيؤدي أي طلب بيانات من واجهة برمجة التطبيقات لإدارة Edge يمرّر بيانات اعتماد المصادقة الأساسية إلى عرض الخطأ التالي:

<Error>
    <Code>security.SecurityProfileBasicAuthDisabled</Code>
    <Message>Basic Authentication scheme not allowed</Message>
    <Contexts/>
</Error>

إعادة تفعيل المصادقة الأساسية

إذا كان عليك إعادة تفعيل المصادقة الأساسية لأي سبب، يجب اتّباع الخطوات التالية:

1. سجِّل الدخول إلى أي عقدة Edge ZooKeeper.
2. شغِّل نص bash البرمجي التالي لإيقاف جميع إعدادات الأمان:

   #! /bin/bash
   /opt/apigee/apigee-zookeeper/bin/zkCli.sh -server localhost:2181 <<EOF
   set /system/securityprofile <SecurityProfile></SecurityProfile>
   quit
   EOF

   ستظهر لك النتيجة بالشكل التالي:

   Connecting to localhost:2181
   Welcome to ZooKeeper!
   JLine support is enabled
   WATCHER::
   WatchedEvent state:SyncConnected
   type:None path:null
   [zk: localhost:2181(CONNECTED) 0]
   set /system/securityprofile <SecurityProfile></SecurityProfile>
   cZxid = 0x89
   ...
   [zk: localhost:2181(CONNECTED) 1] quit
   Quitting...

3. أعِد تفعيل المصادقة الأساسية ومصادقة موفِّر الهوية الخارجي:

   curl -H "Content-Type: application/xml" http://localhost:8080/v1/securityprofile
     -u sysAdminEmail:pWord -d '<SecurityProfile enabled="true" name="securityprofile">
     <UserAccessControl enabled="true">
     <SSOServer>
     <BasicAuthEnabled>true</BasicAuthEnabled>
     <PublicKeyEndPoint>/token_key</PublicKeyEndPoint>
     <ServerUrl>http://35.197.37.220:9099</ServerUrl>
     </SSOServer>
     </UserAccessControl>
     </SecurityProfile>'

يمكنك الآن استخدام المصادقة الأساسية مرة أخرى. للتبديل من واجهة مستخدم New Edge من الدخول الموحّد (SSO) إلى المصادقة الأساسية، اضبط AUTH_MODE=basic و MANAGEMENT_UI_SSO_ENABLED=n في ملف إعداد واجهة مستخدم New Edge ، ثم شغِّل /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile متبوعًا بـ /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart (أو شغِّل /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile).