# 认证核心模块
此模块包含注册登录、重置手机号邮箱、修改账号信息等方法,是以你的终端用户(End User)的身份进行请求,适合在需要验证用户身份的情况下使用。
# 使用邮箱注册
AuthenticationClient().register_by_email(email, password, profile, options)
使用邮箱注册,此接口不要求用户对邮箱进行验证,用户注册之后 emailVerified 字段会为 false 。如果你希望邮箱未验证的用户不能进行登录,可以使用 pipeline 对此类请求进行拦截。
# 参数
email
<string> 邮箱password
<string> 密码profile
<RegisterProfile> 用户资料options
<Object>options.forceLogin
<boolean> 是否走一遍完整的登录的,会触发登录前后的 pipeline 函数以及登录事件 webhook ,同时该用户的累计登录次数会加 1 。默认为 false 。options.generateToken
<boolean> 是否为该用户生成 token,不会触发登录后的完整流程,用户的累计登录次数不会加 1。默认为 false 。options.clientIp
<string> 客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。
# 示例
email = 'test@example.com'
user = authentication_client.register_by_email(
email=email,
password='passw0rd',
profile={
'nickname': 'Nick'
}
)
# 使用用户名注册
AuthenticationClient().register_by_username(username, password, profile, options)
使用用户名注册
# 参数
username
<string> 用户名password
<string> 密码profile
<RegisterProfile> 用户资料options
<Object>options.forceLogin
<boolean> 是否走一遍完整的登录的,会触发登录前后的 pipeline 函数以及登录事件 webhook ,同时该用户的累计登录次数会加 1 。默认为 false 。options.generateToken
<boolean> 是否为该用户生成 token,不会触发登录后的完整流程,用户的累计登录次数不会加 1。默认为 false 。options.clientIp
<string> 客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。
# 示例
username = 'bob'
user = authentication_client.register_by_username(
username=username,
password='passw0rd',
profile={
'nickname': 'Nick'
}
)
# 使用手机号注册
AuthenticationClient().register_by_phone_code(phone, code, password, profile, options)
使用手机号注册,你可以同时设置该账号的初始密码。发送短信的接口请见 sendSmsCode
# 参数
phone
<string> 手机号code
<string> 短信验证码password
<string> 初始密码profile
<RegisterProfile> 用户资料options
<Object>options.forceLogin
<boolean> 是否走一遍完整的登录的,会触发登录前后的 pipeline 函数以及登录事件 webhook ,同时该用户的累计登录次数会加 1 。默认为 false 。options.generateToken
<boolean> 是否为该用户生成 token,不会触发登录后的完整流程,用户的累计登录次数不会加 1。默认为 false 。options.clientIp
<string> 客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。
# 示例
phone = '176xxxx7041'
user = authentication_client.register_by_phone_code(
phone=phone,
code='1234',
password='passw0rd',
profile={
'nickname': 'Nick'
}
)
# 发送短信验证码
AuthenticationClient().send_sms_code(phone)
发送短信验证码, 短信验证码的有效时间为 60 s。
# 参数
phone
<string>
# 示例
authentication_client.send_sms_code(
phone="176xxxx7041",
)
# 使用邮箱登录
AuthenticationClient().login_by_email(email, password, options)
使用邮箱登录,该接口默认不会限制未验证的邮箱进行登录,如果你希望邮箱未验证的用户不能进行登录,可以使用 pipeline 对此类请求进行拦截。
如果你的用户池配置了登录失败检测,当同一 IP 下登录多次失败的时候会要求用户输入图形验证码(code 为 2000)。
# 参数
email
<string> 邮箱password
<string> 密码options
<Object>options.autoRegister
<boolean> 是否自动注册。如果检测到用户不存在,会根据登录账密自动创建一个账号。options.captchaCode
<string> 图形验证码options.clientIp
<string> 客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。
# 示例
email = 'test@example.com'
user = authentication_client.register_by_email(
email=email,
password='passw0rd',
auto_register=True, # 如果用户不存在,是否自动注册。
)
# 使用用户名登录
AuthenticationClient().login_by_username(username, password, options)
使用用户名登录。
如果你的用户池配置了登录失败检测,当同一 IP 下登录多次失败的时候会要求用户输入图形验证码(code 为 2000)。
# 参数
username
<string> 用户名password
<string> 密码options
<Object>options.autoRegister
<boolean> 是否自动注册。如果检测到用户不存在,会根据登录账密自动创建一个账号。options.captchaCode
<string> 图形验证码options.clientIp
<string> 客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。
# 示例
username = 'bob'
user = authentication_client.register_by_username(
username=username,
password='passw0rd',
auto_register=True, # 如果用户不存在,是否自动注册。
)
# 使用手机号验证码登录
AuthenticationClient().login_by_phone_code(phone, code)
使用手机号验证码登录。
# 参数
phone
<string> 手机号code
<string> 短信验证码options.clientIp
<string> 客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。
# 示例
phone = '176xxxx7041'
# 手机号验证码登录,如果用户不存在会自动创建账号
user = authentication_client.login_by_phone_code(
phone=phone,
code='1234',
)
# 使用手机号密码登录
AuthenticationClient().login_by_phone_password(phone, password, options)
使用手机号密码登录。
# 参数
phone
<string> 手机号password
<string> 密码options
<Object>options.captchaCode
<string> 图形验证码options.clientIp
<string> 客户端真实 IP,如果你在服务器端调用此接口,请务必将此参数设置为终端用户的真实 IP。
# 示例
phone = '176xxxx7041'
user = authentication_client.login_by_phone_password(
phone=phone,
password='passw0rd',
)
# 检测 Token 登录状态
AuthenticationClient().check_login_status(token)
检测 Token 登录状态
# 参数
token
<string> 用户的登录凭证 token
# 示例
# 检查任意 token 的有效状态
data = authentication.check_login_status(token="TOKEN")
# 之前调用过登录或者通过 access_token 初始化
# 检查当前用户的登录状态
data = authentication.check_login_status()
# 发送邮件
AuthenticationClient().send_email(email, scene)
发送邮件
# 参数
email
<string> 邮箱scene
<EmailScene> 发送场景,可选值为 RESET_PASSWORD(发送重置密码邮件,邮件中包含验证码)、VerifyEmail(发送验证邮箱的邮件)、ChangeEmail(发送修改邮箱邮件,邮件中包含验证码)
# 示例
authentication_client.send_email(
email="test@example.com",
scene="RESET_PASSWORD",
)
# 通过短信验证码重置密码
AuthenticationClient().reset_password_by_phone_code(phone, code, newPassword)
通过短信验证码重置密码,你需要先调用 sendSmsCode 接口发送重置密码邮件。
# 参数
phone
<string> 手机号code
<string> 验证码newPassword
<string> 新的密码
# 示例
authentication_client.reset_password_by_phone_code(
phone="176xxxx7041",
code="1234",
new_password="passw0rd"
)
# 通过邮件验证码重置密码
AuthenticationClient().reset_password_by_email_code(phone, code, newPassword)
通过邮件验证码重置密码,你需要先调用 sendEmail 接口发送重置密码邮件。
# 参数
phone
<string> 手机号code
<string> 验证码newPassword
<string> 新的密码
# 示例
authentication_client.reset_password_by_email_code(
email="test@example.com",
code="1234",
new_password="passw0rd"
)
# 修改用户资料
AuthenticationClient().update_profile(updates)
修改用户资料,此接口不能用于修改手机号、邮箱、密码,如果需要请调用 updatePhone、updateEmail、updatePassword 接口。
# 参数
updates
<UpdateUserInput> 修改的用户资料updates.username
<string> 用户名updates.nickname
<string> 昵称updates.photo
<string> 头像updates.company
<string> 公司updates.browser
<string> 浏览器updates.device
<string> 设备updates.lastIP
<string> 最近登录的 IPupdates.name
<string> Nameupdates.givenName
<string> Given Nameupdates.familyName
<string> Family Nameupdates.middleName
<string> Middle Nameupdates.profile
<string> Profile Urlupdates.preferredUsername
<string> Preferred Nameupdates.website
<string> 个人网站updates.gender
<string> 性别, M(Man) 表示男性、F(Female) 表示女性、未知表示 U(Unknown)updates.birthdate
<string> 生日updates.zoneinfo
<string> 时区updates.locale
<string> 语言updates.address
<string> 地址updates.streetAddress
<string> 街道地址updates.locality
<string>updates.region
<string> 地域updates.postalCode
<string> 邮编updates.city
<string> 城市updates.province
<string> 省份updates.country
<string> 国家
# 示例
user = authentication_client.update_profile({
'nickname': 'Nick'
})
# 更新用户密码
AuthenticationClient().update_password(newPassword, oldPassword)
更新用户密码
# 参数
newPassword
<string> 新密码oldPassword
<string> 旧密码,如果用户没有设置密码,可以不填。
# 示例
# 由手机号、社会化登录等其他方式注册的,首次没有设置密码,old_password 留空。
authentication_client.update_password(
new_password="passw0rd",
)
# 用户之前设置了密码
authentication_client.update_password(
new_password="passw0rd",
old_password="123456!"
)
# 更新用户手机号
AuthenticationClient().update_phone(phone, phoneCode, oldPhone, oldPhoneCode)
更新用户手机号。和修改邮箱一样,默认情况下,如果用户当前已经绑定了手机号,需要同时验证原有手机号(目前账号绑定的手机号)和当前邮箱(将要绑定的手机号)。 也就是说,用户 A 当前绑定的手机号为 15888888888,想修改为 15899999999,那么就需要同时验证这两个手机号。 开发者也可以选择不开启 “验证原有手机号“ ,可以在 Authing 控制台 的 设置目录下的安全信息模块进行关闭。 用户首次绑定手机号请使用 bindPhone 接口。
# 参数
phone
<string> 新手机号phoneCode
<string> 新手机号的验证码oldPhone
<string> 旧手机号oldPhoneCode
<string> 旧手机号的验证码
# 示例
# 关闭了“验证原有手机号“选项
authentication_client.update_email(
phone="test1@example.com",
phoneCode="1234",
)
# 开启了“验证原有手机号“选项
authentication_client.update_email(
phone="test1@example.com",
phoneCode="1234",
oldPhone="test2@exmaple.com",
oldPhoneCode="1234"
)
# 更新用户邮箱
AuthenticationClient().update_email(email, emailCode, oldEmail, oldEmailCode)
如果用户已经绑定了邮箱,默认情况下,需要同时验证原有邮箱(目前账号绑定的邮箱)和当前邮箱(将要绑定的邮箱)。也就是说,用户 A 当前绑定的邮箱为 123456@qq.com,想修改为 1234567@qq.com,那么就需要同时验证这两个邮箱。 开发者也可以选择不开启 “验证原有邮箱“ ,可以在 Authing 控制台 的 设置目录下的安全信息模块进行关闭。 用户首次绑定手机号请使用 bindEmail 接口。
# 参数
email
<string> 新邮箱emailCode
<string> 新邮箱的验证码oldEmail
<string> 旧邮箱oldEmailCode
<string> 旧邮箱的验证码
# 示例
# 关闭了“验证原有邮箱“选项
authentication_client.update_email(
email="test1@example.com",
emailCode="1234",
)
# 开启了“验证原有邮箱“选项
authentication_client.update_email(
email="test1@example.com",
emailCode="1234",
oldEmail="test2@exmaple.com",
oldEmailCode="1234"
)
# 刷新当前用户的 token
AuthenticationClient().refresh_token()
刷新当前用户的 token,调用此接口要求先登录。
# 参数
# 示例
authentication_client.refresh_token()
# 绑定手机号
AuthenticationClient().bind_phone(phone, phoneCode)
用户初次绑定手机号,如果需要修改手机号请使用 updatePhone 接口。
# 参数
phone
<string>phoneCode
<string>
# 示例
phone = '176xxxx7041'
user = authentication_client.bind_phone(
phone=phone,
phoneCode='1234',
)
# 解绑手机号
AuthenticationClient().unbind_phone()
用户解绑手机号
# 参数
# 示例
user = authentication_client.unbind_phone()
# 获取当前登录的用户信息
AuthenticationClient().get_current_user()
获取当前登录的用户信息
# 参数
# 示例
# 退出登录
AuthenticationClient().logout()
退出登录,清空 localStorage 里的 user 和 token
# 参数
# 示例
authentication_client.logout()
# 获取当前用户的自定义数据列表
AuthenticationClient().list_udv()
获取当前用户的自定义数据列表
# 参数
# 示例
udvs = authentication_client.list_udv()
# 添加自定义数据
AuthenticationClient().set_udv(key, value)
添加自定义数据
# 参数
key
<string> 自定义字段的 keyvalue
<any> 自定义数据的值,值的类型必须要和用户池定义的自定义字段类型一致。
# 示例
# 设置 int 类型数据
authentication_client.set_udv(
key="age",
value=15
)
# 设置 boolen 类型数据
authentication_client.set_udv(
key="is_ok",
value=True
)
# 删除自定义数据
AuthenticationClient().remove_udv(key)
删除自定义数据
# 参数
key
<null> 自定义字段的 key
# 示例
authentication_client.remove_udv(
key="age"
)