Skip to content

Authentication Rule

Location in GUI: Work Centers » Network Access » Policy Sets » XXX » Authentication Policy

Diagram
NameTypeConstraintMandatoryDefault Value
authentication_rulesList[authentication_rules]No

authentication_rules (ise.network_access.policy_sets)

Section titled “authentication_rules (ise.network_access.policy_sets)”
NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[\w\d\_\-\. \(\)]+$Yes
stateChoiceenabled, disabled, monitorNoenabled
conditionClass[condition]No
identity_source_nameStringNo
if_auth_failChoiceREJECT, CONTINUE, DROPNoREJECT
if_user_not_foundChoiceREJECT, CONTINUE, DROPNoREJECT
if_process_failChoiceREJECT, CONTINUE, DROPNoDROP

condition (ise.network_access.policy_sets.authentication_rules)

Section titled “condition (ise.network_access.policy_sets.authentication_rules)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributes, ConditionAndBlock, ConditionOrBlockYes
is_negateBooleantrue, falseNofalse
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWith, macContains, macEndsWith, macEquals, macIn, macNotContains, macNotEndsWith, macNotEquals, macNotIn, macNotStartsWith, macStartsWithNo
attribute_valueStringNo
nameStringNo
childrenList[children]No

children (ise.network_access.policy_sets.authentication_rules.condition)

Section titled “children (ise.network_access.policy_sets.authentication_rules.condition)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributes, ConditionAndBlock, ConditionOrBlockYes
is_negateBooleantrue, falseNo
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWith, macContains, macEndsWith, macEquals, macIn, macNotContains, macNotEndsWith, macNotEquals, macNotIn, macNotStartsWith, macStartsWithNo
attribute_valueStringNo
nameStringNo
childrenList[children]No

children (ise.network_access.policy_sets.authentication_rules.condition.children)

Section titled “children (ise.network_access.policy_sets.authentication_rules.condition.children)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributesYes
is_negateBooleantrue, falseNo
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWith, macContains, macEndsWith, macEquals, macIn, macNotContains, macNotEndsWith, macNotEquals, macNotIn, macNotStartsWith, macStartsWithNo
attribute_valueStringNo
nameStringNo

Example-1 Network Access Authentication Rule for Wired 802.1X with EAP-TLS Certificate Authentication

This authentication rule processes wired 802.1X network access requests using EAP-TLS certificate-based authentication. The rule is enabled and matches when the Network Access:EapAuthentication attribute equals “EAP-TLS”, directing authentication to the Preloaded_Certificate_Profile identity source for certificate validation. The rule implements specific failure handling logic: if_auth_fail is set to REJECT (denying access when credentials are invalid), if_user_not_found is set to CONTINUE (allowing the policy engine to evaluate subsequent rules when the certificate is not found in the identity source), and if_process_fail is set to DROP (terminating the authentication attempt on processing errors)

ise:
network_access:
policy_sets:
- name: Global Policy
authentication_rules:
- name: Wired_802.1X
state: enabled
condition:
type: ConditionAttributes
dictionary_name: Network Access
attribute_name: EapAuthentication
operator: equals
attribute_value: EAP-TLS
identity_source_name: Preloaded_Certificate_Profile
if_auth_fail: REJECT
if_user_not_found: CONTINUE
if_process_fail: DROP

Example-2 Network Access Authentication Rule for Wireless 802.11 with EAP-TLS Certificate Authentication

This authentication rule processes wireless 802.11 network access requests using EAP-TLS certificate-based authentication. The rule uses a compound condition (ConditionAndBlock) that matches when both the Radius:NAS-Port-Type equals “Wireless - IEEE 802.11” AND the Network Access:EapAuthentication equals “EAP-TLS”, ensuring this rule only applies to wireless clients attempting certificate authentication. Authentication is performed against the Internal Users identity source for certificate validation. The rule implements strict failure handling with all failure scenarios set to deny access: if_auth_fail is REJECT (blocking invalid certificates), if_user_not_found is REJECT (denying unknown certificates), and if_process_fail is DROP (terminating on processing errors).

ise:
network_access:
policy_sets:
- name: Global Policy
authentication_rules:
- name: Wireless_EAP_TLS_Authentication
state: enabled
condition:
type: ConditionAndBlock
children:
- type: ConditionAttributes
dictionary_name: Radius
attribute_name: NAS-Port-Type
operator: equals
attribute_value: Wireless - IEEE 802.11
- type: ConditionAttributes
dictionary_name: Network Access
attribute_name: EapAuthentication
operator: equals
attribute_value: EAP-TLS
identity_source_name: Internal Users
if_auth_fail: REJECT
if_user_not_found: REJECT
if_process_fail: DROP

Location in GUI: Work Centers » Network Access » Policy Sets » XXX » Authentication Policy

Diagram
NameTypeConstraintMandatoryDefault Value
authentication_rulesList[authentication_rules]No

authentication_rules (ise.network_access.policy_sets)

Section titled “authentication_rules (ise.network_access.policy_sets)”
NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[\w\d_\-\.]+$Yes
stateChoiceenabled, disabled, monitorNoenabled
conditionClass[condition]No
identity_source_nameStringNo
if_auth_failChoiceREJECT, CONTINUE, DROPNoREJECT
if_user_not_foundChoiceREJECT, CONTINUE, DROPNoREJECT
if_process_failChoiceREJECT, CONTINUE, DROPNoDROP

condition (ise.network_access.policy_sets.authentication_rules)

Section titled “condition (ise.network_access.policy_sets.authentication_rules)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributes, ConditionAndBlock, ConditionOrBlockYes
is_negateBooleantrue, falseNofalse
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWithNo
attribute_valueStringNo
nameStringNo
childrenList[children]No

children (ise.network_access.policy_sets.authentication_rules.condition)

Section titled “children (ise.network_access.policy_sets.authentication_rules.condition)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributes, ConditionAndBlock, ConditionOrBlockYes
is_negateBooleantrue, falseNo
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWithNo
attribute_valueStringNo
nameStringNo
childrenList[children]No

children (ise.network_access.policy_sets.authentication_rules.condition.children)

Section titled “children (ise.network_access.policy_sets.authentication_rules.condition.children)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributesYes
is_negateBooleantrue, falseNo
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWithNo
attribute_valueStringNo
nameStringNo

ise:
network_access:
policy_sets:
- name: Global Policy
authentication_rules:
- name: DOT1x_wired
default: false
state: enabled
condition:
type: ConditionAndBlock
is_negate: false
children:
- type: ConditionAttributes
is_negate: false
dictionary_name: CERTIFICATE
attribute_name: Subject - Common Name
operator: contains
attribute_value: Test1
- type: ConditionReference
is_negate: false
name: Wired_802.1X
identity_source_name: Global_Certificate
if_auth_fail: REJECT
if_user_not_found: CONTINUE
if_process_fail: DROP

Location in GUI: Work Centers » Network Access » Policy Sets » XXX » Authentication Policy

Diagram
NameTypeConstraintMandatoryDefault Value
authentication_rulesList[authentication_rules]No

authentication_rules (ise.network_access.policy_sets)

Section titled “authentication_rules (ise.network_access.policy_sets)”
NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[\w\d_\-\.]+$Yes
stateChoiceenabled, disabled, monitorNoenabled
conditionClass[condition]No
identity_source_nameStringNo
if_auth_failChoiceREJECT, CONTINUE, DROPNoREJECT
if_user_not_foundChoiceREJECT, CONTINUE, DROPNoREJECT
if_process_failChoiceREJECT, CONTINUE, DROPNoDROP

condition (ise.network_access.policy_sets.authentication_rules)

Section titled “condition (ise.network_access.policy_sets.authentication_rules)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributes, ConditionAndBlock, ConditionOrBlockYes
is_negateBooleantrue, falseNofalse
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWithNo
attribute_valueStringNo
nameStringNo
childrenList[children]No

children (ise.network_access.policy_sets.authentication_rules.condition)

Section titled “children (ise.network_access.policy_sets.authentication_rules.condition)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributes, ConditionAndBlock, ConditionOrBlockYes
is_negateBooleantrue, falseNo
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWithNo
attribute_valueStringNo
nameStringNo
childrenList[children]No

children (ise.network_access.policy_sets.authentication_rules.condition.children)

Section titled “children (ise.network_access.policy_sets.authentication_rules.condition.children)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributesYes
is_negateBooleantrue, falseNo
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWithNo
attribute_valueStringNo
nameStringNo

ise:
network_access:
policy_sets:
- name: Global Policy
authentication_rules:
- name: DOT1x_wired
default: false
state: enabled
condition:
type: ConditionAndBlock
is_negate: false
children:
- type: ConditionAttributes
is_negate: false
dictionary_name: CERTIFICATE
attribute_name: Subject - Common Name
operator: contains
attribute_value: Test1
- type: ConditionReference
is_negate: false
name: Wired_802.1X
identity_source_name: Global_Certificate
if_auth_fail: REJECT
if_user_not_found: CONTINUE
if_process_fail: DROP

Location in GUI: Work Centers » Network Access » Policy Sets » XXX » Authentication Policy

Diagram
NameTypeConstraintMandatoryDefault Value
authentication_rulesList[authentication_rules]No

authentication_rules (ise.network_access.policy_sets)

Section titled “authentication_rules (ise.network_access.policy_sets)”
NameTypeConstraintMandatoryDefault Value
nameStringRegex: ^[\w\d_\-\.]+$Yes
stateChoiceenabled, disabled, monitorNoenabled
conditionClass[condition]No
identity_source_nameStringNo
if_auth_failChoiceREJECT, CONTINUE, DROPNoREJECT
if_user_not_foundChoiceREJECT, CONTINUE, DROPNoREJECT
if_process_failChoiceREJECT, CONTINUE, DROPNoDROP

condition (ise.network_access.policy_sets.authentication_rules)

Section titled “condition (ise.network_access.policy_sets.authentication_rules)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributes, ConditionAndBlock, ConditionOrBlockYes
is_negateBooleantrue, falseNofalse
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWithNo
attribute_valueStringNo
nameStringNo
childrenList[children]No

children (ise.network_access.policy_sets.authentication_rules.condition)

Section titled “children (ise.network_access.policy_sets.authentication_rules.condition)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributes, ConditionAndBlock, ConditionOrBlockYes
is_negateBooleantrue, falseNo
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWithNo
attribute_valueStringNo
nameStringNo
childrenList[children]No

children (ise.network_access.policy_sets.authentication_rules.condition.children)

Section titled “children (ise.network_access.policy_sets.authentication_rules.condition.children)”
NameTypeConstraintMandatoryDefault Value
typeChoiceConditionReference, ConditionAttributesYes
is_negateBooleantrue, falseNo
dictionary_nameStringNo
attribute_nameStringNo
operatorChoicecontains, endsWith, equals, greaterOrEquals, greaterThan, in, ipEquals, ipGreaterThan, ipLessThan, ipNotEquals, lessOrEquals, lessThan, matches, notContains, notEndsWith, notEquals, notIn, notStartsWith, startsWithNo
attribute_valueStringNo
nameStringNo

ise:
network_access:
policy_sets:
- name: Global Policy
authentication_rules:
- name: DOT1x_wired
default: false
state: enabled
condition:
type: ConditionAndBlock
is_negate: false
children:
- type: ConditionAttributes
is_negate: false
dictionary_name: CERTIFICATE
attribute_name: Subject - Common Name
operator: contains
attribute_value: Test1
- type: ConditionReference
is_negate: false
name: Wired_802.1X
identity_source_name: Global_Certificate
if_auth_fail: REJECT
if_user_not_found: CONTINUE
if_process_fail: DROP