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

Edge for Private Cloud الإصدار 4.19.01

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

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

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

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

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

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

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

إذا سبق لك تفعيل SAML، ستظهر لك العلامة <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>

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

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

استخدِم طلب بيانات من واجهة برمجة التطبيقات لإدارة Edge التالي على خادم إدارة Edge لإيقاف المصادقة الأساسية. يُرجى العِلم أنّه يتم تمرير كائن XML الذي تم عرضه في القسم السابق كحمولة. الفرق الوحيد هو ضبط <BasicAuthEnabled>false</BasicAuthEnabled>:

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. أعِد تفعيل المصادقة الأساسية ومصادقة SAML:
    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>'

    يمكنك الآن استخدام المصادقة الأساسية مرة أخرى.