检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
通过事件回调方式同步数据至应用 准备工作 调用说明 API 公共返回码
API 概述 新增组织事件 修改组织事件 删除组织事件 新增用户事件 修改用户事件 删除用户事件 父主题： 通过事件回调方式同步数据至应用
调用说明 接口调用说明 签名验签说明 验证回调地址 父主题： 通过事件回调方式同步数据至应用
概述 同步组织数据的前提是开启应用机构，可参考7。 本章节的业务事件的消息示例前提是企业应用开启签名和数据加密。 父主题： API
准备工作 OneAccess提供身份数据同步的功能，数据同步的关系模型可以理解为“上游—中游—下游”。其中“上游”指各种核心身份源，例如钉钉、企业微信、HR系统、也可以是OneAccess本身的身份管理模块，“中游”即OneAccess，“下游”指各类需要和上游保持同步的应用系统。
公共返回码 事件回调接口采用HTTP状态码表示操作结果成功或者失败。企业应用的回调服务参考以下错误码及错误提示进行返回，OneAccess将返回的错误码和错误信息保存到应用同步记录中。 表1 公共返回码 返回码code 说明 200 success。 400 参数XX已存在，如参数
新增组织事件 通过该接口将新增的组织同步至应用系统。 URL POST https://{app_domain}/callback 请求头 Authorization: Bearer {access_token} 请求参数 以下请求参数以企业实际配置的机构属性为准，企业管理员可以参考
删除组织事件 通过该接口将删除的组织同步至应用系统。 URL POST https://{app_domain}/callback 请求头 Authorization: Bearer {access_token} 请求参数 表1 请求参数 参数 参数类型 描述 id String
新增用户事件 通过该接口将新增的用户同步至应用系统。 URL POST https://{app_domain}/callback 请求头 Authorization: Bearer {access_token} 请求参数 以下请求参数以企业实际配置的身份同步参数为准，企业管理员可以参考
删除用户事件 通过该接口将删除的用户同步至应用系统。 URL POST https://{app_domain}/callback 请求头 Authorization: Bearer {access_token} 请求参数 表1 请求参数 参数 参数类型 描述 id String
修改组织事件 通过该接口将更新的组织同步至应用系统。 URL POST https://{app_domain}/callback 请求头 Authorization: Bearer {access_token} 请求参数 表1 请求参数 参数 固定参数 参数类型 描述 id 是
接口调用说明 接口格式 OneAccess同步事件回调接口的请求方式为POST，数据编码为UTF-8，数据格式为JSON。 如果应用系统接收事件回调的URL为 https://{app_domain}/callback，当OneAccess的企业发生组织机构或用户变动时，OneAccess
修改用户事件 通过该接口将更新的用户同步至应用系统。 URL POST https://{app_domain}/callback 请求头 Authorization: Bearer {access_token} 请求参数 表1 请求参数 参数 固定参数 参数类型 描述 id 是
签名验签说明 当OneAccess同步数据至企业应用时，需要企业应用对该同步事件进行识别并确认，确保事件来源的安全性和可靠性，从而保证数据在一个安全的环境中进行交互。 签名校验/加解密术语 表1 术语 术语 说明 signature 消息签名，用于验证请求是否来自OneAccess
验证回调地址 如果企业应用接收事件推送的URL为https://{app_domain}/callback。当企业管理员在保存回调配置信息时，OneAccess会发送一条验证事件到填写的URL回调服务。 URL POST https://{app_domain}/callback
修改应用机构 功能介绍 修改应用机构。 接口约束 无 URI PUT /api/v2/tenant/applications/{application_id}/organizations/{org_id} 表1 路径参数 参数 是否必选 参数类型 描述 application_id
使用前必读 OneAccess使用对象有企业管理员和普通用户两种。 企业管理员：主账号或拥有OneAccess管理权限的用户。企业管理员负责用户（组）、组织、应用、及API等实体的管理。如果您是企业管理员，请参考企业管理员指南使用OneAccess。 普通用户：企业应用使用者，包含企业员工
管理公共账号 公共账号是面向“多人使用一个账号的”场景，当企业应用需要配置一个公共账号供多人使用时，可以通过“责任人”授权“使用者”对该账号进行管理。其中，责任人对公共账号的管理可参考公共账号。 如果已配置同步参数，且同步正常时，添加、编辑、删除公共账号会触发向下游应用的同步操作。
添加应用 OneAccess提供自建应用和预集成应用的添加，您可以根据企业需要添加。 添加自建应用 自建应用指企业的自研应用、不在预集成应用列表中的SaaS类或商业应用等。 登录OneAccess管理门户。 在导航栏中，单击“资源 > 应用”。 在企业应用页面，单击自建应用下的“添加自建应用
集成企业微信身份源 OneAccess支持通过企业微信身份源导入用户和组织信息，实现OneAccess实时同步企业微信身份源中用户和组织信息。 本文主要介绍OneAccess集成企业微信身份源的方法。 配置流程 图1 配置流程 前提条件 请确保您已拥有企业微信开放平台账号管理员权限
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
