Модуль dellemc.enterprise_sonic.sonic_radius_server — управление сервером RADIUS и его параметрами

Примечание

Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 3.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install dellemc.enterprise_sonic.

Чтобы использовать её в плейбуке, укажите: dellemc.enterprise_sonic.sonic_radius_server.

Добавлено в dellemc.enterprise_sonic 1.0.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль обеспечивает управление конфигурацией параметров сервера RADIUS на устройствах под управлением Enterprise SONiC.

Параметры

Параметр	Комментарии
config dictionary	Задаёт конфигурацию, связанную с сервером RADIUS.
auth_type string	Задаёт тип аутентификации сервера RADIUS. Варианты: `"pap"` ← (по умолчанию) `"chap"` `"mschapv2"`
key string	Задаёт ключ сервера RADIUS.
nas_ip string	Задаёт сервер сетевого доступа для сервера RADIUS.
retransmit integer	Задаёт значение повторной передачи для сервера RADIUS.
servers dictionary	Задаёт список серверов RADIUS.
host list / elements=dictionary	Задаёт сведения об узлах в списке серверов RADIUS.
auth_type string	Задаёт тип аутентификации узла сервера RADIUS. Варианты: `"pap"` `"chap"` `"mschapv2"`
key string	Задаёт ключ узла сервера RADIUS.
name string	Задаёт IP-адрес или имя узла сервера RADIUS.
port integer	Задаёт порт узла сервера RADIUS. По умолчанию: `1812`
priority integer	Задаёт приоритет узла сервера RADIUS.
retransmit integer	Задаёт параметр повторной передачи узла сервера RADIUS.
source_interface string	Задаёт исходный интерфейс узла сервера RADIUS.
timeout integer	Задаёт время ожидания ответа узла сервера RADIUS.
vrf string	Задаёт VRF узла сервера RADIUS.
statistics boolean	Задаёт флаг сбора статистики для сервера RADIUS. Варианты: `false` `true`
timeout integer	Задаёт время ожидания ответа сервера RADIUS. По умолчанию: `5`
state string	Задаёт операцию, выполняемую над сервером RADIUS, настроенным на устройстве. При значении merged конфигурация режима из входных данных объединяется с существующей конфигурацией сервера RADIUS на устройстве. При значении deleted существующая конфигурация режима сервера RADIUS удаляется с устройства. При значении replaced существующая конфигурация сервера RADIUS заменяется предоставленной конфигурацией. При значении overridden существующая конфигурация сервера RADIUS перезаписывается предоставленной конфигурацией. Варианты: `"merged"` ← (по умолчанию) `"replaced"` `"overridden"` `"deleted"`

Примечания

Примечание

Протестировано с Enterprise SONiC Distribution от Dell Technologies.
Поддерживает check_mode.

Примеры

# Using "deleted" state
#
# Before state:
# -------------
#
# sonic(config)# do show radius-server
# ---------------------------------------------------------
# RADIUS Global Configuration
# ---------------------------------------------------------
# nas-ip-addr: 1.2.3.4
# statistics : True
# timeout    : 10
# auth-type  : chap
# key        : chap
# retransmit : 3
# --------------------------------------------------------------------------------
# HOST            AUTH-TYPE KEY       AUTH-PORT PRIORITY TIMEOUT RTSMT VRF   SI
# --------------------------------------------------------------------------------
# hostx.local     mschapv2  local     52        2        20      2     mgmt  Ethernet12
# myhost.dell     chap      local     53        3        23      3     mgmt  Ethernet24
# ---------------------------------------------------------
# RADIUS Statistics
# ---------------------------------------------------------
#

- name: Merge radius configurations
  dellemc.enterprise_sonic.sonic_radius_server:
    config:
      auth_type: chap
      nas_ip: 1.2.3.4
      statistics: true
      timeout: 10
      servers:
        host:
          - name: hostx.local
    state: deleted

# After state:
# ------------
# sonic(config)# do show radius-server
# ---------------------------------------------------------
# RADIUS Global Configuration
# ---------------------------------------------------------
# timeout    : 5
# auth-type  : pap
# key        : chap
# retransmit : 3
# --------------------------------------------------------------------------------
# HOST            AUTH-TYPE KEY       AUTH-PORT PRIORITY TIMEOUT RTSMT VRF   SI
# --------------------------------------------------------------------------------
# myhost.dell     chap      local     53        3        23      3     mgmt  Ethernet24


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic(config)# do show radius-server
# ---------------------------------------------------------
# RADIUS Global Configuration
# ---------------------------------------------------------
# nas-ip-addr: 1.2.3.4
# statistics : True
# timeout    : 10
# auth-type  : chap
# key        : chap
# retransmit : 3
# --------------------------------------------------------------------------------
# HOST            AUTH-TYPE KEY       AUTH-PORT PRIORITY TIMEOUT RTSMT VRF   SI
# --------------------------------------------------------------------------------
# hostx.local     mschapv2  local     52        2        20      2     mgmt  Ethernet12
# myhost.dell     chap      local     53        3        23      3     mgmt  Ethernet24
# ---------------------------------------------------------
# RADIUS Statistics
# ---------------------------------------------------------
#
- name: Merge radius configurations
  dellemc.enterprise_sonic.sonic_radius_server:
    config:
    state: deleted

# After state:
# ------------
# sonic(config)# do show radius-server
# ---------------------------------------------------------
# RADIUS Global Configuration
# ---------------------------------------------------------
# timeout    : 5
# auth-type  : pap


# Using "merged" state
#
# Before state:
# -------------
#
# sonic(config)# do show radius-server
# ---------------------------------------------------------
# RADIUS Global Configuration
# ---------------------------------------------------------
#
- name: Merge radius configurations
  dellemc.enterprise_sonic.sonic_radius_server:
    config:
      auth_type: chap
      key: chap
      nas_ip: 1.2.3.4
      statistics: true
      timeout: 10
      retransmit: 3
      servers:
        host:
          - name: hostx.local
            auth_type: mschapv2
            key: local
            priority: 2
            port: 52
            retransmit: 2
            timeout: 20
            source_interface: Eth 12
            vrf: mgmt
    state: merged

# After state:
# ------------
#
# sonic(config)# do show radius-server
# ---------------------------------------------------------
# RADIUS Global Configuration
# ---------------------------------------------------------
# nas-ip-addr: 1.2.3.4
# statistics : True
# timeout    : 10
# auth-type  : chap
# key        : chap
# retransmit : 3
# --------------------------------------------------------------------------------
# HOST            AUTH-TYPE KEY       AUTH-PORT PRIORITY TIMEOUT RTSMT VRF   SI
# --------------------------------------------------------------------------------
# hostx.local     mschapv2  local     52        2        20      2     mgmt  Ethernet12
# ---------------------------------------------------------
# RADIUS Statistics
# ---------------------------------------------------------
#
# Using "replaced" state
#
# Before state:
# -------------
#
# sonic(config)# do show radius-server
# ---------------------------------------------------------
# RADIUS Global Configuration
# ---------------------------------------------------------
# timeout           : 10
# auth-type         : pap
# key configured    : Yes
# --------------------------------------------------------------------------------------
# HOST        AUTH-TYPE KEY-CONFIG AUTH-PORT PRIORITY TIMEOUT RTSMT VRF     SI
# --------------------------------------------------------------------------------------
# 1.2.3.4     pap       No         49        1         5      -     -       Ethernet0
#
- name: Replace radius configurations
  sonic_radius_server:
    config:
      auth_type: mschapv2
      timeout: 20
      servers:
        - host:
            name: 1.2.3.4
            auth_type: mschapv2
            key: mschapv2
            source_interface: Ethernet12
    state: replaced
#
# After state:
# ------------
#
# sonic(config)# do show radius-server
# ---------------------------------------------------------
# RADIUS Global Configuration
# ---------------------------------------------------------
# timeout           : 20
# auth-type         : mschapv2
# key configured    : No
# --------------------------------------------------------------------------------------
# HOST        AUTH-TYPE KEY-CONFIG AUTH-PORT PRIORITY TIMEOUT RTSMT VRF     SI
# --------------------------------------------------------------------------------------
# 1.2.3.4      mschapv2 Yes        1812       -          -    -     -       Ethernet12
#
# Using "overridden" state
#
# Before state:
# -------------
#
# sonic(config)# do show radius-server
# ---------------------------------------------------------
# RADIUS Global Configuration
# ---------------------------------------------------------
# timeout           : 10
# auth-type         : pap
# key configured    : Yes
# --------------------------------------------------------------------------------------
# HOST        AUTH-TYPE KEY-CONFIG AUTH-PORT PRIORITY TIMEOUT RTSMT VRF     SI
# --------------------------------------------------------------------------------------
# 1.2.3.4     pap       No         49        1         5      -     -       Ethernet0
# 11.12.13.14 chap      Yes        49        10        5      3     -       -
#
- name: Override radius configurations
  sonic_radius_server:
    config:
      auth_type: mschapv2
      key: mschapv2
      timeout: 20
      servers:
        - host:
            name: 1.2.3.4
            auth_type: mschapv2
            key: mschapv2
            source_interface: Ethernet12
        - host:
            name: 10.10.11.12
            auth_type: chap
            timeout: 30
            priority: 2
            port: 49
    state: overridden
#
# After state:
# ------------
#
# sonic(config)# do show radius-server
# ---------------------------------------------------------
# RADIUS Global Configuration
# ---------------------------------------------------------
# timeout           : 20
# auth-type         : mschapv2
# key configured    : Yes
# --------------------------------------------------------------------------------------
# HOST        AUTH-TYPE KEY-CONFIG AUTH-PORT PRIORITY TIMEOUT RTSMT VRF     SI
# --------------------------------------------------------------------------------------
# 1.2.3.4      mschapv2 Yes        1812       -          -    -     -       Ethernet12
# 10.10.11.12  chap     No         49         2          30   -     -       -
#

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
after list / elements=string	Итоговая конфигурация после вызова модуля. Возвращается: если были изменения Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
before list / elements=string	Конфигурация до вызова модуля. Возвращается: всегда Пример: `["The configuration returned will always be in the same format as the parameters above.\n"]`
commands list / elements=string	Список команд, отправленных на удалённое устройство. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

Niraimadaiselvam M (@niraimadaiselvamm)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/enterprise_sonic/sonic_radius_server_module.html