检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
以插件代填的方式集成应用 OneAccess可在PC端集成不支持标准协议（OAuth2、SAML、OIDC、CAS）且不可改造的应用。 本文主要介绍OneAccess以插件代填的方式集成应用。 配置流程 前提条件 请确保您已拥有OneAccess管理门户的访问权限。 在OneAccess中添加企业应用
通过事件回调方式同步数据至应用 准备工作 调用说明 API 公共返回码
调用说明 接口调用说明 签名验签说明 验证回调地址 父主题： 通过事件回调方式同步数据至应用
API 概述 新增组织事件 修改组织事件 删除组织事件 新增用户事件 修改用户事件 删除用户事件 父主题： 通过事件回调方式同步数据至应用
概述 同步组织数据的前提是开启应用机构，可参考7。 本章节的业务事件的消息示例前提是企业应用开启签名和数据加密。 父主题： API
公共返回码 事件回调接口采用HTTP状态码表示操作结果成功或者失败。企业应用的回调服务参考以下错误码及错误提示进行返回，OneAccess将返回的错误码和错误信息保存到应用同步记录中。 表1 公共返回码 返回码code 说明 200 success。 400 参数XX已存在，如参数userName已存在。
为了避免同步异常，建议添加的机构属性与需要映射的组织属性类型保持一致。 表3 映射参数 参数 说明 组织 映射至应用机构的组织属性，可在下拉框选择。 转换方式 组织属性与应用机构之间的映射方式，可在下拉框选择。 脚本表达式 转换方式为脚本转换时，填写具体的映射脚本。 执行方式 组织属性与应用
回码。 message String 处理出错时的错误原因说明。 data String 返回的消息体。不同的业务回调要求返回不同内容，比如回复空串，或者要求的业务数据。 当未开启加密时，返回明文的消息体。 当开启加密时，返回加密的消息体，需要解密得到消息内容，解密后有rando
扩展属性1，企业扩展的用户属性，以实际情况为准。 extAttr2 否 -- 扩展属性2，企业扩展的用户属性，以实际情况为准。 响应参数 表2 响应参数 参数 参数类型 描述 id String(50) 下游企业应用创建用户成功后，生成的用户ID，并回传至OneAccess，作为该用户的唯一标识。
传至OneAccess，作为该用户的唯一标识。 响应参数 表2 请求参数 参数 参数类型 描述 code String 返回code码，200表示成功。 message Integer 处理出错时的错误原因说明。 请求示例 启用消息签名和加密的请求示例： { "nonce": "AmgjjEAJbrMzWmUw"
传至OneAccess，作为该机构的唯一标识。 响应参数 表2 响应参数 参数 参数类型 描述 code String 返回code码，200表示成功。 message Integer 处理出错时的错误原因说明。 请求示例 启用消息签名和加密的请求示例： { "nonce": "AmgjjEAJbrMzWmUw"
String(50) 下游企业应用创建机构成功后，生成的机构ID，并回传至OneAccess，作为该机构的唯一标识。 在修改、删除机构时，传递id至下游应用，需下游应用保持一致，如果不一致，后面接口返回的id会覆盖之前的id。 请求示例 启用消息签名和加密的请求示例： { "nonce": "AmgjjEAJbrMzWmUw"
扩展属性1，企业扩展的用户属性，以实际情况为准。 extAttr2 否 -- 扩展属性2，企业扩展的用户属性，以实际情况为准。 响应参数 表2 响应参数 参数 参数类型 描述 id String(50) 与表1中的id一致。 当下游企业应用更新用户成功后，回传至OneAccess的用户ID。
参数类型 描述 id String(50) 与表1中的id一致。 当下游企业应用更新机构成功后，回传至OneAccess的机构ID。 需下游应用保持一致，如果不一致，后面接口返回的id会覆盖之前的id。 请求示例 启用消息签名和加密的请求示例： { "nonce": "AmgjjEAJbrMzWmUw"
当未开启加密时，返回请求包体中的明文随机字符串。 当开启加密时，对请求包体中加密的随机字符串进行解密，返回重新加密的该随机字符串的值，需要解密得到消息内容，解密后有random、msg二个字段，其中msg即为明文消息内容。 请求示例 未启用消息签名和加密的请求示例： { "nonce":
签名验签说明 当OneAccess同步数据至企业应用时，需要企业应用对该同步事件进行识别并确认，确保事件来源的安全性和可靠性，从而保证数据在一个安全的环境中进行交互。 签名校验/加解密术语 表1 术语 术语 说明 signature 消息签名，用于验证请求是否来自OneAcces
OneAccess支持对每个应用配置独立的登录认证方式，包括网站应用、移动应用、公众号。 网站应用 配置企业用户从PC端通过浏览器访问应用时的登录认证方式。开启认证方式的前提是添加相应认证源，具体可参考集成认证源。 AD、LDAP认证会占用密码登录方式的输入框，故密码认证、AD认证、LDAP认证只允许同时开启一种。
OneAccess平台集成的应用系统。您可以在OneAccess平台中配置FIDO2认证源，在登录页面选择FIDO2登录方式登录各应用系统，从而实现单点登录的效果，在给用户带来更简易便捷的登录方式的同时提供更安全可靠的登录体验。 配置流程 该配置流程以用户PC端访问用户门户为例，
OneAccess同时支持本地认证和第三方认证机制，客户在配置认证方式时，建议选择安全的认证方式，如因客户选择的不安全认证方式导致安全事故，且事故后无法清晰界定责任的，华为云将不承担任何责任。 下面以Welink为例说明个人社交认证的配置方法。如需了解认证源配置方法，请参考集成认证源。 添加认证源
应用标识，注册应用后，分配的ClientId。 redirect_uri 是 String 回调地址，表示应用接收OneAccess Token（ID Token或Access Token）的地址。地址可以是注册应用时填写的回调地址，也可以是注册应用时填写的回调地址的域名。 response_type
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
