You are currently viewing the new Anvil Editor Docs.
Switch to the Classic Editor Docs
You are currently viewing the Classic Editor Docs.
Switch to the new Anvil Editor Docs

anvil.users Module

Classes

AccountIsNotEnabled

Create a new ‘AccountIsNotEnabled’ object

Constructor

AccountIsNotEnabled()

AuthenticationFailed

Create a new ‘AuthenticationFailed’ object

Constructor

AuthenticationFailed()

EmailNotConfirmed

Create a new ‘EmailNotConfirmed’ object

Constructor

EmailNotConfirmed()

MFAException

Create a new ‘MFAException’ object

Constructor

MFAException()

MFARequired

Create a new ‘MFARequired’ object

Constructor

MFARequired()

PasswordNotAcceptable

Create a new ‘PasswordNotAcceptable’ object

Constructor

PasswordNotAcceptable()

PasswordResetRequested

Create a new ‘PasswordResetRequested’ object

Constructor

PasswordResetRequested()

TooManyPasswordFailures

Create a new ‘TooManyPasswordFailures’ object

Constructor

TooManyPasswordFailures()

UserExists

Create a new ‘UserExists’ object

Constructor

UserExists()

Functions

change_password_with_form([require_old_password=True])

Display a form allowing the current user to reset their password.


    configure_account_with_form()

    Display a form allowing the current user to configure their account. The form contains links for password reset and two-factor authentication configuration.


    force_login(user_row, [remember=False])

    Set the specified user object (a row from a Data Table) as the current logged-in user. It must be a row from the users table. By default, login status is not remembered between sessions.


      get_user([allow_remembered=True])

      Get the row from the users table that corresponds to the currently logged-in user. If allow_remembered is true (the default), the user may have logged in in a previous session. Returns None if no user is logged in.


        login_with_email(email, password, [remember=False])

        Log in with the specified email address and password. Raises anvil.users.AuthenticationFailed exception if the login failed.

        By default, login status is not remembered between sessions; set remember=True to remember login status.


          login_with_facebook([additional_scopes], [remember=False])

          Log in with a Facebook account. Prompts the user to authenticate with Facebook, then logs in with their Facebook email address (if that user exists). Returns None if the login was cancelled or we have no record of this user.

          additional_scopes: If supplied, these are passed on to anvil.facebook.auth.login().

          By default, login status is not remembered between sessions; set remember=True to remember login status.


            login_with_form([show_signup_option=True], [remember_by_default=True], [allow_remembered=True], [allow_cancel=False])

            Display a login form and allow user to log in. Returns user object if logged in, or None if cancelled.

            show_signup_option: if True, the form will also show the option to sign up for a new account.

            remember_by_default: if True, the ‘remember me’ checkbox will be enabled by default.

            allow_remembered: if False, users with remembered login status will still be required to log in.

            allow_cancel: if True, the login form has a Cancel button that the user can use to dismiss the form.


              login_with_google([additional_scopes], [remember=False])

              Log in with a Google account. Prompts the user to authenticate with Google, then logs in with their Google email address (if that user exists). Returns None if the login was cancelled or we have no record of this user.

              additional_scopes: If supplied, these are passed on to anvil.google.auth.login().

              By default, login status is not remembered between sessions; set remember=True to remember login status.


                login_with_microsoft([additional_scopes], [remember=False])

                Log in with a Microsoft account. Prompts the user to authenticate with Microsoft, then logs in with their Microsoft email address (if that user exists). Returns None if the login was cancelled or we have no record of this user.

                additional_scopes: If supplied, these are passed on to anvil.microsoft.auth.login().

                By default, login status is not remembered between sessions; set remember=True to remember login status.


                  login_with_saml([remember=False])

                  Log in via a SAML Identity Provider. Prompts the user to authenticate with SAML, then logs in with their email address (if that user exists). Returns None if the login was cancelled or we have no record of this user.

                  By default, login status is not remembered between sessions; set remember=True to remember login status.


                    logout([invalidate_client_objects=False])

                    Forget the current logged-in user.

                    If invalidate_client_objects is true, all live objects (table rows, Capabilities, unfetched Media, etc) will be invalidated


                      reset_password(old_password, new_password)

                      Reset the password for the current user


                        send_mfa_reset_email(email_address)

                        Send a two-factor authentication reset email to the specified user.


                          send_password_reset_email(email_address)

                          Send a password-reset email to the specified user


                            send_token_login_email(email_address)

                            Send a login link email to the specified user


                              signup_with_email(email, password, [remember=False])

                              Sign up for a new account with the specified email address and password. Raises anvil.users.UserExists if an account is already registered with this email address.

                              By default, login status is not remembered between sessions; set remember=True to remember login status.


                                signup_with_facebook([additional_scopes], [remember=False])

                                Sign up for a new account with the email address associated with the user’s Facebook account. Prompts the user to authenticate with Facebook, then registers a new user with that email address. Raises anvil.users.UserExists if this email address is already registered; returns new user or None if cancelled.

                                additional_scopes: If supplied, these are passed on to anvil.facebook.auth.login().

                                By default, login status is not remembered between sessions; set remember=True to remember login status.


                                  signup_with_form([remember_by_default=True], [allow_cancel=False])

                                  Display a sign-up form allowing a user to create a new account. Returns the new user object, or None if cancelled.

                                  remember_by_default: if True, the ‘remember me’ checkbox will be enabled by default.

                                  allow_cancel: if True, the signup form has a Cancel button that the user can use to dismiss the form.


                                    signup_with_google([additional_scopes], [remember=False])

                                    Sign up for a new account with the email address associated with the user’s Google account. Prompts the user to authenticate with Google, then registers a new user with that email address. Raises anvil.users.UserExists if this email address is already registered; returns new user or None if cancelled.

                                    additional_scopes: If supplied, these are passed on to anvil.google.auth.login().

                                    By default, login status is not remembered between sessions; set remember=True to remember login status.


                                      signup_with_microsoft([additional_scopes], [remember=False])

                                      Sign up for a new account with the email address associated with the user’s Microsoft account. Prompts the user to authenticate with Microsoft, then registers a new user with that email address. Raises anvil.users.UserExists if this email address is already registered; returns new user or None if cancelled.

                                      additional_scopes: If supplied, these are passed on to anvil.microsoft.auth.login().

                                      By default, login status is not remembered between sessions; set remember=True to remember login status.


                                        signup_with_saml([remember=False])

                                        Sign up for a new account with the email address associated with the user’s SAML account. Prompts the user to authenticate via SAML, then registers a new user with that email address. Raises anvil.users.UserExists if this email address is already registered; returns new user or None if cancelled.

                                        By default, login status is not remembered between sessions; set remember=True to remember login status.



                                          Do you still have questions?

                                          Our Community Forum is full of helpful information and Anvil experts.


                                          anvil.users