cisco.dnac.user_role_workflow_manager 模块 – 用于管理 Cisco Catalyst Center 中用户和角色的资源模块。
注意
此模块是 cisco.dnac 集合 (版本 6.25.0) 的一部分。
如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查是否已安装它，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install cisco.dnac。您需要其他要求才能使用此模块，请参阅 要求 获取详细信息。
要在剧本中使用它，请指定：cisco.dnac.user_role_workflow_manager。
cisco.dnac 6.17.0 中的新增功能
概要
管理在 Cisco Catalyst Center 中创建、更新和删除用户和角色的操作。
提供用于创建、更新和删除用户和角色的 API。
要求
执行此模块的主机需要以下要求。
dnacentersdk >= 2.7.2
python >= 3.9.19
参数
参数 |
注释 |
|---|---|
包含用户或角色配置详细信息的字典。 |
|
管理角色的配置详细信息。 |
|
确保通过对网络所有方面的全面可见性来保持一致的服务水平。 选项
|
|
监控和管理网络健康状况，排除故障并执行补救。 包括主动网络监控和 AI 驱动的洞察。 选项
|
|
配置和管理网络、客户端和应用程序的健康阈值。 至少需要“读取”监控和故障排除权限。 选项
|
|
为所有子参数设置相同的访问级别。 选项
|
|
创建和管理传感器测试。 安排按需进行的取证数据包捕获（智能捕获）以排除客户端故障。 至少需要“读取”监控和故障排除权限。 选项
|
|
角色目的和范围的简要说明。 |
|
管理与网络分析相关的组件。 |
|
启用访问查询引擎 API。 管理诸如全局搜索、Rogue 管理和 aWIPS 之类的功能。 将其设置为“拒绝”会影响搜索和保证功能。 选项
|
|
为所有子参数设置相同的访问级别。 选项
|
|
设置网络层次结构，更新软件镜像存储库，并配置用于管理站点和网络设备的网络配置文件和设置。 |
|
更新网络设置，包括全局设备凭据、身份验证和策略服务器、证书、信任池、云访问密钥、Stealthwatch、Umbrella 和数据匿名化。 导出设备清单及其凭据。 至少需要网络设置的“读取”权限。 选项
|
|
管理软件镜像，并促进物理和虚拟网络实体的升级和更新 选项
|
|
根据地理位置定义和创建站点、建筑物、楼层和区域的网络层次结构。 |
|
为路由、交换和无线创建网络配置文件。将配置文件分配给站点。 包括模板编辑器、标记、模型配置编辑器和身份验证模板等角色。 要创建SSID，“写入”网络设置权限是必需的。 选项
|
|
管理常见的站点范围网络设置，例如AAA、NTP、DHCP、DNS、Syslog、SNMP和遥测。 此角色中的用户可以添加SFTP服务器并调整在系统>设置下找到的网络重新同步间隔。 要创建无线配置文件，需要“写入”网络配置文件权限。 选项
|
|
为所有子参数设置相同的访问级别。 选项
|
|
管理虚拟网络 (VN)。将物理网络分割成多个逻辑网络，以实现流量隔离和受控的 VN 间通信。 选项
|
|
配置、升级、预配和管理网络设备。 |
|
管理合规性预配。 选项
|
|
扫描网络以查找硬件和软件的报废、停售或停止支持信息。 选项
|
|
在完整升级生命周期后，升级与黄金镜像设置不匹配的设备上的软件镜像。 选项
|
|
在管理设备属性和配置属性的同时，发现、添加、替换或删除设备。 要替换设备，需要在网络配置下对 pnp 具有“写入”权限。 |
|
显示设备的运行配置。 选项
|
|
发现网络上的新设备。 选项
|
|
从库存中添加设备，查看设备详细信息并执行设备级操作。 选项
|
|
为所有子参数提供相同的选项。 选项
|
|
允许对设备执行端口操作。 选项
|
|
显示网络设备和链路连接。 管理设备角色，标记设备，自定义显示并保存自定义拓扑布局。 要查看 SD-Access Fabric 窗口，至少需要对“网络配置 > 库存管理 > 拓扑”具有“读取”权限。 选项
|
|
统一查看与许可证使用和合规性相关的软件和网络资产。 还控制 cisco.com 和 Smart 帐户的权限。 选项
|
|
启用或禁用从设备收集应用程序遥测数据。 配置分配站点的遥测设置。 配置其他设置，例如无线服务保障和控制器证书。 要启用或禁用网络遥测，需要对“配置”具有“写入”权限。 选项
|
|
为所有子参数提供相同的选项。 选项
|
|
自动加入新设备，将其分配到站点，并使用特定于站点的设置对其进行配置。 选项
|
|
使用特定于站点的设置和网络策略配置设备。 包括 Fabric、应用程序策略、应用程序可见性、云、站点到站点 VPN、网络/应用程序遥测、Stealthwatch、同步启动与运行配置以及 Umbrella 配置等角色。 在异常设备和 aWIPS 的主仪表板上，可以启用或禁用某些操作，包括异常设备遏制。 要配置设备，需要对“网络设计”和“网络配置”具有“写入”权限。 选项
|
|
配置网络上超越基本网络连接和访问的附加功能。 默认值： |
|
部署、管理和监控在网络设备上运行的虚拟化和基于容器的应用程序。 选项
|
|
启用广域 Bonjour 服务以促进跨网络的基于策略的服务发现。 选项
|
|
为所有子参数提供相同的选项。 选项
|
|
配置网络元素以将数据发送到 Cisco Stealthwatch 以进行威胁检测和缓解，包括加密流量。 要配置 Stealthwatch，需要对以下组件具有“写入”权限。 网络设计 > 网络设置。 网络配置 > 配置。 网络服务 > Stealthwatch。 网络设计 > 高级设置。 选项
|
|
配置网络元素以使用 Cisco Umbrella 作为抵御网络安全威胁的第一道防线。 要配置 Umbrella，需要对以下组件具有“写入”权限。 网络设计 > 网络设置。 网络配置 > 配置。 网络配置 > 调度程序。 网络服务 > Umbrella。 选项
|
|
用于访问、基于意图的工作流、数据交换、通知和第三方应用程序集成的开放平台。 默认值： |
|
通过 REST API 访问 Cisco Catalyst Center 以提升价值。 选项
|
|
通过配置和激活为 ITSM 集成预配置的捆绑包来提高生产力。 选项
|
|
订阅对感兴趣的网络和系统事件的近乎实时的通知。 在“系统 > 设置 > 目标”中配置电子邮件和 syslog 日志。 选项
|
|
为所有子参数提供相同的选项。 选项
|
|
使用预定义模板为网络的所有方面生成报表。 为异常设备和 aWIPS 生成报表。 在“系统 > 设置 > 目标”中配置 Webhook。 选项
|
|
要管理的角色的名称。 |
|
管理和控制对网络的安全访问。 默认值： |
|
管理基于组的网络策略，这些策略根据 Cisco 安全组标签执行分段和访问控制。 此角色包括终端分析。 选项
|
|
管理基于 IP 的访问控制列表，这些列表根据 IP 地址执行网络分段。 选项
|
|
为所有子参数提供相同的选项。 选项
|
|
扫描网络以查找安全建议。查看并了解已发布的 Cisco 安全建议的影响。 选项
|
|
Cisco Catalyst Center 的集中式管理，包括配置管理、网络连接、软件升级等等。 默认值： |
|
配置对机器推理知识库的自动更新，以快速识别安全漏洞并改进自动问题分析。 选项
|
|
为所有子参数提供相同的选项。 选项
|
|
管理核心系统功能和连接设置、用户角色和外部身份验证。 此角色包括 Cisco 凭据、完整性验证、设备最终用户许可协议 (EULA)、高可用性 (HA)、集成设置、灾难恢复、调试日志、遥测收集、系统最终用户许可协议 (EULA)、IPAM、vManage 服务器、Cisco AI 分析、备份和还原以及数据平台。 选项
|
|
最常用的故障排除工具和服务的“一站式”生产力资源。 |
|
通过 UI 或 API 接口对网络设备或 Cisco Catalyst Center 所做更改的详细日志。 选项
|
|
查看网络设备和客户端事件以进行故障排除。 选项
|
|
允许 Cisco 支持团队远程排除 Cisco Catalyst Center 管理的网络设备的故障。 使 Cisco 技术支持中心 (TAC) 的工程师能够远程连接到客户的 Cisco Catalyst Center 设置以进行故障排除。 选项
|
|
为所有子参数提供相同的选项。 选项
|
|
允许 Cisco 支持团队远程排除 Cisco Catalyst Center 管理的任何网络设备的故障。 选项
|
|
运行、调度和监控网络任务和活动，例如部署策略、配置或升级网络，并与其他后端服务集成。 选项
|
|
搜索 Cisco Catalyst Center 中的各种对象，包括站点、网络设备、客户端、应用程序、策略、设置、标签、菜单项等等。 选项
|
|
管理用户帐户的配置详细信息。 |
|
用户的姓名。 |
|
用户的姓氏。 |
|
用户帐户的密码，必须符合指定的复杂性要求。 必须至少包含一个特殊字符、一个大写字母、一个小写字母，并且最小长度为 8 个字符。 创建新用户帐户时需要。 |
|
指示是否应更新密码。 设置为 `true` 以触发密码更新。 如果需要更改密码，则需要；必须明确设置为 `true` 才能启动更新过程。 如果不需要更新，则省略此参数或将其设置为 `false`。 确保此参数正确设置，以避免不必要的更新或错误。 |
|
要分配给用户的角色名称列表。如果未指定角色，则默认角色将为“OBSERVER-ROLE”。 角色名称必须与 Cisco Catalyst Center 中定义的角色名称匹配。 Cisco Catalyst Center 中存在的默认角色为“SUPER-ADMIN-ROLE”、“NETWORK-ADMIN-ROLE”、“OBSERVER-ROLE”。 SUPER-ADMIN-ROLE 授予完全访问权限，包括用户管理。 NETWORK-ADMIN-ROLE 授予完全网络访问权限，无系统功能。 OBSERVER-ROLE 授予只读访问权限，无配置或控制功能。 |
|
与用户帐户关联的“用户名”。 用户创建、更新和删除操作都需要。 |
|
设置为 True 以在应用 playbook 配置后验证 Cisco Catalyst Center。 选项
|
|
定义以秒为单位的 API 调用超时时间，用于检索任务详细信息。如果在此期间未收到任务详细信息，则流程将结束，并将记录超时通知。 默认值： |
|
指示是否在 Cisco Catalyst Center SDK 中启用调试。 选项
|
|
Cisco Catalyst Center 的主机名。 |
|
启用/禁用 playbook 执行日志记录的标志。 当为 true 且提供 dnac_log_file_path 时，- 在执行位置创建具有指定名称的日志文件。 当为 true 且未提供 dnac_log_file_path 时，- 在执行位置创建名为“dnac.log”的日志文件。 当为 false 时，- 日志记录被禁用。 如果日志文件不存在，- 它将根据“dnac_log_append”标志以追加或写入模式创建。 如果日志文件存在，- 它将根据“dnac_log_append”标志被覆盖或追加。 选项
|
|
确定文件的模式。设置为 True 表示“追加”模式。设置为 False 表示“写入”模式。 选项
|
|
控制日志记录。如果 dnac_log 为 True，则记录日志。 如果未指定路径，- 当 `dnac_log_append` 为 True 时，将在当前 Ansible 目录中生成 `dnac.log` 文件；日志将追加写入。- 当 `dnac_log_append` 为 False 时，将生成 `dnac.log` 文件；日志将被覆盖。 如果指定了路径，- 当 `dnac_log_append` 为 True 时，文件将以追加模式打开。- 当 `dnac_log_append` 为 False 时，文件将以写入 (w) 模式打开。- 在共享文件场景中，如果没有追加模式，则每次模块执行后内容将被覆盖。- 对于共享日志文件，请为第一个模块将 append 设置为 False（以覆盖）；对于后续模块，请将 append 设置为 True。 默认值： |
|
设置日志级别的阈值。级别等于或高于此级别的消息将被记录。级别按严重性顺序排列 [CRITICAL，ERROR，WARNING，INFO，DEBUG]。 CRITICAL 表示严重的错误导致程序停止。仅显示 CRITICAL 级别的消息。 ERROR 表示阻止功能的问题。显示 ERROR 和 CRITICAL 级别的消息。 WARNING 表示潜在的未来问题。显示 WARNING、ERROR 和 CRITICAL 级别的消息。 INFO 跟踪正常运行。显示 INFO、WARNING、ERROR 和 CRITICAL 级别的消息。 DEBUG 提供详细的诊断信息。显示所有日志消息。 默认值： |
|
Cisco Catalyst Center 的身份验证密码。 |
|
指定与 Cisco Catalyst Center 关联的端口号。 默认值： |
|
指定连续调用 API 以检索任务详细信息之间的间隔（以秒为单位）。 默认值： |
|
Cisco Catalyst Center 的身份验证用户名。 默认值： |
|
启用或禁用 SSL 证书验证的标志。 选项
|
|
指定 SDK 应使用的 Cisco Catalyst Center 版本。 默认值： |
|
模块完成后的 Cisco Catalyst Center 状态。 选项
|
|
Cisco Catalyst Center SDK 的标志，用于启用根据 JSON 模式验证请求正文。 选项
|
备注
注意
使用的 SDK 方法 - user_and_roles.UserandRoles.get_user_api - user_and_roles.UserandRoles.add_user_api - user_and_roles.UserandRoles.update_user_api - user_and_roles.UserandRoles.delete_user_api
使用的路径 - get /dna/system/api/v1/user - post /dna/system/api/v1/user - put /dna/system/api/v1/user - delete /dna/system/api/v1/user/{userId}
不支持
check_mode该插件在控制节点上运行，不使用任何 Ansible 连接插件，而是使用来自 Cisco Catalyst Center SDK 的嵌入式连接管理器。
以 dnac_ 开头的参数由 Cisco Catalyst Center Python SDK 用于建立连接。
示例
---
- name: Create a user
cisco.dnac.user_role_workflow_manager:
dnac_host: "{{ dnac_host }}"
dnac_username: "{{ dnac_username }}"
dnac_password: "{{ dnac_password }}"
dnac_verify: "{{ dnac_verify }}"
dnac_port: "{{ dnac_port }}"
dnac_version: "{{ dnac_version }}"
dnac_debug: "{{ dnac_debug }}"
dnac_log: True
dnac_log_level: DEBUG
config_verify: True
dnac_api_task_timeout: 1000
dnac_task_poll_interval: 1
state: merged
config:
user_details:
- username: "ajithandrewj"
first_name: "ajith"
last_name: "andrew"
email: "[email protected]"
password: "Example@0101"
role_list: ["SUPER-ADMIN-ROLE"]
- name: Update a user for first name, last name, email, and role list
cisco.dnac.user_role_workflow_manager:
dnac_host: "{{ dnac_host }}"
dnac_username: "{{ dnac_username }}"
dnac_password: "{{ dnac_password }}"
dnac_verify: "{{ dnac_verify }}"
dnac_port: "{{ dnac_port }}"
dnac_version: "{{ dnac_version }}"
dnac_debug: "{{ dnac_debug }}"
dnac_log: True
dnac_log_level: DEBUG
config_verify: True
dnac_api_task_timeout: 1000
dnac_task_poll_interval: 1
state: merged
config:
user_details:
- username: "ajithandrewj"
first_name: "ajith"
last_name: "andrew"
email: "[email protected]"
role_list: ["SUPER-ADMIN-ROLE"]
- name: Update a user for role list
cisco.dnac.user_role_workflow_manager:
dnac_host: "{{ dnac_host }}"
dnac_username: "{{ dnac_username }}"
dnac_password: "{{ dnac_password }}"
dnac_verify: "{{ dnac_verify }}"
dnac_port: "{{ dnac_port }}"
dnac_version: "{{ dnac_version }}"
dnac_debug: "{{ dnac_debug }}"
dnac_log: True
dnac_log_level: DEBUG
config_verify: True
dnac_api_task_timeout: 1000
dnac_task_poll_interval: 1
state: merged
config:
user_details:
- username: "ajithandrewj"
role_list: ["NETWORK-ADMIN-ROLE"]
- name: Update the user password
cisco.dnac.user_role_workflow_manager:
dnac_host: "{{ dnac_host }}"
dnac_username: "{{ dnac_username }}"
dnac_password: "{{ dnac_password }}"
dnac_verify: "{{ dnac_verify }}"
dnac_port: "{{ dnac_port }}"
dnac_version: "{{ dnac_version }}"
dnac_debug: "{{ dnac_debug }}"
dnac_log: True
dnac_log_level: DEBUG
config_verify: True
dnac_api_task_timeout: 1000
dnac_task_poll_interval: 1
state: merged
config:
user_details:
- username: "ajithandrewj"
password: "Example@010101"
password_update: True
- name: Delete a user using username or email address
cisco.dnac.user_role_workflow_manager:
dnac_host: "{{ dnac_host }}"
dnac_username: "{{ dnac_username }}"
dnac_password: "{{ dnac_password }}"
dnac_verify: "{{ dnac_verify }}"
dnac_port: "{{ dnac_port }}"
dnac_version: "{{ dnac_version }}"
dnac_debug: "{{ dnac_debug }}"
dnac_log: True
dnac_log_level: DEBUG
config_verify: True
dnac_api_task_timeout: 1000
dnac_task_poll_interval: 1
state: deleted
config:
user_details:
username: "ajithandrewj"
- name: Create a role with all params
cisco.dnac.user_role_workflow_manager:
dnac_host: "{{ dnac_host }}"
dnac_username: "{{ dnac_username }}"
dnac_password: "{{ dnac_password }}"
dnac_verify: "{{ dnac_verify }}"
dnac_port: "{{ dnac_port }}"
dnac_version: "{{ dnac_version }}"
dnac_debug: "{{ dnac_debug }}"
dnac_log: True
dnac_log_level: DEBUG
config_verify: True
config:
role_details:
- role_name: "role_name"
description: "role_description"
assurance:
- monitoring_and_troubleshooting: "write"
monitoring_settings: "read"
troubleshooting_tools: "deny"
network_analytics:
- data_access: "write"
network_design:
- advanced_network_settings: "deny"
image_repository: "deny"
network_hierarchy: "deny"
network_profiles: "write"
network_settings: "write"
virtual_network: "read"
network_provision:
- compliance: "deny"
eox: "read"
image_update: "write"
inventory_management:
- device_configuration: "write"
discovery: "deny"
network_device: "read"
port_management: "write"
topology: "write"
license: "write"
network_telemetry: "write"
pnp: "deny"
provision: "read"
network_services:
- app_hosting: "deny"
bonjour: "write"
stealthwatch: "read"
umbrella: "deny"
platform:
- apis: "write"
bundles: "write"
events: "write"
reports: "read"
security:
- group_based_policy: "read"
ip_based_access_control: "write"
security_advisories: "write"
system:
- machine_reasoning: "read"
system_management: "write"
utilities:
- audit_log: "read"
event_viewer: "deny"
network_reasoner: "write"
remote_device_support: "read"
scheduler: "read"
search: "write"
- name: Create a role for assurance
cisco.dnac.user_role_workflow_manager:
dnac_host: "{{ dnac_host }}"
dnac_username: "{{ dnac_username }}"
dnac_password: "{{ dnac_password }}"
dnac_verify: "{{ dnac_verify }}"
dnac_port: "{{ dnac_port }}"
dnac_version: "{{ dnac_version }}"
dnac_debug: "{{ dnac_debug }}"
dnac_log: True
dnac_log_level: DEBUG
config_verify: True
config:
role_details:
- role_name: "role_name"
description: "role_description"
assurance:
- overall: "write"
monitoring_and_troubleshooting: "read"
- name: Create a role for network provision
cisco.dnac.user_role_workflow_manager:
dnac_host: "{{ dnac_host }}"
dnac_username: "{{ dnac_username }}"
dnac_password: "{{ dnac_password }}"
dnac_verify: "{{ dnac_verify }}"
dnac_port: "{{ dnac_port }}"
dnac_version: "{{ dnac_version }}"
dnac_debug: "{{ dnac_debug }}"
dnac_log: True
dnac_log_level: DEBUG
config_verify: True
config:
role_details:
- role_name: "role_name"
description: "role_description"
network_provision:
- compliance: "deny"
image_update: "write"
inventory_management:
- overall: "read"
device_configuration: "write"
license: "write"
network_telemetry: "write"
pnp: "deny"
provision: "read"
- name: Update a role for assurance and platform
cisco.dnac.user_role_workflow_manager:
dnac_host: "{{ dnac_host }}"
dnac_username: "{{ dnac_username }}"
dnac_password: "{{ dnac_password }}"
dnac_verify: "{{ dnac_verify }}"
dnac_port: "{{ dnac_port }}"
dnac_version: "{{ dnac_version }}"
dnac_debug: "{{ dnac_debug }}"
dnac_log: True
dnac_log_level: DEBUG
config_verify: True
config:
role_details:
- role_name: "role_name"
assurance:
- overall: "deny"
platform:
- apis: "write"
bundles: "write"
events: "write"
reports: "read"
- name: Delete a role
cisco.dnac.user_role_workflow_manager:
dnac_host: "{{ dnac_host }}"
dnac_username: "{{ dnac_username }}"
dnac_password: "{{ dnac_password }}"
dnac_verify: "{{ dnac_verify }}"
dnac_port: "{{ dnac_port }}"
dnac_version: "{{ dnac_version }}"
dnac_debug: "{{ dnac_debug }}"
dnac_log: True
dnac_log_level: DEBUG
config_verify: True
dnac_api_task_timeout: 1000
dnac_task_poll_interval: 1
state: deleted
config:
role_details:
- rolename: "role_name"
返回值
常见的返回值已在 此处 记录，以下是此模块特有的字段。
键 |
描述 |
|---|---|
包含来自 Cisco Catalyst Center 的 API 执行详细信息的字典。 返回：始终 示例： |
|
包含 API 执行和错误信息的字典。 返回：始终 示例： |
|
指示在删除操作期间未找到角色的字典。 返回：始终 示例： |
|
包含来自 Cisco Catalyst Center 的 API 执行详细信息的字典。 返回：始终 示例： |
|
包含来自 Cisco Catalyst Center 的 API 执行详细信息的字典。 返回：始终 示例： |
|
包含现有用户详细信息的字典，指示无需更新。 返回：始终 示例： |
|
包含 API 执行和错误信息的字典。 返回：始终 示例： |
|
指示在删除操作期间未找到用户的字典。 返回：始终 示例： |
|
包含来自 Cisco Catalyst Center 的 API 执行详细信息的字典。 返回：始终 示例： |
|
包含来自 Cisco Catalyst Center 的 API 执行详细信息的字典。 返回：始终 示例： |
|
包含来自 Cisco Catalyst Center 的 API 执行详细信息的字典。 返回：始终 示例： |