Tắt xác thực cơ bản trên Edge

Edge cho đám mây riêng tư phiên bản 4.18.01

Sau khi bật SAML trên Edge, bạn có thể tắt tính năng Xác thực cơ bản. Tuy nhiên, trước khi bạn tắt tính năng Xác thực cơ bản:

  • Đảm bảo rằng bạn đã thêm tất cả người dùng Edge, bao gồm cả quản trị viên hệ thống, vào SAML IDP.
  • Đảm bảo bạn đã kiểm thử kỹ lưỡng quy trình xác thực SAML trên giao diện người dùng Edge và API quản lý Edge.
  • Nếu bạn cũng đang sử dụng API BaaS, hãy định cấu hình và kiểm thử SAML trên API BaaS. Xem bài viết Bật SAML cho API BaaS.
  • Nếu bạn đang sử dụng cổng Dịch vụ cho nhà phát triển, hãy định cấu hình và kiểm thử SAML trên cổng đó để đảm bảo rằng cổng đó có thể kết nối với Edge. Xem bài viết Định cấu hình cổng thông tin Dịch vụ dành cho nhà phát triển để sử dụng SAML nhằm giao tiếp với Edge.

Xem hồ sơ bảo mật hiện tại

Bạn có thể xem hồ sơ bảo mật của Edge để xác định cấu hình hiện tại nhằm biết liệu Basic Auth và SAML có đang được bật hay không. Sử dụng lệnh gọi API quản lý Edge sau đây trên Máy chủ quản lý Edge để xem hồ sơ bảo mật hiện tại mà Edge sử dụng:

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

Nếu bạn chưa định cấu hình SAML, thì phản hồi sẽ như bên dưới, tức là tính năng Xác thực cơ bản đang bật:

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

Nếu đã bật SAML, bạn sẽ thấy thẻ <ssoserver> trong kết quả:

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

Lưu ý rằng phiên bản đã bật SAML cũng cho thấy <BasicAuthEnabled>true</BasicAuthEnabled>, nghĩa là Basic Auth vẫn được bật.

Tắt tính năng Xác thực cơ bản

Sử dụng lệnh gọi API quản lý Edge sau đây trên Máy chủ quản lý Edge để tắt tính năng Xác thực cơ bản. Lưu ý rằng bạn truyền đối tượng XML được trả về trong phần trước dưới dạng tải trọng. Điểm khác biệt duy nhất là bạn đặt <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>'

Sau khi bạn tắt tính năng Xác thực cơ bản, mọi lệnh gọi API quản lý Edge truyền thông tin xác thực Xác thực cơ bản sẽ trả về lỗi sau:

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

Bật lại phương thức xác thực cơ bản

Nếu vì lý do nào đó mà bạn phải bật lại phương thức Xác thực cơ bản, thì bạn phải thực hiện các bước sau:

Thận trọng: Trong quá trình bật lại tính năng Xác thực cơ bản, bạn phải tạm thời tắt tất cả phương thức xác thực trên Edge, bao gồm cả SAML.

  1. Đăng nhập vào bất kỳ nút ZooKeeper nào của Edge.
  2. Chạy tập lệnh bash sau để tắt tất cả tính năng bảo mật:
    Thận trọng: Bước này sẽ tắt tất cả tính năng xác thực trên Edge, bao gồm cả SAML.

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

    Bạn sẽ thấy kết quả ở dạng:
    Connecting to localhost:2181
    Welcome to ZooKeeper!
    Đã bật tính năng hỗ trợ JLine
    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. Bật lại phương thức xác thực cơ bản và phương thức xác thực 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>'

    Giờ đây, bạn có thể sử dụng lại phương thức Xác thực cơ bản.