iPaaS文档库 iPaaS文档库
00 概述
01 产品安装指南
02 快速入门指南
03 Studio使用指南
04 iPaaS使用指南
05 高级配置指南
06 接口服务说明
07 升级&数据迁移指南
08 产品集成指南
09 FAQ
10 iPaaS上线指南
运维指南
  • 新增角色或账号问题排查
  • 问题一:角色权限不生效
  • 问题现象
  • 分析
  • 解决方案
  • 总结
  • 问题二:组织中心访问无权限
  • 问题现象
  • 分析
  • 解决方案
  • 总结
  • 问题三:新建用户无法查看API市场接口信息
  • 问题现象
  • 分析
  • 解决方案
  • 总结
  • 问题四:微服务环境新增员工账号登录报错
  • 问题现象
  • 分析
  • 解决方案
  • 总结

# 新增角色或账号问题排查

# 问题一:角色权限不生效

# 问题现象

在admin账号给新建角色描述中加上system-role字段后,使用manager账号可以在系统管理添加角色进行勾选,但是实际分配后角色的权限没有生效。

# 分析

角色权限未生效的主要原因是角色编号命名不规范。系统中角色识别依赖于角色编号的命名规则,如果新建角色没有遵循原有的命名前缀规范,系统可能无法正确识别该角色与原有权限的继承关系。

# 解决方案

创建角色时,必须使用原角色的角色编号作为前缀。例如:

  • 开发方角色自带的角色编号:esb-developer
  • 新增开发方角色命名:esb-developer-test
  • 同时在描述中增加:system-role

# 总结

角色编号前缀是系统识别角色权限继承关系的关键标识,必须严格遵循命名规范。描述中添加system-role字段是辅助标识,但核心在于角色编号的正确命名。


# 问题二:组织中心访问无权限

# 问题现象

新建角色后,访问组织中心-组织管理时报无权限,提示缺少afc-f-dimension-query权限。

# 分析

afc-f-dimension-query是组织维度查询相关的权限代码。新建角色默认不包含任何权限,需要手动为角色授权才能访问相应的功能模块。

# 解决方案

  1. 进入应用中心-角色管理
  2. 搜索afc-f-dimension-query权限
  3. 为新建角色勾选并授权该权限(如图所示)

# 总结

新建角色是一个空权限角色,需要根据业务需求手动分配相应的功能权限。遇到无权限报错时,可根据提示的权限代码在角色管理中搜索并授权。


# 问题三:新建用户无法查看API市场接口信息

# 问题现象

系统自带用户登录后可以在API市场显示接口信息,但新建的用户登录后不展示接口信息。

# 分析

API市场接口信息的查看权限受资源权限控制。新建用户默认没有分配API接口的查看权限,需要在资源权限配置中进行单独授权。

# 解决方案

在管理门户-配置管理-资源权限中,为新建角色或账户添加接口权限。

# 总结

API市场接口权限属于独立的资源权限体系,需要单独配置。用户创建完成后,需检查并分配相应的接口查看权限,才能正常访问API市场信息。


# 问题四:微服务环境新增员工账号登录报错

# 问题现象

微服务环境中,新增员工账号后,登录页面报错:"服务器内部错误, 请联系管理员!"。后台日志显示:

org.springframework.web.client.ResourceAccessException: I/O error on POST request for "http://BPS-SERVER/bps/opr/worklist-query/query-person-work-items-with-info-in-task-center": BPS-SERVER; nested exception is java.net.UnknownHostException: BPS-SERVER

# 分析

  1. AFC默认创建员工时会自动赋予"普通用户"角色
  2. 该角色包含BPS(业务流程服务)相关的权限
  3. 微服务环境中,ESB产品未使用BPS组件,未搭建BPS服务
  4. 登录时系统尝试调用BPS服务接口,但BPS-SERVER服务不存在,导致请求失败

# 解决方案

删除新建员工自带的"普通用户"角色:

  1. admin登录,进入组织中心-机构管理-员工信息
  2. 找到该员工账号
  3. 移除"普通用户"角色

# 总结

在微服务架构下,不同产品使用的服务组件可能不同。AFC默认分配的角色可能包含未部署服务的权限,需要根据实际部署的服务组件情况,清理不必要的角色权限,避免登录时调用不存在的服务导致错误。

← API测试时凭证问题 iPaaS-API编排处理后报文传递问题 →