mycqu.auth.login_sso

mycqu.auth.login_sso(session: requests.sessions.Session, username: str, password: str, service: Optional[str] = None, timeout: int = 10, force_relogin: bool = False, last_resp: Optional[requests.models.Response] = None, captcha: Optional[str] = None)

登录统一身份认证（sso）

参数

  • session (Session) – 用于登录统一身份认证的会话

  • username (str) – 统一身份认证号或学工号

  • password (str) – 统一身份认证密码

  • service (Optional[str], optional) – 需要登录的服务，默认（None）则先不登陆任何服务

  • timeout (int, optional) – 连接超时时限，默认为 10（单位秒）

  • force_relogin (bool, optional) – 强制重登，当会话中已经有有效的登陆 cookies 时依然重新登录，默认为 False

  • last_resp (Optional[Response], optional) – 上次登录未成功的 Response

  • captcha (Optional[str], optional) – 登录验证码，需结合 last_resp 参数使用

引发

  • InvaildCaptcha – 无效的验证码

  • IncorrectLoginCredentials – 错误的登陆凭据（如错误的密码、用户名）

  • NeedCaptcha – 需要提供验证码，获得验证码文本之后可调用所抛出异常的 NeedCaptcha.after_captcha() 函数来继续登陆

返回

登陆了统一身份认证后所跳转到的地址的 Response

返回类型

Response