Nonaktifkan Autentikasi dasar di Edge

Setelah mengaktifkan SAML atau LDAP di Edge, Anda dapat menonaktifkan Autentikasi dasar. Namun, sebelum menonaktifkan Autentikasi dasar:

  • Pastikan Anda telah menambahkan semua pengguna Edge, termasuk administrator sistem, ke IDP Anda.
  • Pastikan Anda telah menguji autentikasi IDP secara menyeluruh di UI Edge Baru dan Edge manajemen API.

Melihat profil keamanan saat ini

Anda dapat melihat profil keamanan Edge untuk menentukan konfigurasi saat ini guna mengetahui apakah Autentikasi dasar dan IDP eksternal saat ini diaktifkan. Gunakan panggilan API Edge management berikut di Edge Management Server untuk melihat profil keamanan saat ini yang digunakan oleh Edge:

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

Jika Anda belum mengonfigurasi IDP eksternal, responsnya akan seperti yang ditunjukkan di bawah, yang berarti Autentikasi dasar diaktifkan:

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

Jika Anda telah mengaktifkan IDP eksternal, elemen <ssoserver> akan muncul dalam respons:

<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>

Perhatikan bahwa versi dengan IDP eksternal yang diaktifkan juga menampilkan <BasicAuthEnabled>true</BasicAuthEnabled>, yang berarti Autentikasi dasar masih diaktifkan.

Menonaktifkan Autentikasi dasar

Gunakan panggilan Edge management API berikut di Edge Management Server untuk menonaktifkan Autentikasi dasar.

Untuk menonaktifkan autentikasi dasar, Anda meneruskan objek XML yang ditampilkan di bagian sebelumnya sebagai payload. Satu-satunya perbedaan adalah Anda menetapkan <BasicAuthEnabled> ke false, seperti yang ditunjukkan contoh berikut:

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>'

Setelah Anda menonaktifkan Autentikasi dasar, setiap panggilan Edge management API yang meneruskan kredensial Autentikasi dasar akan menampilkan error berikut:

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

Mengaktifkan kembali Autentikasi dasar

Jika karena alasan tertentu Anda harus mengaktifkan kembali Autentikasi dasar, Anda harus melakukan langkah-langkah berikut ini:

  1. Login ke node Edge ZooKeeper.
  2. Jalankan skrip bash berikut untuk menonaktifkan semua keamanan:
    #! /bin/bash
    /opt/apigee/apigee-zookeeper/bin/zkCli.sh -server localhost:2181 <<EOF
    set /system/securityprofile <SecurityProfile></SecurityProfile>
    quit
    EOF

    Anda akan melihat output dalam bentuk:

    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. Aktifkan kembali Autentikasi dasar dan autentikasi IDP eksternal:
    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>'

Anda kini dapat menggunakan Autentikasi dasar lagi. Untuk mengalihkan UI Edge Baru dari SSO kembali ke Autentikasi dasar, tetapkan AUTH_MODE=basic dan MANAGEMENT_UI_SSO_ENABLED=n di file konfigurasi UI Edge Baru, lalu jalankan /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile diikuti dengan /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart (atau jalankan /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile).