检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何开发映射脚本 OneAccess支持将企业的组织与用户属性映射至应用系统。可通过映射脚本自动生成应用的属性值,同时,可限制映射至应用的属性值。 下面将为您介绍如何开发映射定义的脚本。 代码规则 在编写映射脚本时,OneAccess对脚本做了一些限制。
常规配置 常规配置,即同步时的映射关系。 在同步集成页面,选择“常规配置”页签,默认启用常规配置,其配置映射关系包括删除账号、删除机构、禁用账号、禁用机构。
映射配置 映射配置,即认证成功后需要返回给应用的属性,以建立OneAccess与应用侧属性的映射关系。包括添加映射、编辑映射、删除映射。 添加映射 以SAML协议为例,说明添加映射的方法。 选择“映射配置”页签,单击“添加映射”,填写映射信息,单击“保存”映射添加完成。
授予用户权限后,如需用户携带权限信息返回给应用系统,需配置映射,具体可参考映射配置。 应用侧权限根据授权的精细程度分为基于角色和基于角色、权限、资源的权限管理。 基于角色的应用权限管理 根据用户的工作职能定义权限的一种粗粒度授权机制。
映射定义 选择“映射定义”页签,单击“编辑”,配置账号属性的映射关系。为了避免同步异常,建议添加的账号属性与需要映射的用户属性类型保持一致。 表2 映射参数 参数 说明 系统用户 映射至应用账号的用户属性,可在下拉框选择。
local为IAM本地的信息,其中user为IAM的用户信息,其中的name为展示的子用户名称,{0}取remote中的第一个字段。group为IAM的用户组信息,表示所有用户都映射到admin的用户组,拥有其所有权限。
管理应用账号 管理OneAccess用户与应用侧账号之间的绑定关系,即一个OneAccess用户可以对应多个不同应用系统的应用账号,实现一对多的映射关系。 如果已配置同步参数,且同步正常时,添加、通过授权策略新增和删除、编辑、删除、启用、禁用应用账号会触发向下游应用的同步操作。
在SAML认证源页面,单击右上方的“SP元数据”,数据会自动下载到本地。 将1.c获取的文件上传到企业IdP服务器上,不同企业idP服务器,上传方法不同,具体请参考相应IdP提供商的帮助文档。 获取企业IdP的元数据文件。
local为IAM本地的信息,其中user为IAM的用户信息,其中的name为展示的子用户名称,{0}为取remote中的第一个字段。group为IAM的用户组信息,表示所有用户都映射到admin的用户组,拥有其所有权限。
如果您需要同时映射其他属性,如邮箱,可以设置“未关联用户时”为“自动创建用户”,通过“添加映射”完成。可参考表2。 表2 映射参数 参数 说明 用户属性名 WeLink对接OneAccess的映射属性,可在下拉框选择,如邮箱。
如果您需要同时映射其他属性,如姓名,可以设置“未关联用户时”为“自动创建用户”,通过单击“添加映射”完成。可参考表2。 表2 映射参数 参数 说明 用户属性名 OAuth应用对接OneAccess的映射属性,可在下拉框选择,如姓名。
配置OneAccess与华为云之间的映射关系。 单击已添加的华为云应用,在应用信息页面,单击应用图标,进入应用详情页面。 选择“认证集成 > 映射配置”,进入映射配置页面。
设置映射规则。 在“映射定义”页签,单击“编辑”,通过设置转换方式、脚本表达方式、执行方式、系统用户设置映射规则。 其中: 执行方式:设置属性在哪种情形下需要映射。 不映射:不会同步该属性至OneAccess。 创建:只有在创建的时候会同步该属性。
映射类型 OneAccess与飞书之间用户属性的映射方式,可在下拉框选择。 说明: 当选择“映射类型”为“认证源属性”时,需要同时输入“认证源属性名”。 当选择“映射类型”为“固定属性值”时,需要同时输入“固定属性值”。
映射类型 OneAccess与eteams之间用户属性的映射方式,可在下拉框选择。 说明: 当选择“映射类型”为“认证源属性”时,需要同时输入“认证源属性名”。 当选择“映射类型”为“固定属性值”时,需要同时输入“固定属性值”。
在映射定义页签,单击“编辑”,设置机构属性的映射方式。 当映射定义的转换方式选择脚本转换时,脚本编写请参考如何开发映射脚本。 为了避免同步异常,建议添加的机构属性与需要映射的组织属性类型保持一致。 表3 映射参数 参数 说明 组织 映射至应用机构的组织属性,可在下拉框选择。
映射定义 飞书与OneAccess用户数据同步时的映射规则,支持脚本转换。 机构对象 属性定义 飞书身份源的组织属性。 映射定义 飞书与OneAccess组织数据同步时的映射规则,支持脚本转换。 添加属性。 在“属性定义”页签,单击“添加”,弹出“添加属性”弹框。
表3 映射参数 参数 说明 用户属性名 LDAP对接OneAccess的映射属性,可在下拉框选择。 映射类型 OneAccess与LDAP之间用户属性的映射方式,可在下拉框选择。 说明: 当选择“映射类型”为“认证源属性”时,需要同时输入“认证源属性名”。
映射定义 薪人薪事与OneAccess用户数据同步时的映射规则,支持脚本转换。 机构对象 属性定义 薪人薪事身份源的组织属性。 映射定义 薪人薪事与OneAccess组织数据同步时的映射规则,支持脚本转换。 添加属性。 在“属性定义”页签,单击“添加”,弹出“添加属性”弹框。
如果您需要同时映射其他属性,如姓名,可以设置“未关联用户时”为“自动创建用户”,通过单击“添加映射”完成。可参考表2。 表2 映射参数 参数 说明 用户属性名 OIDC应用对接OneAccess的映射属性,可在下拉框选择,如姓名。