EOS AAA and local credentials
Rules for who can log in and what gets recorded: the root account off, logins checked by a TACACS+ or RADIUS group with a local fallback, every local user with a password, and every command sent to accounting. They come from the eos-aaa policy template.
Every example on this page was checked with rConfig Pro's policy engine on Each of the 8 configs below was run through rConfig Pro’s evaluator with the rule above it, and gave the result shown. The configs are sanitised excerpts of the sample configs that come with the template.
All the rules come from eos-aaa.policy in the policy templates (v1.5.0). Import the whole file with Import Templates (see importing a policy template), or copy one rule into your own definition. The Arista EOS templates page lists the file’s known limitations. Run the rules against show running-config.
| Rule | Method | Since |
|---|---|---|
| Root account is not enabled | must_not_match_regex |
8.0.2 |
| Server group login with local fallback | must_match_regex |
8.0.0 |
| No user without a password | must_not_match_regex |
8.0.2 |
| Command accounting | must_match_regex |
8.0.0 |
Root account is not enabled
The root account is off by default. Any line starting aaa root turns it on, for example with a secret or nopassword. This rule fails on that line, so it passes whether or not no aaa root is printed.
// The root account is not enabled (fails on an aaa root line)#[must_not_match_regex]/^aaa root /mno aaa root!username admin privilege 15 role network-admin secret sha512 $6$e7dc509350d7ea2d$2da893d759d5bc49dc260f5985837b8059f55a9f051a64eb793f73bc0f2d1894c63057645085aceab10d0aWhy: The root account is off.
aaa root secret sha512 $6$f1e2d3c4b5a69788$9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d!username admin privilege 15 role network-admin secret sha512 $6$e7dc509350d7ea2d$2da893d759d5bc49dc260f5985837b8059f55a9f051a64eb793f73bc0f2d1894c63057645085aceab10d0aWhy: The root account has a secret, so it is on.
Expected result in rConfig, with this rule as the only rule in a definition:
| Config | Rule result | Overall result |
|---|---|---|
| Passing config | pass | PASS |
| Failing config | fail | FAIL |
Framework mapping. The rule provides evidence towards these controls. It does not certify anything.
| Framework | Reference |
|---|---|
| NIST SP 800-53 | AC-2 |
| ISO/IEC 27001:2022 Annex A | A.8.2 |
Tested with: sample excerpts from EOS 4.32.2F (synthetic). Minimum rConfig 8.0.2 (must_not_match_regex). Editions: Pro, Vector, Enterprise.
Server group login with local fallback
Logins should be checked by a TACACS+ or RADIUS group, with local accounts only as a fallback when the servers cannot be reached. This rule needs aaa authentication login default with at least one group and local last.
// Login authentication uses a remote server group with local fallback (aaa authentication login default group ... local)#[must_match_regex]/^aaa authentication login default group \S+(?: \S+)* local$/maaa authentication login default group tacacs+ localaaa authorization exec default group tacacs+ localaaa authorization commands all default group tacacs+ localaaa accounting exec default start-stop group tacacs+aaa accounting commands all default start-stop group tacacs+Why: Logins go to the tacacs+ group first, then local.
aaa authentication login default localaaa authorization exec default group tacacs+ localaaa authorization commands all default group tacacs+ localaaa accounting exec default start-stop group tacacs+Why: Logins use local accounts only.
Expected result in rConfig, with this rule as the only rule in a definition:
| Config | Rule result | Overall result |
|---|---|---|
| Passing config | pass | PASS |
| Failing config | fail | FAIL |
Framework mapping. The rule provides evidence towards these controls. It does not certify anything.
| Framework | Reference |
|---|---|
| NIST SP 800-53 | AC-2 |
| NIST CSF 1.1 | PR.AC-1 |
| HIPAA (45 CFR) | 164.312(a)(1) |
| ISO/IEC 27001:2022 Annex A | A.8.5 |
Tested with: sample excerpts from EOS 4.32.2F (synthetic). Minimum rConfig 8.0.0 (must_match_regex). Editions: Pro, Vector, Enterprise.
No user without a password
A local user with nopassword can log in with no password at all. This rule fails on any username line with nopassword.
// No local user is configured without a password (fails on username ... nopassword)#[must_not_match_regex]/^username \S+ .*\bnopassword\b/musername admin privilege 15 role network-admin secret sha512 $6$e7dc509350d7ea2d$2da893d759d5bc49dc260f5985837b8059f55a9f051a64eb793f73bc0f2d1894c63057645085aceab10d0ausername netops privilege 15 role network-admin secret sha512 $6$d20dbb56268343f0$3027497f2ebb43be26aa06626839bfa8335b08214d62a9e21e5c25c44266cd0969642df578e228fdb5c7f7Why: Both users have a hashed secret.
username admin privilege 15 role network-admin secret sha512 $6$e7dc509350d7ea2d$2da893d759d5bc49dc260f5985837b8059f55a9f051a64eb793f73bc0f2d1894c63057645085aceab10d0ausername guest privilege 1 nopasswordusername netops privilege 15 role network-admin secret sha512 $6$d20dbb56268343f0$3027497f2ebb43be26aa06626839bfa8335b08214d62a9e21e5c25c44266cd0969642df578e228fdb5c7f7Why: The guest user has no password.
Expected result in rConfig, with this rule as the only rule in a definition:
| Config | Rule result | Overall result |
|---|---|---|
| Passing config | pass | PASS |
| Failing config | fail | FAIL |
Framework mapping. The rule provides evidence towards these controls. It does not certify anything.
| Framework | Reference |
|---|---|
| NIST SP 800-53 | IA-5 |
| ISO/IEC 27001:2022 Annex A | A.5.17 |
Tested with: sample excerpts from EOS 4.32.2F (synthetic). Minimum rConfig 8.0.2 (must_not_match_regex). Editions: Pro, Vector, Enterprise.
Command accounting
Command accounting records every command an admin runs on a server you control. This rule needs aaa accounting commands all default, start-stop or stop-only, sent to a group.
// All commands are sent to a remote accounting group (aaa accounting commands all default ... group)#[must_match_regex]/^aaa accounting commands all default (start-stop|stop-only) group /maaa authentication login default group tacacs+ localaaa authorization exec default group tacacs+ localaaa authorization commands all default group tacacs+ localaaa accounting exec default start-stop group tacacs+aaa accounting commands all default start-stop group tacacs+Why: Every command is sent to the tacacs+ group.
aaa authentication login default localaaa authorization exec default group tacacs+ localaaa authorization commands all default group tacacs+ localaaa accounting exec default start-stop group tacacs+Why: Only exec sessions are accounted. There is no aaa accounting commands line.
Expected result in rConfig, with this rule as the only rule in a definition:
| Config | Rule result | Overall result |
|---|---|---|
| Passing config | pass | PASS |
| Failing config | fail | FAIL |
Framework mapping. The rule provides evidence towards these controls. It does not certify anything.
| Framework | Reference |
|---|---|
| NIST SP 800-53 | AU-2 |
| HIPAA (45 CFR) | 164.312(b) |
| ISO/IEC 27001:2022 Annex A | A.8.15 |
Tested with: sample excerpts from EOS 4.32.2F (synthetic). Minimum rConfig 8.0.0 (must_match_regex). Editions: Pro, Vector, Enterprise.
Related reference
- Arista EOS policy templates: every rule in
eos-aaa.policy, its references and known limitations. - Policy Definitions: the definition file format and every method.
- Policy Assignments: run a definition against your devices.
- Policy Compliance Results: read the pass and fail results.