检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何开发映射脚本 OneAccess支持将企业的组织与用户属性映射至应用系统。可通过映射脚本自动生成应用的属性值，同时，可限制映射至应用的属性值。 下面将为您介绍如何开发映射定义的脚本。 代码规则 在编写映射脚本时，OneAccess对脚本做了一些限制。
通过事件回调方式同步数据至应用 准备工作 调用说明 API 公共返回码
调用说明 接口调用说明 签名验签说明 验证回调地址 父主题： 通过事件回调方式同步数据至应用
接口调用说明 接口格式 OneAccess同步事件回调接口的请求方式为POST，数据编码为UTF-8，数据格式为JSON。 如果应用系统接收事件回调的URL为 https://{app_domain}/callback，当OneAccess的企业发生组织机构或用户变动时，OneAccess
添加预集成应用 预集成应用指OneAccess根据应用的开发接口、相应协议已提前集成的应用。 登录OneAccess管理门户。 在导航栏中，单击“资源 > 应用”。 在企业应用页面，单击预集成应用下的“新增预集成应用”。 在新增预集成应用页面，单击需要的预置应用。
API 概述 新增组织事件 修改组织事件 删除组织事件 新增用户事件 修改用户事件 删除用户事件 父主题： 通过事件回调方式同步数据至应用
验证回调地址 如果企业应用接收事件推送的URL为https://{app_domain}/callback。当企业管理员在保存回调配置信息时，OneAccess会发送一条验证事件到填写的URL回调服务。 URL POST https://{app_domain}/callback
签名验签说明 当OneAccess同步数据至企业应用时，需要企业应用对该同步事件进行识别并确认，确保事件来源的安全性和可靠性，从而保证数据在一个安全的环境中进行交互。 签名校验/加解密术语 表1 术语 术语 说明 signature 消息签名，用于验证请求是否来自OneAccess
当映射定义的转换方式选择脚本转换时，脚本编写请参考如何开发映射脚本。 为了避免同步异常，建议添加的机构属性与需要映射的组织属性类型保持一致。 表3 映射参数 参数 说明 组织 映射至应用机构的组织属性，可在下拉框选择。
在应用开发页面，创建轻应用并填写表单信息。创建完成后，在基本信息中获取client_id、client_secret。 图1 创建轻应用 图2 填写表单信息 在版本管理页面，分别设置首页地址、接口权限、应用管理地址。 设置首页地址。
新增用户事件 通过该接口将新增的用户同步至应用系统。 URL POST https://{app_domain}/callback 请求头 Authorization: Bearer {access_token} 请求参数 以下请求参数以企业实际配置的身份同步参数为准，企业管理员可以参考
删除用户事件 通过该接口将删除的用户同步至应用系统。 URL POST https://{app_domain}/callback 请求头 Authorization: Bearer {access_token} 请求参数 表1 请求参数 参数 参数类型 描述 id String
公共返回码 事件回调接口采用HTTP状态码表示操作结果成功或者失败。企业应用的回调服务参考以下错误码及错误提示进行返回，OneAccess将返回的错误码和错误信息保存到应用同步记录中。 表1 公共返回码 返回码code 说明 200 success。 400 参数XX已存在，如参数
概述 同步组织数据的前提是开启应用机构，可参考7。 本章节的业务事件的消息示例前提是企业应用开启签名和数据加密。 父主题： API
修改用户事件 通过该接口将更新的用户同步至应用系统。 URL POST https://{app_domain}/callback 请求头 Authorization: Bearer {access_token} 请求参数 表1 请求参数 参数 固定参数 参数类型 描述 id 是
以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，如企业官网、在线商城、博客等，包年/包月计费模式能提供较高的成本效益。
删除组织事件 通过该接口将删除的组织同步至应用系统。 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 是
请求示例 根据应用id和机构id修改机构属性，名称为开发组，父机构id为20201027162527852-B712-D040F4...。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
