全域性 Basic 認證使用者組

目錄結構

|-- global_basic_auth_groups/
  |-- global_basic_auth_groups.yaml
  |-- ...

YAML 檔案中可以包含一個或多個全域性基本認證組。

配置說明

引數名資料型別是否必選描述
namestring全域性基本認證組的名稱,也是該組的唯一標識
labelstring全域性基本認證組的標籤,用於描述該組
usersarray該組中的使用者列表
usernamestring使用者名稱
passwordstring使用者密碼

配置示例

---
- name: hello
  users:
  - username: 'username1'
    password: 'password1'
  - username: 'username2'
    password: 'password2'
  - username: 'username3'
    password: 'password4'
- name: world
  label: 'group 2'
  users:
  - username: 'username1'
    password: 'password1'
  - username: 'username2'
    password: 'password2'
  - username: 'username3'
    password: 'password4'

此配置定義了兩個全域性基本認證組,每個組包含三個使用者。

使用示例

更新配置到 OpenResty Edge 中:

edge-config https://192.168.1.1 -s -t 2051e780-1897-4ea0-92b4-2c2f0169aa94 -l global_basic_auth_groups -i /root/oredge-configs

從 OpenResty Edge 中匯出配置:

edge-config -u https://192.168.1.1 -s -t 2051e780-1897-4ea0-92b4-2c2f0169aa94 -E -l global_basic_auth_groups

示例中均使用 -l global_basic_auth_groups 來指定只匯入/匯出全域性基本認證組相關的配置。

需要注意的是,出於安全考慮,匯出配置時不會匯出實際的密碼資訊。

注意事項

  1. 全域性基本認證組是一個全域性配置,為了保持與多個本地配置的相容性,在更新配置時不會執行刪除操作。

  2. 在匯出配置時,如果未指定匯出使用者資訊,將不會匯出使用者列表,並會顯示警告資訊。

  3. 每個全域性基本認證組必須有一個唯一的名稱。

  4. 匯入配置時,使用者名稱和密碼不能為空字串。

  5. 標籤欄位是可選的,但可以用來為全域性基本認證組新增描述資訊。

  6. 在匯入配置時,工具會先檢查配置的有效性,然後再執行新增或更新操作。

相關文件