غیرفعال کردن «اصالت‌سنجی پایه» در Edge

پس‌از فعال کردن SAML یا LDAP در Edge، می‌توانید اصالت‌سنجی «پایه» را غیرفعال کنید. بااین‌حال، قبل‌از غیرفعال کردن «اصالت‌سنجی پایه»:

• مطمئن شوید که همه کاربران Edge، ازجمله سرپرستان سیستم، را به IDP خود اضافه کرده‌اید.
• مطمئن شوید که اصالت‌سنجی IDP را به‌طور کامل در Edge UI و Edge management API آزمایش کرده‌اید.
• اگر از درگاه «سرویس‌های توسعه‌دهنده Apigee» (یا به‌طور خلاصه، درگاه) استفاده می‌کنید، IDP خارجی‌تان را در درگاه پیکربندی و آزمایش کنید تا مطمئن شوید درگاه می‌تواند به Edge متصل شود. به پیکربندی درگاه برای ارائه‌دهندگان هویت خارجی مراجعه کنید.

مشاهده نمایه امنیتی فعلی

می‌توانید نمایه امنیتی Edge را مشاهده کنید تا پیکربندی فعلی را تعیین کنید و ببینید آیا «اصالت‌سنجی پایه» و IDP خارجی درحال‌حاضر فعال هستند یا نه. از فراخوانی میانای برنامه‌سازی کاربردی مدیریت Edge زیر در «سرور مدیریت Edge» برای مشاهده نمایه امنیتی فعلی مورداستفاده Edge استفاده کنید:

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

اگر هنوز IDP خارجی را پیکربندی نکرده‌اید، پاسخ به‌صورت زیر نشان داده می‌شود، یعنی اصالت‌سنجی «پایه» فعال است:

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

اگر قبلاً IDP خارجی را فعال کرده‌اید، عنصر <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>

توجه داشته باشید که نسخه با IDP خارجی فعال‌شده نیز <BasicAuthEnabled>true</BasicAuthEnabled> را نشان می‌دهد، که یعنی اصالت‌سنجی «پایه» هنوز فعال است.

غیرفعال کردن اصالت‌سنجی پایه

برای غیرفعال کردن اصالت‌سنجی «پایه»، از فراخوانی Edge management API زیر در Edge Management Server استفاده کنید.

برای غیرفعال کردن اصالت‌سنجی پایه، شیء 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. اصالت‌سنجی «پایه» و اصالت‌سنجی IDP خارجی را دوباره فعال کنید:

   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 فعال باشد، «اصالت‌سنجی پایه» کار نمی‌کند.