Quản lý người dùng, vai trò và quyền

Edge cho Private Cloud phiên bản 4.17.01

Trang web tài liệu về Apigee có nhiều thông tin về cách quản lý vai trò của người dùng và quyền truy cập. Có thể quản lý người dùng bằng cả giao diện người dùng Edge và API Quản lý; vai trò và bạn chỉ có thể quản lý quyền bằng API Quản lý.

Để biết thông tin về người dùng và cách tạo người dùng, hãy xem:

Nhiều thao tác mà bạn thực hiện để quản lý người dùng yêu cầu quản trị viên hệ thống đặc quyền. Trong quá trình cài đặt Edge trên đám mây, Apigee hoạt động với vai trò hệ thống Google Cloud. Trong một Edge để cài đặt Đám mây riêng tư, quản trị viên hệ thống của bạn phải thực hiện các tác vụ này như được mô tả dưới đây.

Thêm người dùng

Bạn có thể tạo người dùng bằng cách sử dụng API Edge, Giao diện người dùng Edge hoặc các lệnh của Edge. Chiến dịch này mô tả cách sử dụng API Edge và các lệnh của Edge. Để biết thông tin về cách tạo người dùng trong Giao diện người dùng Edge, hãy xem phần Tạo người dùng trên toàn cầu.

Sau khi tạo người dùng trong tổ chức, bạn phải chỉ định vai trò cho người dùng đó. Vai trò xác định quyền truy cập của người dùng trên Edge.

Sử dụng lệnh sau để tạo người dùng bằng API Edge:

curl -H "Content-Type:application/xml" -u <sysAdminEmail>:<passwd> \
-X POST http://<ms_IP>:8080/v1/users \
-d '<User> \
   <FirstName>New</FirstName> \
   <LastName>User</LastName> \
   <Password>newUserPWord</Password> \
   <EmailId>foo@bar.com</EmailId> \
</User>'

Bạn cũng có thể sử dụng lệnh Edge sau đây để tạo người dùng:

> /opt/apigee/apigee-service/bin/apigee-service apigee-provision create-user -f configFile

Trong đó configFile chứa thông tin cần thiết để tạo người dùng:

APIGEE_ADMINPW=sysAdminPW    # If omitted, you will be prompted.
USER_NAME=foo@bar.com
FIRST_NAME=New
LAST_NAME=User
USER_PWD="newUserPWord"
ORG_NAME=myorg  

Sau đó, bạn có thể sử dụng lệnh gọi này để xem thông tin về người dùng:

curl -u <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/users/foo@bar.com

Chỉ định người dùng cho một vai trò trong tổ chức

Trước khi người dùng mới có thể làm bất cứ việc gì, họ phải được chỉ định cho một vai trò trong tổ chức. Bạn có thể chỉ định người dùng cho các vai trò khác nhau, bao gồm: quản trị viên tổ chức, người dùng doanh nghiệp, quản trị viên hoạt động, người dùng hoặc cho vai trò tuỳ chỉnh được xác định trong tổ chức.

Việc chỉ định một người dùng cho một vai trò trong tổ chức sẽ tự động thêm người dùng đó vào tổ chức. Chỉ định một người dùng cho nhiều tổ chức bằng cách chỉ định vai trò cho họ trong mỗi tổ chức tổ chức.

Sử dụng lệnh sau để chỉ định người dùng vào một vai trò trong tổ chức:

curl -X POST -H "Content-Type:application/x-www-form-urlencoded" /
http://<ms_IP>:8080/v1/o/<org_name>/userroles/<role>/users?id=foo@bar.com /
-u <sysAdminEmail>:<passwd> 

Lệnh gọi này sẽ hiển thị tất cả vai trò đã chỉ định cho người dùng. Nếu bạn muốn thêm người dùng đó, nhưng chỉ hiển thị vai trò mới, hãy sử dụng lệnh gọi sau:

curl -X POST -H "Content-Type: application/xml" /
http://<ms_IP>:8080/v1/o/<org_name>/users/foo@bar.com/userroles /
-d '<Roles><Role name="role"/></Roles>' /
-u <sysAdminEmail>:<passwd>

Bạn có thể xem vai trò của người dùng bằng cách sử dụng lệnh sau:

curl -u <sysAdminEmail>:<passwd> /
http://<ms_IP>:8080/v1/users/foo@bar.com/userroles

Để xóa người dùng khỏi tổ chức, hãy xóa tất cả vai trò trong tổ chức đó khỏi người dùng. Bạn có thể dùng lệnh sau để xoá vai trò khỏi người dùng:

curl -X DELETE -u <sysAdminEmail>:<passwd> http://<ms_IP>:8080/v1/o/<org_name>/userroles/<role>/users/foo@bar.com

Thêm quản trị viên hệ thống

Quản trị viên hệ thống có thể:

  • Tạo tổ chức
  • Thêm Bộ định tuyến, Bộ xử lý thư và các thành phần khác vào bản cài đặt Edge
  • Định cấu hình TLS/SSL
  • Tạo thêm quản trị viên hệ thống
  • Thực hiện tất cả các thao tác quản trị trên Edge

Mặc dù chỉ có một người dùng là người dùng mặc định cho các tác vụ quản trị, nhưng có thể có nhiều hơn một quản trị viên hệ thống. Bất kỳ người dùng nào là thành viên của vai trò sysadmin đều có toàn quyền đối với tất cả của chúng tôi.

Bạn có thể tạo người dùng cho quản trị viên hệ thống trong API hoặc giao diện người dùng của Edge. Tuy nhiên, bạn phải sử dụng API Edge để chỉ định cho người dùng vai trò sysadmin. Chỉ định một người dùng cho Không thể thực hiện vai trò sysadmin (quản trị viên hệ thống) trong giao diện người dùng Edge.

Cách thêm quản trị viên hệ thống:

  1. Tạo người dùng trong API hoặc giao diện người dùng Edge.
  2. Thêm người dùng vào sysadmin vai trò:
    cong-đặn &lt;sysAdminEmail&gt;:&lt;passwd&gt;
    -X POST http://<ms_IP>:8080/v1/userroles/sysadmin/users \
    -d "id=foo@bar.com"
  3. Đảm bảo người dùng mới có vai trò quản trị viên hệ thống:
    curl -u &lt;sysAdminEmail&gt;:&lt;passwd&gt; http://&lt;ms_IP&gt;:8080/v1/userroles/sysadmin/users

    Trả về địa chỉ email của người dùng:
    [ " foo@bar.com " ]
  4. Kiểm tra quyền của người dùng mới:
    curl -u &lt;sysAdminEmail&gt;:&lt;passwd&gt; http://&lt;ms_IP&gt;:8080/v1/users/foo@bar.com/permissions

    Trường hợp trả lại hàng:
    {
    "resourcePermission" : [ {
    "đường dẫn" : "/",
    "quyền" : [ "get", "put", "delete" ]
    } ]
    }
  5. Sau khi thêm quản trị viên hệ thống mới, bạn có thể thêm người dùng vào bất kỳ tổ chức nào.
    Lưu ý: Người dùng quản trị viên hệ thống mới không thể đăng nhập vào giao diện người dùng Edge cho đến khi bạn thêm người dùng vào ít nhất một tổ chức.
  6. Nếu sau đó muốn xóa người dùng khỏi vai trò quản trị viên hệ thống, bạn có thể sử dụng API sau đây:
    curl -X XOÁ -u &lt;sysadminEmail:pword&gt;
    http://&lt;ms_IP&gt;:8080/v1/userroles/sysadmin/users/foo@bar.com


    Xin lưu ý rằng lệnh gọi này chỉ xoá người dùng khỏi vai trò chứ không xoá người dùng.

Thay đổi quản trị viên hệ thống mặc định người dùng

Khi cài đặt Edge, bạn sẽ chỉ định địa chỉ email của quản trị viên hệ thống. Cạnh sẽ tạo người dùng bằng địa chỉ email đó và đặt người dùng đó làm hệ thống mặc định Google Cloud. Sau này, bạn có thể thêm quản trị viên hệ thống khác như mô tả ở trên.

Phần này mô tả cách thay đổi quản trị viên hệ thống mặc định thành một người dùng khác, và cách thay đổi địa chỉ email của tài khoản người dùng cho hệ thống mặc định hiện tại Google Cloud.

Để xem danh sách người dùng hiện được định cấu hình là quản trị viên hệ thống, hãy sử dụng API sau gọi điện:

curl -u sysAdminEmail:passwd http://<ms_IP>:8080/v1/userroles/sysadmin/users

Để xác định quản trị viên hệ thống mặc định hiện tại, hãy xem tệp /opt/apigee/customer/defaults.sh. Chiến lược phát hành đĩa đơn tệp chứa dòng sau cho biết địa chỉ email của hệ thống mặc định hiện tại quản trị viên:

ADMIN_EMAIL=foo@bar.com

Cách thay đổi quản trị viên hệ thống mặc định thành một người dùng khác:

  1. Tạo quản trị viên hệ thống mới như được mô tả ở trên hoặc đảm bảo rằng tài khoản người dùng của quản trị viên hệ thống mới đã được định cấu hình làm quản trị viên hệ thống.
  2. Chỉnh sửa /opt/apigee/customer/defaults.sh thành đặt ADMIN_EMAIL thành địa chỉ email của quản trị viên hệ thống mới.
  3. Chỉnh sửa tệp cấu hình im lặng mà bạn đã sử dụng để cài đặt giao diện người dùng Edge để thiết lập các thông tin sau thuộc tính:
    ADMIN_EMAIL=emailAddressOfNewSysAdmin
    APIGEE_ADMINPW=pwOfNewSysAdmin

    SMTPHOST=smtp.gmail.com
    SMTPPORT=465
    SMTPUSER=foo@gmail.com
    SMTPPASSWORD=bar
    SMTPSSL=y
    Lưu ý bạn phải thêm các thuộc tính SMTP vì tất cả các thuộc tính trên giao diện người dùng đã đặt lại.
  4. Định cấu hình lại giao diện người dùng Edge:
    &gt; /opt/apigee/apigee-service/bin/apigee-service dừng Edge-ui
    &gt; /opt/apigee/apigee-service/bin/apigee-service cạnh-ui thiết lập -f configFile
    &gt; /opt/apigee/apigee-service/bin/apigee-service cạnh-ui bắt đầu

Nếu bạn chỉ muốn thay đổi địa chỉ email của tài khoản người dùng cho địa chỉ email mặc định hiện tại quản trị viên hệ thống, trước tiên, bạn cần cập nhật tài khoản người dùng để đặt địa chỉ email mới, sau đó thay đổi địa chỉ email mặc định của quản trị viên hệ thống:

  1. Cập nhật email mới cho tài khoản người dùng của người dùng quản trị viên hệ thống mặc định hiện tại địa chỉ:
    &gt; cuộn tròn – H content-type:application/json -X PUT /
    -u currentSysAdminEmail:passwd /
    http://<ms_IP>:8080/v1/users/currentSysAdminEmail /
    -d &#39;{&quot;emailId&quot;: &quot;newSysAdminEmail&quot;, &quot;lastName&quot;: &quot;admin&quot;, &quot;firstName&quot;: "admin"}'
  2. Lặp lại các bước 2, 3. và 4 từ quy trình trước để cập nhật tệp /opt/apigee/customer/defaults.sh và cập nhật giao diện người dùng Edge.

Chỉ định miền email của hệ thống quản trị viên

Để tăng cường bảo mật, bạn có thể chỉ định miền email bắt buộc của hệ thống Edge Google Cloud. Khi thêm quản trị viên hệ thống, nếu địa chỉ email của người dùng không có trong miền đã chỉ định, thì sẽ không thêm được người dùng vào vai trò sysadmin (quản trị viên hệ thống).

Theo mặc định, miền bắt buộc trống, nghĩa là bạn có thể thêm bất kỳ địa chỉ email nào vào sysadmin (quản trị viên hệ thống).

Cách đặt miền email:

  1. Mở trong trình chỉnh sửa management-server.properties:
    vi /opt/apigee/customer/application/management-server.properties

    Nếu tệp này không tồn tại, hãy tạo tệp.
  2. Đặt conf_security_rbac.global.roles.allowed.domains vào danh sách các miền được phép được phân tách bằng dấu phẩy. Ví dụ:
    conf_security_rbac.global.roles.allowed.domains=myCo.com,yourCo.com
  3. Lưu các thay đổi.
  4. Khởi động lại Máy chủ quản lý Edge:
    /opt/apigee/apigee-service/bin/apigee-service khởi động lại máy chủ quản lý cạnh

    Nếu bây giờ bạn cố gắng thêm người dùng vào vai trò quản trị viên hệ thống và địa chỉ email của người dùng đó không ở một trong các miền được chỉ định thì không thêm được.

Xoá người dùng

Bạn có thể tạo một người dùng bằng cách sử dụng API Edge hoặc giao diện người dùng Edge. Tuy nhiên, bạn chỉ có thể xoá người dùng bằng cách sử dụng API.

Để xem danh sách người dùng hiện tại, bao gồm cả địa chỉ email, hãy sử dụng lệnh cURL sau:

curl -u <sysAdminEmail>:<passwd> http://<ms-IP>:8080/v1/users

Dùng lệnh cURL sau để xoá một người dùng:

curl -u <sysAdminEmail>:<passwd> -X DELETE http://<ms-IP>:8080/v1/users/<userEmail>