¶ 用户认证模块

更新时间: 2021-03-25 12:30:18

此模块包含注册登录、重置手机号邮箱、修改账号信息等方法，是以你的终端用户（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 = '176xxxx6754'
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="176xxxx6754",
)

¶ 使用邮箱登录

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.login_by_email(
    email=email,
    password='passw0rd',
)

¶ 使用用户名登录

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 = '176xxxx6754'
# 手机号验证码登录，如果用户不存在会自动创建账号
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 = '176xxxx6754'
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="176xxxx6754",
  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> 最近登录的 IP
updates.name <string> Name
updates.givenName <string> Given Name
updates.familyName <string> Family Name
updates.middleName <string> Middle Name
updates.profile <string> Profile Url
updates.preferredUsername <string> Preferred Name
updates.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 = '176xxxx6754'
user = authentication_client.bind_phone(
    phone=phone,
    phoneCode='1234',
)

¶ 解绑手机号

AuthenticationClient().unbind_phone()

用户解绑手机号

¶ 参数

¶ 示例

user = authentication_client.unbind_phone()

¶ 获取当前登录的用户信息

AuthenticationClient().get_current_user()

获取当前登录的用户信息

¶ 参数

¶ 示例

¶ 退出登录

AuthenticationClient().logout()

退出登录，会使用当前用户的 token 失效。

¶ 参数

¶ 示例

authentication_client.logout()

¶ 获取当前用户的自定义数据列表

AuthenticationClient().list_udv()

获取当前用户的自定义数据列表

¶ 参数

¶ 示例

udvs = authentication_client.list_udv()

¶ 添加自定义数据

AuthenticationClient().set_udv(key, value)

添加自定义数据

¶ 参数

key <string> 自定义字段的 key
value <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"
)

本文是否有解决您的问题？

如果遇到其他问题，你可以在 authing-chat/community 联系我们。