检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
验证回调地址 如果企业应用接收事件推送的URL为https://{app_domain}/callback。当企业管理员在保存回调配置信息时，OneAccess会发送一条验证事件到填写的URL回调服务。 URL POST https://{app_domain}/callback
获取图形验证码 功能介绍 获取图形验证码。 URI GET /api/v2/sdk/captcha 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-operating-sys-version 是 String 调用方操作系统版本，例如：Android 10。
校验图形验证码 功能介绍 校验图形验证码。 URI POST /api/v2/sdk/captcha/verify 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 该字段内容填为“application/json;charset=utf8”。
验证码 获取图形验证码 校验图形验证码 获取国际区号 发送短信验证码 父主题： 用户类接口
发送短信验证码 功能介绍 发送短信验证码。 URI POST /api/v2/sdk/sms/send 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 该字段内容填为“application/json;charset=utf8”。
验证票据(CAS1.0) 功能介绍 应用验证票据。 接口约束 无 URI GET /api/v1/cas/validate 表1 Query参数 参数 是否必选 参数类型 描述 service 是 String 应用接受票据的地址，必须与应用CAS配置中的应用回调URL一致。 ticket
验证票据(CAS2.0) 功能介绍 应用验证票据，并获取用户信息。 接口约束 无 URI GET /api/v1/cas/serviceValidate 表1 Query参数 参数 是否必选 参数类型 描述 service 是 String 应用接受票据的地址，必须与应用CAS配置中的应用回调URL一致。
验证票据(CAS3.0) 功能介绍 应用验证票据，并获取用户属性信息。 接口约束 无 URI GET /api/v1/cas/p3/serviceValidate 表1 Query参数 参数 是否必选 参数类型 描述 service 是 String 应用接受票据的地址，必须与应用CAS配置中的应用回调URL一致。
修改密码接口设置密码 PASSWORD_EXPIRED：密码已过期，需要调用密码过期强制修改密码接口设置密码 ACCESS_DENIED：拒绝访问 MFA_AUTH：登录成功但需要进行二次认证，需要调用根据state_Token获取手机号接口、手机和短信验证码二次认证接口进行二次认证
手机号短信验证码二次认证 功能介绍 登录过程中如果需要二次认证，则调用本接口根据手机号、短信验证码认证。 URI POST /api/v2/sdk/mfa/sms 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 该
使用手机号和短信验证码注册 功能介绍 使用手机号和短信验证码注册。 URI POST /api/v2/sdk/register/mobile-verify-code 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String
对OIDC协议中的id_token进行验证 登录OneAccess管理门户，选择“设置 > 服务配置”。 在服务配置页面，单击“OIDC”。 在OIDC页面，单击“OIDC设置”。 获取jwks_uri地址。 在浏览器中输入jwks_uri地址，根据创建的OIDC应用中的签名加密
使用短信发送验证码提示“消息余量不足，请联系管理员” 问题描述 用户门户使用短信验证码方式登录、修改绑定手机号码等需要发送短信验证码的场景，提示“消息余量不足，请联系管理员”。 原因分析 在购买创建OneAccess实例时会自动配置内置短信网关，默认赠送每月1000条国内短信，2
OneAccess对用户的访问进行统一管理，其管理方式就是添加认证策略，通过认证策略给选定的用户设置访问时间、设备类型、区域范围等权限，满足设置的访问条件的用户可以设定登录时的验证方式如二次认证、拒绝、允许访问三种情况。 添加认证策略 登录OneAccess管理门户。 在导航栏中，选择“认证 > 认证策略”。 在认证策略页面，单击“添加策略”。
获取国际区号 功能介绍 获取支持的国际区号。 URI GET /api/v2/sdk/country-codes 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-operating-sys-version 是 String 调用方操作系统版本，例如：Android
通过手机号找回密码 功能介绍 用户在登录页面单击忘记密码，并选择通过手机号找回密码时，需要输入手机号、验证码、新的密码并通过图形验证码校验后调用本接口。 URI POST /api/v2/sdk/pwd/update-by-mobile 请求参数 表1 请求Header参数 参数 是否必选
t_id。 表2 请求Body参数 参数 是否必选 参数类型 描述 mobile 是 String 接收验证码的手机号。 verify_code 是 String 接收到的验证码。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String
语音网关配置 语音网关是OneAccess提供的“语音验证码”功能，当用户的手机无法收到短信验证码时，可以通过配置语音网关发送语音验证码，确保业务的连续性。包括内置网关、自定义网关两种方式。 内置网关 使用情况：选择“内置网关”后，可以在语音网关配置页面查看语音的总量和已使用量。
钉钉网关配置 当“短信验证码”和“语音验证码”都无法满足需求时，可以使用钉钉网关发送验证码，在登录用户门户、忘记密码、二次验证、重置密码、风险预警场景，OneAccess同时支持钉钉发送验证码，您只需要通过配置钉钉网关即可实现。 本文主要介绍OneAccess配置钉钉网关的方法。
t_id。 表2 请求Body参数 参数 是否必选 参数类型 描述 mobile 是 String 接收验证码的手机号。 verify_code 是 String 接收到的验证码。 响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
