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

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

• تأكَّد من إضافة جميع مستخدمي Edge، بما في ذلك مشرفي النظام، إلى IDP.
• تأكَّد من اختبار مصادقة موفِّر الهوية (IdP) بدقة على واجهة مستخدم Edge وواجهة برمجة تطبيقات Management API.
• إذا كنت تستخدم بوابة خدمات مطوّري برامج Apigee (أو ببساطة، البوابة)، يمكنك ضبط موفِّر الهوية الخارجي واختباره على البوابة لضمان إمكانية اتصال البوابة بـ 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.