请输入
菜单

排障手册

下载

1. 身份域管

1.1. AD域身份源连接失败(LDAP/LDAPS无法连通)

1.1.1. 问题现象

现象一: 宁盾身份管理平台添加或测试AD域身份源时,提示“连接失败/Connection refused/连接超时”,无法拉取域数据。

现象二: 身份源状态显示“离线/异常”,同步任务报错,日志出现 LDAP error 49/52/53 或“Can't contact LDAP server”。

现象三: 使用LDAPS(636端口)时提示证书校验失败或TLS握手错误。

1.1.2. 问题根因

根因一: 域控地址、端口(389/636)配置错误,或平台侧DNS无法解析域名。

根因二: 网络不通、防火墙未放行LDAP端口,或跨网段路由不可达。

根因三: 绑定账号(Bind DN)格式错误、密码错误,或服务账号被锁定/禁用。

根因四: LDAPS证书不受信(自签/过期/域名不匹配),平台未导入根证书或未调整强校验策略。

根因五: 域控强制要求LDAP签名/通道绑定(LDAP signing),平台侧未启用相应安全通道。

1.1.3. 解决方案

步骤一: 核对身份源连接参数(服务器IP/域名、端口、Base DN、Bind DN、密码)。

步骤二: 在宁盾服务器侧验证到域控的网络与端口连通性。

步骤三: 核对绑定账号格式,使用ldapsearch/ldapwhoami做简单绑定测试。

步骤四: LDAPS场景导入域控根证书,或按规范调整证书校验策略。

1.1.4. 配置生效

Plain Text
# 测试LDAP端口连通性
nc -zv <域控IP> 389
nc -zv <域控IP> 636
# 使用ldapsearch验证绑定与查询
ldapsearch -x -H ldap://<域控IP>:389 -D "cn=svc_ningdun,ou=Service,dc=corp,dc=com" -w '<密码>' -b "dc=corp,dc=com" "objectClass=user" -s sub dn
# LDAPS场景
ldapsearch -x -H ldaps://<域控IP>:636 -D "<BindDN>" -w "<密码>" -b "dc=corp,dc=com" "objectClass=user" dn

在平台“身份源”页面点击“测试连接”,成功后保存配置。

1.1.5. 验证方式

身份源状态变为“在线/正常”;

测试连接返回成功并可预览用户/OU条目;

手动触发一次同步,无LDAP错误日志。

1.2. 组织架构与用户同步不完整(部分OU/账号未同步)

1.2.1. 问题现象

现象一: 同步完成后,平台仅显示部分部门/用户,某些OU下的账号缺失。

现象二: AD中新增或离职的用户在平台无变化,状态未更新。

现象三: 同步日志显示成功,但同步条目数远小于域内实际数量。

1.2.2. 问题根因

根因一: Base DN配置过窄,未覆盖目标OU所在容器。

根因二: 同步过滤器(filter)限制了对象类型或状态,仅同步了部分账号。

根因三: 绑定账号对部分OU无读取权限(ACL委派不足)。

根因四: AD分页大小(MaxPageSize)或平台单次同步条目上限导致结果截断。

根因五: 增量同步依赖的变更字段(whenChanged/uSNChanged)未启用或服务器时间不同步。

1.2.3. 解决方案

步骤一: 扩大Base DN或配置多个同步范围,覆盖全部目标OU。

步骤二: 检查并放宽同步过滤器,确认objectClass与属性映射正确。

步骤三: 为绑定账号委派目标OU的“读取”权限。

步骤四: 调整分页大小与同步条目上限,启用增量同步字段。

1.2.4. 配置生效

Plain Text
# 同步范围与过滤器(示例)
Base DN : dc=corp,dc=com
Filter : \&\(objectClass=user\!\(userAccountControl:1\.2\.840\.113556\.1\.4\.803:=2))
# 用ldapsearch核对过滤器返回的用户总数
ldapsearch -x -H ldap://<域控IP>:389 -D "<BindDN>" -w "<密码>" -b "dc=corp,dc=com" "\&\(objectClass=user)" dn | grep -c "dn:"

在平台调整同步范围/过滤器/分页参数后,点击“立即同步”。

1.2.5. 验证方式

平台用户总数与AD中启用用户数一致;

抽查此前缺失的OU,其下账号已出现;

新增/离职用户在下次同步后状态正确更新。

1.3. 域账号密码校验失败(LDAP Bind认证异常)

1.3.1. 问题现象

现象一: 用户使用正确的域账号密码登录接入平台,提示“用户名或密码错误”。

现象二: 部分用户可登录、部分用户始终失败,失败集中在某一OU。

现象三: 平台日志出现 LDAP error 49(invalidCredentials),或子码 525/52e/530/532/701/773/775。

1.3.2. 问题根因

根因一: 用户名标识字段不匹配(应使用userPrincipalName或DOMAIN\sAMAccountName,配置却用了错误字段)。

根因二: “先搜索后绑定”模式下,服务账号异常导致无法定位用户DN。

根因三: 忽视LDAP 49子码含义——525用户不存在、52e密码错误、530不允许登录、532密码过期、701账号过期、773需改密、775账号锁定。

根因四: 域控时间不同步,或账号被AD锁定策略锁定。

1.3.3. 解决方案

步骤一: 确认认证模式(直接绑定 / 先搜索后绑定),核对用户标识字段。

步骤二: 根据49子码定位具体原因(过期/锁定/需改密)并对症处理。

步骤三: 核对服务账号可用性,并授予足够的查询权限。

1.3.4. 配置生效

Plain Text
# 用目标用户直接测试绑定,快速区分密码/账号问题
ldapwhoami -x -H ldap://<域控IP>:389 -D "user@corp.com" -w "<用户密码>"
# 查询账号锁定/过期状态
ldapsearch -x -H ldap://<域控IP>:389 -D "<BindDN>" -w "<密码>" -b "dc=corp,dc=com" "sAMAccountName=\<用户名\>" userAccountControl lockoutTime pwdLastSet

在平台“认证设置”中修正用户标识字段并保存。

1.3.5. 验证方式

ldapwhoami返回正确的用户DN;

平台使用该账号认证通过;

对锁定/过期账号处理后恢复正常登录。

2. 多因素认证MFA(宁盾AM,宁盾令牌APP)

2.1. 宁盾令牌APP扫码绑定/激活失败

2.1.1. 问题现象

现象一: 用户在自助门户/APP扫描绑定二维码后提示“绑定失败/二维码无效/已过期”。

现象二: APP添加令牌后不显示动态码,或显示后立即提示“令牌未激活”。

现象三: 同一用户重复绑定,出现多个令牌或相互覆盖异常。

2.1.2. 问题根因

根因一: 绑定二维码已过期,或手机与服务器时间不一致导致密钥校验失败。

根因二: 用户网络无法访问AM自助服务地址(不可达/证书不受信)。

根因三: 令牌种子下发失败,或AM侧未为该用户分配令牌类型。

根因四: 宁盾令牌APP版本过低,不兼容当前AM协议。

2.1.3. 解决方案

步骤一: 确认AM自助服务地址可访问、证书受信。

步骤二: 刷新二维码后立即扫码,避免超时。

步骤三: 在AM控制台为用户解绑旧令牌并重新分配。

步骤四: 升级宁盾令牌APP至最新版本。

2.1.4. 配置生效

Plain Text
# AM控制台操作
用户管理 -> 目标用户 -> 令牌管理 -> 解绑旧令牌 -> 重新分配软件令牌/TOTP -> 生成绑定二维码
# 校验APP可访问自助服务
curl -l https://<AM地址>/portal # 期望返回 200/302

用户使用宁盾令牌APP重新扫码绑定,看到6位动态码即成功。

2.1.5. 验证方式

APP正常显示连续变化的6位动态码;

使用该动态码可通过一次MFA校验;

AM控制台令牌状态显示“已绑定/正常”。

2.2. 动态口令(OTP)校验失败/提示验证码错误

2.2.1. 问题现象

现象一: 用户输入APP显示的动态码,平台提示“验证码错误/校验失败”。

现象二: 偶发校验失败,重试或输入下一周期的码即可成功。

现象三: 批量用户在同一时间段集中校验失败。

2.2.2. 问题根因

根因一: 手机系统时间与服务器时间偏差超过TOTP允许窗口(时间漂移)。

根因二: 令牌种子不同步(重装/恢复备份导致密钥不一致)。

根因三: AM服务器NTP异常,系统时间漂移。

根因四: TOTP时间步长/容错窗口配置过小。

2.2.3. 解决方案

步骤一: 校准手机时间为自动网络时间。

步骤二: AM服务器同步NTP,修正系统时间。

步骤三: 必要时重新绑定令牌,恢复种子一致。

步骤四: 适当放宽TOTP容错窗口(如±1个周期)。

2.2.4. 配置生效

Plain Text
# 服务器时间校准
timedatectl set-ntp true
ntpdate <NTP服务器> # 或 chronyc makestep
chronyc sources -v # 检查时间同步状态
date # 确认时间准确

在AM“令牌策略”中将时间步长设为30s、漂移容错设为±1个周期并保存。

2.2.5. 验证方式

连续多个周期的动态码均校验通过;

服务器与手机时间一致;

无批量失败告警。

2.3. 短信验证码收不到/下发失败

2.3.1. 问题现象

现象一: 用户选择短信二次认证,长时间收不到验证码。

现象二: 平台提示“短信发送失败”,日志显示网关返回错误码。

现象三: 部分运营商/号段用户收不到,其它用户正常。

2.3.2. 问题根因

根因一: 短信网关账号欠费/密钥失效,或IP白名单未放通AM出口IP。

根因二: 短信模板未报备或被运营商拦截(含敏感词/签名不合规)。

根因三: 用户手机号为空或格式错误(缺国家码)。

根因四: 短信通道并发/频率限制触发限流。

2.3.3. 解决方案

步骤一: 核对短信网关账号状态、密钥与IP白名单。

步骤二: 检查模板报备状态与签名合规性。

步骤三: 校正用户手机号数据(补全为E.164格式)。

步骤四: 调整发送频率与并发,必要时切换备用通道。

2.3.4. 配置生效

Plain Text
# AM控制台测试短信通道
系统设置 -> 短信网关 -> 填写网关地址/AppID/Secret/签名/模板ID -> 发送测试短信
# 获取AM出口公网IP,报备到短信服务商白名单
curl -s https://ifconfig.me

保存网关配置并启用短信认证方式。

2.3.5. 验证方式

测试短信成功收到;

真实用户可正常收到登录验证码;

网关日志无持续失败错误码。

2.4. 用户更换手机/卸载重装APP后令牌丢失

2.4.1. 问题现象

现象一: 用户换机或重装宁盾令牌APP后,原令牌消失,无法生成动态码。

现象二: 用户被卡在MFA环节,无法登录业务系统。

现象三: 未开启自助找回,只能人工处理。

2.4.2. 问题根因

根因一: 软件令牌种子存储在本地,卸载/换机后未迁移,导致密钥丢失。

根因二: 未开启自助重置或备用认证方式(短信/邮箱)供应急。

根因三: AM侧旧令牌未解绑,重新绑定产生冲突。

2.4.3. 解决方案

步骤一: 由管理员或自助流程解绑旧令牌。

步骤二: 为用户重新分配并绑定新令牌。

步骤三: 开启备用认证方式(短信/邮箱OTP),避免单点锁死。

2.4.4. 配置生效

Plain Text
# 管理员操作
AM控制台 -> 用户管理 -> 目标用户 -> 令牌管理 -> 解绑全部旧令牌 -> 重新绑定
# 开启自助重置与备用因子
认证策略 -> 启用“短信/邮箱”作为备用二次认证 -> 启用“自助令牌重置”

用户通过自助门户或联系管理员重新扫码绑定新令牌。

2.4.5. 验证方式

新设备令牌正常出码并通过校验;

旧令牌失效不可用;

备用因子(短信/邮箱)可正常触发。

2.5. 业务系统接入MFA后不触发二次认证/被跳过

2.5.1. 问题现象

现象一: VPN/Windows/Linux/Web等接入MFA后,仅校验一次密码即登录,无二次认证。

现象二: 部分用户触发MFA、部分用户直接放行。

现象三: AM显示认证通过,但业务系统未走完整多步流程。

2.5.2. 问题根因

根因一: 接入侧未正确对接AM的RADIUS/多步认证通道,仅接了密码校验。

根因二: 认证策略未对该应用/用户组启用二次认证,或命中“免二次认证”白名单。

根因三: 走LDAP Bind通道做双因素时,令牌码被整串当作密码校验,导致MFA不生效(应改走RADIUS)。

根因四: 接入端PAM/AAA配置未串联第二因子。

2.5.3. 解决方案

步骤一: 确认业务系统通过RADIUS(而非纯LDAP Bind)对接AM双因素。

步骤二: 在认证策略中对目标应用/用户组启用二次认证,移除误配白名单。

步骤三: 按接入端要求补全多步认证配置(如SSH的ChallengeResponse/KbdInteractive)。

2.5.4. 配置生效

Plain Text
# 认证策略配置
AM控制台 -> 认证策略 -> 目标应用/用户组 -> 启用“二次认证TOTP/短信”
触发条件 : 全部 / 异地 / 新设备
# 说明: 双因素务必走 RADIUS 通道; LDAP Bind 通道不支持外置令牌二次校验

保存策略后,业务系统重新发起一次登录测试。

2.5.5. 验证方式

登录时正确触发二次认证;

输入动态码后完成登录;

命中策略的用户均触发MFA,无越权放行。

3. 网络身份准入

3.1. 802.1X有线准入认证失败、终端无法上线

3.1.1. 问题现象

现象一: 终端接入交换机端口后无法获取网络或被隔离,提示认证失败。

现象二: 交换机日志显示 RADIUS Access-Reject 或无响应。

现象三: 802.1X客户端(supplicant)反复弹出输入框或认证超时。

3.1.2. 问题根因

根因一: 交换机端口未启用802.1X,或dot1x认证模式配置错误。

根因二: RADIUS共享密钥不一致或服务器不可达。

根因三: 终端证书或账号凭据错误(EAP-TLS/PEAP场景证书不受信、过期)。

根因四: 准入平台未授权该终端/账号,或终端不在允许列表。

根因五: VLAN/ACL授权属性下发错误,认证通过但被隔离到受限VLAN。

3.1.3. 解决方案

步骤一: 核对交换机端口dot1x配置与RADIUS服务器组。

步骤二: 核对共享密钥与证书链。

步骤三: 在准入平台确认终端/账号的授权状态。

3.1.4. 配置生效

Plain Text
# 华为交换机端口802.1X(示例)
interface GigabitEthernet0/0/1
dot1x enable
dot1x authentication-method eap
#
radius-server template acc
radius-server shared-key cipher <密钥>
radius-server authentication <准入IP> 1812
# 查看认证状态
display dot1x
display access-user

保存配置(save),终端重新发起802.1X认证。

3.1.5. 验证方式

终端认证成功并进入业务VLAN,可正常上网;

交换机 display access-user 显示在线用户;

准入平台有对应的认证通过记录。

3.2. Portal(网页门户)认证页面无法弹出

3.2.1. 问题现象

现象一: 终端连接网络后浏览器不自动跳转Portal认证页。

现象二: 手动访问任意HTTP地址无法重定向到Portal。

现象三: Portal页面能打开,但提交认证无响应或报错。

3.2.2. 问题根因

根因一: 设备未配置Portal服务器,或未在接口/SSID下启用Portal认证。

根因二: 免认证规则(白名单)范围过大,重定向流量被放行未拦截。

根因三: 终端为HTTPS/APP流量,无法被HTTP重定向捕获。

根因四: Portal服务器地址不可达,或URL/端口配置错误。

3.2.3. 解决方案

步骤一: 核对Portal服务器与认证/计费/门户URL配置。

步骤二: 在接入接口或无线SSID下启用Portal认证。

步骤三: 确认免认证ACL仅放通Portal及DNS/DHCP必需地址。

3.2.4. 配置生效

Plain Text
# 华为Portal配置(示例)
web-auth-server portal
url http://<准入IP>:<端口>/portal
#
interface Vlanif10
web-auth-server portal direct
# 检查
display web-auth-server configuration
display portal

保存后终端重新连接,浏览器访问 http://1.1.1.1 触发重定向。

3.2.5. 验证方式

终端自动跳转到Portal认证页;

输入账号(或短信)认证成功并可上网;

display portal 显示在线Portal用户。

3.3. 无线准入频繁掉线/重复重认证

3.3.1. 问题现象

现象一: 无线终端连接后频繁掉线、需反复认证。

现象二: 认证间隔过短,用户体验差,AP/AC日志出现大量重认证记录。

现象三: 漫游时认证中断。

3.3.2. 问题根因

根因一: 重认证周期(re-authentication)设置过短或强制开启。

根因二: 会话超时/计费间隔(Interim-Accounting)配置不合理导致被下线。

根因三: RADIUS响应慢或丢包,认证超时被判失败。

根因四: 漫游场景下AC间会话/密钥不同步。

3.3.3. 解决方案

步骤一: 调整或关闭过短的重认证周期。

步骤二: 合理设置会话超时与计费间隔。

步骤三: 优化RADIUS可达性与响应,排查网络丢包。

3.3.4. 配置生效

Plain Text
# 华为无线重认证/超时(示例)
vap-profile name office
dot1x re-authenticate
dot1x reauth-period 3600 # 延长重认证周期秒
# RADIUS计费会话超时
radius-server template acc
timer acct-timeout 15
display vap-profile name office

保存配置,无线终端重新关联。

3.3.5. 验证方式

终端长时间保持在线,不频繁掉线;

重认证按设定周期进行;

漫游切换不中断认证。

3.4. 访客准入临时账号无法访问网络/授权失效

3.4.1. 问题现象

现象一: 访客获取临时账号/短信后仍无法上网。

现象二: 访客认证通过但只能访问受限区域,或立即掉线。

现象三: 临时账号过期后仍可使用,或未按时回收。

3.4.2. 问题根因

根因一: 访客授权策略(可访问范围/带宽/时长)配置错误或未下发。

根因二: 访客账号有效期与Portal/短信下发不一致。

根因三: 访客VLAN/ACL未正确放通到目标区域。

根因四: 并发数/账号复用限制触发拒绝。

3.4.3. 解决方案

步骤一: 核对访客授权模板(时长、带宽、可访问网段)。

步骤二: 确认访客VLAN与ACL放通策略。

步骤三: 校准账号有效期与回收机制。

3.4.4. 配置生效

Plain Text
# 准入平台访客策略(示例)
认证方式 : 短信 / 扫码 / 审批
有效期 : 8小时 带宽 : 5Mbps 可访问 : 仅互联网
下发属性 : Tunnel-Type=VLAN, Tunnel-Private-Group-ID=<访客VLAN>
# 交换机侧确认访客VLAN放通
display current-configuration configuration vlan <访客VLAN>

保存策略,访客重新认证接入。

3.4.5. 验证方式

访客认证成功并进入访客VLAN;

可访问互联网、无法访问内网敏感区;

到期后账号自动失效下线。

3.5. 准入通过后VLAN下发/ACL授权不生效

3.5.1. 问题现象

现象一: 终端认证通过但被分到错误VLAN或默认VLAN,无法访问目标资源。

现象二: 授权ACL未生效,终端权限与预期不符。

现象三: 不同用户组下发结果相同,未按角色区分。

3.5.2. 问题根因

根因一: RADIUS授权属性(Tunnel-Type/Tunnel-Medium-Type/Tunnel-Private-Group-ID 或 Filter-Id)未正确返回。

根因二: 交换机未开启授权VLAN/ACL下发功能,或不支持对应属性。

根因三: 准入平台角色-VLAN/ACL映射未配置或配置错误。

根因四: 目标VLAN未在交换机创建,或ACL未定义。

3.5.3. 解决方案

步骤一: 核对平台角色到VLAN/ACL的映射与下发属性。

步骤二: 在交换机启用授权VLAN下发,并预建VLAN/ACL。

步骤三: 抓包确认Access-Accept携带正确的授权属性。

3.5.4. 配置生效

Plain Text
# 交换机启用授权VLAN下发(华为示例)
interface GigabitEthernet0/0/1
dot1x enable
# 平台侧RADIUS返回属性(示例)
Tunnel-Type = VLAN13
Tunnel-Medium-Type = 8026
Tunnel-Private-Group-ID = <目标VLAN ID>
# 抓包核对
tcpdump -i any udp port 1812 -A -c 20
display access-user username <用户名>

保存平台映射与交换机配置,终端重新认证。

3.5.5. 验证方式

终端进入正确VLAN并可访问授权资源;

不同角色下发不同的VLAN/ACL;

Access-Accept报文中授权属性正确。

4. SSO单点登录

4.1. 单点登录跳转循环、会话无法保持(重复登录)

4.1.1. 问题现象

现象一: 登录门户后点击应用又跳回登录页,形成循环。

现象二: 每个应用都要求重新登录,未实现单点。

现象三: 浏览器提示Cookie被阻止或存在第三方Cookie问题。

4.1.2. 问题根因

根因一: 会话Cookie未正确写入(域/Secure/SameSite配置不当)或被浏览器拦截。

根因二: 门户与应用时钟不一致,导致票据/断言立即过期。

根因三: 应用侧未正确校验SSO票据(ticket/assertion),反复重定向。

根因四: 跨域/反向代理场景下回调地址与Cookie域不匹配。

4.1.3. 解决方案

步骤一: 核对Cookie的域、Secure、SameSite设置,允许必要的跨站。

步骤二: 统一门户与应用时间(NTP)。

步骤三: 核对应用回调/信任配置。

4.1.4. 配置生效

Plain Text
# 会话Cookie(示例)
Cookie Domain = .corp.com
Secure = true HTTPS SameSite = None/Lax 按跨站需求
# 时间同步
chronyc makestep ; date
# 浏览器侧: 允许第三方Cookie / 将门户与应用加入可信站点

保存会话配置,清空浏览器Cookie后重新登录门户。

4.1.5. 验证方式

登录门户后点击多个应用无需再次登录;

无跳转循环;

会话在有效期内保持。

4.2. CAS/OAuth2.0/OIDC应用对接回调地址报错

4.2.1. 问题现象

现象一: 从门户点击OAuth/OIDC/CAS应用,提示“redirect_uri不匹配/invalid client/回调地址错误”。

现象二: 应用报“client_id/client_secret无效”或“scope不支持”。

现象三: CAS应用提示ticket校验失败或服务未授权。

4.2.2. 问题根因

根因一: 应用注册的redirect_uri与平台配置不完全一致(协议/域名/端口/路径/结尾斜杠)。

根因二: client_id/client_secret填错,或已重置未同步。

根因三: 授权类型/协议版本不匹配(如应用用OIDC,平台配成OAuth)。

根因四: CAS service地址未加入允许列表。

4.2.3. 解决方案

步骤一: 逐字符核对redirect_uri/CAS service与平台配置。

步骤二: 重新生成并同步client凭据。

步骤三: 确认协议类型与scope一致。

4.2.4. 配置生效

Plain Text
# OIDC/OAuth2 应用注册(示例)
Client ID : <平台生成>
Client Secret : <平台生成>
Redirect URI : https://app.corp.com/oauth/callback 必须完全一致
Scope : openid profile
# CAS
Service URL 白名单 : https://app.corp.com/*

在平台“应用管理”保存后,用应用发起一次授权码流程测试。

4.2.5. 验证方式

授权跳转不再报redirect_uri错误;

成功返回code/id_token并完成登录;

CAS ticket校验通过。

5. 网络设备AAA

5.1. 网络设备SSH/Telnet AAA认证失败

5.1.1. 问题现象

现象一: 运维人员SSH/Telnet登录设备(交换机/路由器/防火墙)提示认证失败或Connection refused。

现象二: 设备日志显示 AAA authentication failed / Radius server unreachable / No response from AAA server。

现象三: 本地账号可登录,但AAA集中认证账号无法登录。

5.1.2. 问题根因

根因一: 宁盾AAA(RADIUS)服务器不可达——网络不通、服务未启动或端口被防火墙拦截。

根因二: 共享密钥不一致,Radius报文签名校验失败被静默丢弃。

根因三: 设备AAA方案/域配置错误,未绑定正确的RADIUS服务器组。

根因四: 用户账号未在AAA平台注册或未授权该设备/设备组,返回Access-Reject。

根因五: 报文源地址与AAA配置的NAS-IP不匹配,服务器拒绝处理。

5.1.3. 解决方案

步骤一: 验证AAA服务可达性(RADIUS端口1812)。

步骤二: 核对两端共享密钥完全一致。

步骤三: 检查AAA方案与域绑定、服务器组配置。

步骤四: 在AAA平台确认用户已注册并授权目标设备。

5.1.4. 配置生效

Plain Text
# 宁盾AAA服务器确认服务状态
systemctl status radius
ss -tlnp | grep -E "1812|1813"
# 设备侧测试连通华为 / 思科
test aaa-server radius <server-group> <username> <password>
test aaa group radius <group> <username> <password> legacy
# 核对共享密钥
display current-configuration | include radius-server shared-key # 华为
show running-config | include key # 思科

修正配置后执行 save / write memory 保存。

5.1.5. 验证方式

使用AAA账号SSH登录设备成功;

AAA控制台认证日志记录完整(用户名、NAS-IP、时间、结果);

错误密码测试返回拒绝,且日志记录失败原因。

5.2. 设备命令授权异常(TACACS+/Radius Authorization)

5.2.1. 问题现象

现象一: 通过AAA认证登录设备后,执行某些命令被拒绝,提示 Permission denied / Command authorization failed。

现象二: 不同角色用户登录后命令权限无差异(均为最高或均为最低)。

现象三: 授权日志中无对应命令的授权记录,疑似请求未到达AAA服务器。

5.2.2. 问题根因

根因一: 设备侧未启用命令授权(authorization),仅配置了认证(authentication)。

根因二: AAA平台命令授权策略未配置,或角色映射规则缺失。

根因三: 厂商自定义属性(VSA)格式/编号与平台模板不匹配,设备无法解析。

根因四: TACACS+与Radius授权混用,协议不一致导致请求无响应。

根因五: 命令级别(privilege level)映射错误。

5.2.3. 解决方案

步骤一: 确认设备侧启用命令授权并绑定服务器组。

步骤二: 在AAA平台按角色配置命令白/黑名单。

步骤三: 核对厂商VSA/属性映射与协议类型一致。

5.2.4. 配置生效

Plain Text
# 华为设备查看AAA授权配置
display current-configuration configuration aaa
# 确认包含 authorization-scheme / command-authorization
# 思科设备
show running-config | section aaa
# 确认包含 aaa authorization commands / exec
# AAA平台按角色配置命令授权策略并绑定用户组/设备组

保存配置,用不同角色账号重新登录测试。

5.2.5. 验证方式

只读角色可执行display/show、config类命令被拒绝;

管理员角色可执行所有命令;

AAA授权日志记录每条命令的内容、结果、时间。

5.3. 审计日志缺失或记账(Accounting)失败

5.3.1. 问题现象

现象一: 运维登录设备并操作,但AAA审计日志无对应记录,无法满足等保/审计要求。

现象二: 部分设备有日志、部分完全无,且无规律。

现象三: 仅有登录/登出记录,缺少中间命令执行记录。

现象四: Accounting报文发送失败,设备日志报 Accounting send failed / No response。

5.3.2. 问题根因

根因一: 设备侧未配置Accounting(记账),仅配了认证与授权。

根因二: Accounting报文端口(UDP 1813)被防火墙拦截或中间设备未放行。

根因三: AAA平台Accounting服务未启动或监听异常。

根因四: Accounting方案未绑定正确服务器组,报文发往错误地址。

根因五: 命令级审计(command accounting)未启用,仅发会话级记账。

根因六: 平台日志存储满或数据库写入异常,新日志无法入库。

5.3.3. 解决方案

步骤一: 确认并启用设备Accounting及命令级审计。

步骤二: 放行UDP 1813(或TACACS+ TCP 49)。

步骤三: 检查AAA平台记账服务、磁盘与数据库状态。

5.3.4. 配置生效

Plain Text
# 华为启用命令级审计(示例)
aaa
accounting-scheme <name>
accounting-mode hwtacacs # 或 radius
command-accounting # 启用逐命令记账
#
domain <name>
accounting-scheme <name>
# 平台侧抓包确认报文到达
tcpdump -i eth0 udp port 1813 -c 10 # RADIUS Accounting
tcpdump -i eth0 tcp port 49 -c 10 # TACACS+
# 检查存储与端口放行
df -h ; firewall-cmd --list-ports

save 保存设备配置,重启记账相关服务。

5.3.5. 验证方式

SSH登录设备执行若干命令后退出;

AAA审计日志可查到该用户/设备的登录、登出及每条命令与时间戳;

导出审计报告满足等保三级/SOX要求。

5.4. AAA服务器主备切换/高可用失效导致认证中断

5.4.1. 问题现象

现象一: 主AAA服务器故障或维护重启时,设备认证全部中断,无法登录。

现象二: 设备未自动切换到备用服务器,或切换后仍失败。

现象三: 主备恢复后认证状态不一致(授权/会话丢失)。

5.4.2. 问题根因

根因一: 设备侧仅配置单台RADIUS服务器,未配备用或服务器组无备份成员。

根因二: 主备服务器的用户/授权数据未同步,切换后账号缺失。

根因三: 健康检查/超时参数不合理,故障探测过慢。

根因四: 共享密钥/NAS配置在主备之间不一致。

5.4.3. 解决方案

步骤一: 设备侧配置RADIUS服务器组,包含主备并设置优先级。

步骤二: AAA平台部署主备/集群并启用数据同步。

步骤三: 调整超时与重试参数,加快故障切换。

5.4.4. 配置生效

Plain Text
# 华为RADIUS主备服务器组(示例)
radius-server template acc
radius-server authentication <主IP> 1812 weight 100
radius-server authentication <备IP> 1812 weight 50
radius-server retransmit 2
radius-server timeout 5
# 思科
aaa group server radius GRP
server <主IP> auth-port 1812
server <备IP> auth-port 1812
display radius-server configuration

save 保存,模拟停止主服务观察切换。

5.4.5. 验证方式

停止主AAA服务,设备自动切换到备机,认证不中断;

主备用户/授权数据一致;

恢复主服务后状态正常。

5.5. AAA认证响应慢/超时(时延与性能问题)

5.5.1. 问题现象

现象一: 登录设备时认证等待时间长,偶发超时失败。

现象二: 高峰时段大批设备认证变慢或丢包。

现象三: 设备日志出现 RADIUS timeout / server not responding,但最终又能成功。

5.5.2. 问题根因

根因一: AAA服务器负载高(CPU/内存/连接数打满)或数据库慢查询。

根因二: 网络时延/丢包,跨机房或链路拥塞。

根因三: 设备侧超时(timeout)与重试(retransmit)参数过小。

根因四: AAA平台后端身份源(如LDAP)响应慢。

5.5.3. 解决方案

步骤一: 排查AAA服务器资源与数据库性能。

步骤二: 优化网络链路,排查丢包与时延。

步骤三: 合理调大设备超时与重试参数。

步骤四: 优化后端身份源查询(缓存/索引)。

5.5.4. 配置生效

Plain Text
# AAA服务器性能排查
top ; free -m ; ss -s
systemctl status radius
# 网络时延与丢包
ping <AAA_IP> ; mtr <AAA_IP>
# 设备侧调整超时/重试华为示例
radius-server template acc
radius-server timeout 5
radius-server retransmit 3

save 保存设备参数,观察高峰期认证耗时。

5.5.5. 验证方式

认证响应时间恢复正常(秒级内);

高峰期无明显超时/丢包;

AAA服务器资源占用处于合理水位。

上一个
排障手册
下一个
开发对接文档
最近修改: 2026-11-06