检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
事件回调接口采用HTTP状态码表示操作结果成功或者失败。企业应用的回调服务参考以下错误码及错误提示进行返回，OneAccess将返回的错误码和错误信息保存到应用同步记录中。 表1 公共返回码 返回码code 说明 200 success。 400 参数XX已存在，如参数userName已存在。 参数XX不能为空，如参数id不能为空。
该字段内容填为“application/json;charset=utf8”。 Authorization 是 String 认证凭据，值：Bearer {access_token}，access_token通过“获取访问凭据”接口获取。 表3 请求Body参数 参数 是否必选 参数类型 描述 org_code 是
该字段内容填为“application/json;charset=utf8”。 Authorization 是 String 认证凭据，值：Bearer {access_token}，access_token通过“获取访问凭据”接口获取。 X-tenant-id 否 String 租户外部ID，如果为ISV方调用则
注销登录 功能介绍 注销登录会话。 接口约束 无 URI GET /api/v1/cas/logout 表1 Query参数 参数 是否必选 参数类型 描述 service 否 String 注销退出后的重定向地址，不设置则跳转登录页，若设置必须与应用CAS配置中的应用回调URL一致。
加自定义分组。 登录OneAccess管理门户。 在导航栏中，选择“用户 > 用户属性定义”。 在用户属性定义页面，单击“添加分组”。 输入中、英文分组名称。 单击“确定”，分组添加成功，分组列表显示已添加的分组。 删除自定义分组 登录OneAccess管理门户。 在导航栏中，选择“用户
字典的字典类型编码、是否树形展示不可修改。 登录OneAccess管理门户。 在导航栏中，选择“设置 > 数据字典”。 在待修改的数据字典右侧中选择“编辑”，打开“编辑字典”弹窗。 修改字典类型名称和备注，单击“保存”。 字典的字典类型编码、是否树形展示不可修改。 修改字典项 登录OneAccess管理门户。 在导航栏中，选择“设置
邮件网关是OneAccess针对重置用户密码场景，提供给用户的一种通过邮箱获取信息的方式。开启邮件网关后，管理员重置用户密码时，可以选择由OneAccess产生随机密码，并通过邮件的方式发送给用户，该用户将收到邮件密码，登录成功后可以进行密码重置。 本文主要介绍OneAccess配置邮件网关的方法。
接口格式 OneAccess同步事件回调接口的请求方式为POST，数据编码为UTF-8，数据格式为JSON。 如果应用系统接收事件回调的URL为 https://{app_domain}/callback，当OneAccess的企业发生组织机构或用户变动时，OneAccess将发生变动的业务数据推送至该回调地址。
通过该接口将更新的用户同步至应用系统。 URL POST https://{app_domain}/callback 请求头 Authorization: Bearer {access_token} 请求参数 表1 请求参数 参数 固定参数 参数类型 描述 id 是 String(50) 企业应用的用户ID。 username
OneAccess发起授权登录请求，用户同意授权第三方应用系统后，OneAccess将携带授权码code，重定向到第三方应用系统。 第三方应用系统使用授权码code调用OneAccess的API接口换取授权令牌access_token。 第三方应用系统使用授权令牌access_t
用户访问集成应用时，应用向OneAccess发起基于CAS的认证登录（重定向方式），用户添加该应用授权账号，用户使用应用认证登录接口POST/api/v1/login/form 传递参数：username、password；用户输入用户密码认证成功后，在调用下面的接口，OneAccess将重定向回应
获取图形验证码 功能介绍 获取图形验证码。 URI GET /api/v2/sdk/captcha 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-operating-sys-version 是 String 调用方操作系统版本，例如：Android 10。
该字段内容填为“application/json;charset=utf8”。 Authorization 是 String 认证凭据，值：Bearer {access_token}，access_token通过“获取访问凭据”接口获取。 表3 请求Body参数 参数 是否必选 参数类型 描述 account_name
校验图形验证码 功能介绍 校验图形验证码。 URI POST /api/v2/sdk/captcha/verify 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 该字段内容填为“application/json;charset=utf8”。
管理密码策略 OneAccess为企业提供安全的密码策略，企业管理员可以通过密码强度设置、登录安全设置、高级设置、密码初始化设置保障企业用户的账号安全。 建议设置密码策略，保证用户密码都是满足密码策略的安全密码。 密码策略对OneAccess实例中所有用户生效。 密码强度设置 登录OneAccess管理门户。
Authorization: Bearer {access_token} 请求参数 表1 请求参数 参数 固定参数 参数类型 描述 id 是 String(50) 下游企业应用的机构ID。 当机构通过新增组织事件同步成功后，下游企业应用创建机构并生成机构ID，回传至OneAccess，作为该机构的唯一标识。
该字段内容填为“application/json;charset=utf8”。 Authorization 是 String 认证凭据，值：Bearer {access_token}，access_token通过“获取访问凭据”接口获取。 表3 请求Body参数 参数 是否必选 参数类型 描述 user_id 是 String
请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 认证凭据，值：Bearer {access_token}，access_token通过“获取访问凭据”接口获取。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 account_id
String 登录流程状态标识。 枚举值： SUCCESS：登录成功 PASSWORD_WARN：密码快过期，需要调用密码过期强制修改密码接口设置密码 PASSWORD_EXPIRED：密码已过期，需要调用密码过期强制修改密码接口设置密码 ACCESS_DENIED：拒绝访问 MFA_A
发送短信验证码 功能介绍 发送短信验证码。 URI POST /api/v2/sdk/sms/send 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 该字段内容填为“application/json;charset=utf8”。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
