cisco.ise.authorization_profile 模块 – 授权配置文件的资源模块
注意
此模块是 cisco.ise 集合(版本 2.9.6)的一部分。
如果您正在使用 ansible
包,您可能已经安装了这个集合。它不包含在 ansible-core
中。要检查是否已安装,请运行 ansible-galaxy collection list
。
要安装它,请使用:ansible-galaxy collection install cisco.ise
。您需要进一步的要求才能使用此模块,有关详细信息,请参阅要求。
要在剧本中使用它,请指定:cisco.ise.authorization_profile
。
cisco.ise 1.0.0 中的新增功能
概要
管理资源授权配置文件的创建、更新和删除操作。
此 API 创建授权配置文件。
此 API 删除授权配置文件。
此 API 允许客户端更新授权配置文件。
注意
此模块具有相应的操作插件。
要求
在执行此模块的主机上需要以下要求。
ciscoisesdk >= 2.2.3
python >= 3.5
参数
参数 |
注释 |
---|---|
允许的值 - ACCESS_ACCEPT, - ACCESS_REJECT。 |
|
授权配置文件的 acl。 |
|
授权配置文件的 advancedAttributes。 |
|
授权配置文件的 leftHandSideDictionaryAttribue。 |
|
授权配置文件的 AdvancedAttributeValueType。 |
|
授权配置文件的 attributeName。 |
|
授权配置文件的 dictionaryName。 |
|
授权配置文件的 value。 |
|
属性值可以是 AttributeValue 或 AdvancedDictionaryAttribute 类型。对于 AttributeValue,值是 String,对于 AdvancedDictionaryAttribute,值是 dictionaryName 和 attributeName 属性。 |
|
授权配置文件的 AdvancedAttributeValueType。 |
|
授权配置文件的 attributeName。 |
|
授权配置文件的 dictionaryName。 |
|
授权配置文件的 value。 |
|
AgentlessPosture 标志。 选项
|
|
授权配置文件的 airespaceACL。 |
|
授权配置文件的 airespaceIPv6ACL。 |
|
授权配置文件的 asaVpn。 |
|
允许的值 - SWITCH, - TRUSTSEC, - TACACS SWITCH 用于标准授权配置文件。 |
|
授权配置文件的 autoSmartPort。 |
|
授权配置文件的 avcProfile。 |
|
授权配置文件的 daclName。 |
|
授权配置文件的 description。 |
|
EasywiredSessionCandidate 标志。 选项
|
|
资源 UUID 值。 |
|
授权配置文件的 interfaceTemplate。 |
|
授权配置文件的 ipv6ACLFilter。 |
|
授权配置文件的 ipv6DaclName。 |
|
用于启用调试的 Identity Services Engine SDK 标志。 选项
|
|
Identity Services Engine 主机名。 |
|
用于进行身份验证的 Identity Services Engine 密码。 |
|
RESTful HTTP 请求的超时时间(以秒为单位)。 默认: |
|
用于进行身份验证的 Identity Services Engine 用户名。 |
|
一个标志,用于通知 SDK 我们是否将 CSRF 令牌发送到 ISE 的 ERS API。 如果为 True,则 SDK 假设您的 ISE CSRF 检查已启用。 如果为 True,则它假设您需要 SDK 为您自动管理 CSRF 令牌。 选项
|
|
用于启用或禁用 SSL 证书验证的标志。 选项
|
|
通知 SDK 要使用的 Identity Services Engine 版本。 默认: |
|
用于启用自动速率限制处理的 Identity Services Engine SDK 标志。 选项
|
|
允许的值 - MUST_SECURE, - MUST_NOT_SECURE, - SHOULD_SECURE。 |
|
资源名称。 |
|
Neat 标志。 选项
|
|
授权配置文件的 profileName。 |
|
授权配置文件的 reauth。 |
|
允许的值 - DEFAULT, - RADIUS_REQUEST。 |
|
有效范围是 1-65535。 |
|
ServiceTemplate 标志。 选项
|
|
TrackMovement 标志。 选项
|
|
授权配置文件的 vlan。 |
|
授权配置文件的 nameID。 |
|
有效范围为 0-31。 |
|
VoiceDomainPermission 标志。 选项
|
|
WebAuth 标志。 选项
|
|
授权配置文件的 webRedirection。 |
|
授权配置文件的 acl。 |
|
当 ‘WebRedirectionType’ 的值为 ‘CentralizedWebAuth’ 时,displayCertificatesRenewalMessages 是强制性的。对于所有其他 ‘WebRedirectionType’ 值,该字段必须被忽略。 选项
|
|
数据库中存在的并且符合 WebRedirectionType 的门户。 |
|
授权配置文件的 staticIPHostNameFQDN。 |
|
值必须是以下之一:CentralizedWebAuth、HotSpot、NativeSupplicanProvisioning、ClientProvisioning。WebRedirectionType 必须与 portalName 相匹配。 |
说明
注意
使用的 SDK 方法是 authorization_profile.AuthorizationProfile.create_authorization_profile、authorization_profile.AuthorizationProfile.delete_authorization_profile_by_id、authorization_profile.AuthorizationProfile.update_authorization_profile_by_id。
使用的路径是 post /ers/config/authorizationprofile, delete /ers/config/authorizationprofile/{id}, put /ers/config/authorizationprofile/{id}。
不支持
check_mode
该插件在控制节点上运行,不使用任何 Ansible 连接插件,而是使用 Cisco ISE SDK 中嵌入的连接管理器。
以 ise_ 开头的参数供 Cisco ISE Python SDK 用于建立连接。
示例
- name: Update by id
cisco.ise.authorization_profile:
ise_hostname: "{{ise_hostname}}"
ise_username: "{{ise_username}}"
ise_password: "{{ise_password}}"
ise_verify: "{{ise_verify}}"
state: present
accessType: string
acl: string
advancedAttributes:
- leftHandSideDictionaryAttribue:
AdvancedAttributeValueType: string
attributeName: string
dictionaryName: string
value: string
rightHandSideAttribueValue:
AdvancedAttributeValueType: string
attributeName: string
dictionaryName: string
value: string
agentlessPosture: true
airespaceACL: string
airespaceIPv6ACL: string
asaVpn: string
authzProfileType: string
autoSmartPort: string
avcProfile: string
daclName: string
description: string
easywiredSessionCandidate: true
id: string
interfaceTemplate: string
ipv6ACLFilter: string
ipv6DaclName: string
macSecPolicy: string
name: string
neat: true
profileName: string
reauth:
connectivity: string
timer: 0
serviceTemplate: true
trackMovement: true
vlan:
nameID: string
tagID: 0
voiceDomainPermission: true
webAuth: true
webRedirection:
WebRedirectionType: string
acl: string
displayCertificatesRenewalMessages: true
portalName: string
staticIPHostNameFQDN: string
- name: Delete by id
cisco.ise.authorization_profile:
ise_hostname: "{{ise_hostname}}"
ise_username: "{{ise_username}}"
ise_password: "{{ise_password}}"
ise_verify: "{{ise_verify}}"
state: absent
id: string
- name: Create
cisco.ise.authorization_profile:
ise_hostname: "{{ise_hostname}}"
ise_username: "{{ise_username}}"
ise_password: "{{ise_password}}"
ise_verify: "{{ise_verify}}"
state: present
accessType: string
acl: string
advancedAttributes:
- leftHandSideDictionaryAttribue:
AdvancedAttributeValueType: string
attributeName: string
dictionaryName: string
value: string
rightHandSideAttribueValue:
AdvancedAttributeValueType: string
attributeName: string
dictionaryName: string
value: string
agentlessPosture: true
airespaceACL: string
airespaceIPv6ACL: string
asaVpn: string
authzProfileType: string
autoSmartPort: string
avcProfile: string
daclName: string
description: string
easywiredSessionCandidate: true
id: string
interfaceTemplate: string
ipv6ACLFilter: string
ipv6DaclName: string
macSecPolicy: string
name: string
neat: true
profileName: string
reauth:
connectivity: string
timer: 0
serviceTemplate: true
trackMovement: true
vlan:
nameID: string
tagID: 0
voiceDomainPermission: true
webAuth: true
webRedirection:
WebRedirectionType: string
acl: string
displayCertificatesRenewalMessages: true
portalName: string
staticIPHostNameFQDN: string
返回值
常见的返回值在此处记录 这里,以下是此模块特有的字段。
键 |
描述 |
---|---|
一个字典或列表,其中包含 Cisco ISE Python SDK 返回的响应。 返回: 总是 示例: |
|
一个字典或列表,其中包含 Cisco ISE Python SDK 返回的响应。 返回: 总是 示例: |
作者
Rafael Campos (@racampos)