Login screen classes

Login screen class

The Login screen class is part of the Identifier First Authentication flow and collects the user's identifier and password. Depending on your tenant setup, this identifier can be an email, phone number, or username.

ACUL Login

Import and instantiate the Login screen class:

import Login from "@auth0/auth0-acul-js/login";
const loginManager = new Login();

// SDK Properties return a string, number or boolean
// ex. "login-id"
loginManager.screen.name;

// SDK Methods return an object or array
// ex. { signup: "/signup_url", reset_password: "/reset_password_url"} 
loginManager.screenLinks();

feedbackSection.helpful

/

Properties

The Login screen class properties are:

interface branding {
  settings: null | BrandingSettings;
  themes: null | BrandingThemes;
}

interface BrandingSettings {
  colors?: {
    pageBackground?: string | {
      angleDeg: number;
      end: string;
      start: string;
      type: string;
    };
    primary?: string;
  };
  faviconUrl?: string;
  font?: {url: string;};
  logoUrl?: string;
}

interface BrandingThemes {
  default: {
    borders: Record<string, string | number | boolean>;
    colors: Record<string, string>;
    displayName: string;
    fonts: Record<string, string | boolean | object>;
    pageBackground: Record<string, string>;
    widget: Record<string, string | number>;
  };
}

feedbackSection.helpful

/

Methods

The Login screen class methods are:

login( options? )

This method authenticates the user based on the identifier and provided password. Depending on the server configuration, this could be an email, username, or phone number. Review Flexible Identifiers for more details.

loginManager.login({
  username: "testUser",
  password: "testPassword"
});

feedbackSection.helpful

/

Parameter                  Type Required Description
username string Yes The user’s identifier.
password string Yes The user's password.
captcha string Conditionally The captcha code or response from the captcha provider. This property is required if your Auth0 tenant has Bot Detection enabled.
[key: string] string | number | boolean | undefined No Additional data collected from the user. This data is accessible in the post-login Action trigger.

socialLogin( options? )

This method redirects the user to the social or enterprise identity provider (IdP) for authentication. Review Social Identity Providers and Enterprise Identity Providers for details.

loginManager.socialLogin({
  connection: "google-oauth2"
});

feedbackSection.helpful

/

Parameter Type Required Description
connection string Yes The identifier for the connection.
[key: string] string | number | boolean | undefined No Additional data collected from the user. This data is accessible in the post-login Action trigger.

Login ID screen class

The Login ID screen class is part of the Identifier First Authentication flow and collects the user's identifier. Depending on your tenant setup, this identifier can be an email, phone number, or username.

Import and instantiate the Login ID screen class:

import LoginId from '@auth0/auth0-acul-js/login-id';
const loginIdManager = new LoginId();

// SDK Properties return a string, number or boolean
// ex. "login-id"
loginIdManager.screen.name;

// SDK Methods return an object or array
// ex. { signup: "/signup_url", reset_password: "/reset_password_url"} 
loginIdManager.screenLinks();

feedbackSection.helpful

/

Properties

The Login ID screen class properties are:

interface branding {
  settings: null | BrandingSettings;
  themes: null | BrandingThemes;
}

interface BrandingSettings {
  colors?: {
    pageBackground?: string | {
      angleDeg: number;
      end: string;
      start: string;
      type: string;
    };
    primary?: string;
  };
  faviconUrl?: string;
  font?: {url: string;};
  logoUrl?: string;
}

interface BrandingThemes {
  default: {
    borders: Record<string, string | number | boolean>;
    colors: Record<string, string>;
    displayName: string;
    fonts: Record<string, string | boolean | object>;
    pageBackground: Record<string, string>;
    widget: Record<string, string | number>;
  };
}

feedbackSection.helpful

/

Methods

The Login ID screen class methods are:

login( options? )

This method takes the user to the next step where they can enter their password or one-time password (OTP) code. Depending on the server configuration, this could be an email, username, or phone number. Review Flexible Identifiers for more details.

loginIdManager.login({
  username: <identifierFieldValue>
});

feedbackSection.helpful

/

Parameter                  Type Required Description
username string Yes The user’s identifier.
captcha string Conditionally The captcha code or response from the captcha provider. This property is required if your Auth0 tenant has Bot Detection enabled.
[key: string] string | number | boolean | undefined No Additional data collected from the user. This data is accessible in the post-login Action trigger.

passkeyLogin( options? )

This method authenticates the user using the provided passkey and, if successful, redirects them to the redirect_url.

// This method does not support any parameters
loginIdManager.passkeyLogin();

feedbackSection.helpful

/

socialLogin( options? )

This method redirects the user to the social or enterprise identity provider (IdP) for authentication. Review Social Identity Providers and Enterprise Identity Providers for details.

// Get the desired connection
const selectedConnection = alternateConnections.filter((connection) => 
  connection.strategy === "google-oauth2"
});
loginIdManager.socialLogin({
  connection: selectedConnection.strategy
});

feedbackSection.helpful

/

Parameter Type Required Description
connection string Yes The identifier for the connection.
[key: string] string | number | boolean | undefined No Additional data collected from the user. This data is accessible in the post-login Action trigger.

pickCountryCode( options? )

This method redirects the user to the country code selection list, where they can update the country code prefix for their phone number.

// This method does not support any parameters
loginIdManager.pickCountryCode();

feedbackSection.helpful

/

Login Password screen class

The Login Password screen class is part of the Identifier First Authentication flow and collects the user's password.

Login Password

Import and instantiate the Login Password screen class

import LoginPassword from "@auth0/auth0-acul-js/login-password";
const loginPasswordManager = new LoginPassword();

// SDK Properties return a string, number or boolean
// ex. "login-password"
loginPasswordManager.screen.name;

// SDK Methods return an object or array
// ex. { signup: "/signup_url", reset_password: "/reset_password_url"} 
loginPasswordManager.screenLinks();

feedbackSection.helpful

/

Properties

The Login Password screen class properties are:

interface branding {
  settings: null | BrandingSettings;
  themes: null | BrandingThemes;
}

interface BrandingSettings {
  colors?: {
    pageBackground?: string | {
      angleDeg: number;
      end: string;
      start: string;
      type: string;
    };
    primary?: string;
  };
  faviconUrl?: string;
  font?: {url: string;};
  logoUrl?: string;
}

interface BrandingThemes {
  default: {
    borders: Record<string, string | number | boolean>;
    colors: Record<string, string>;
    displayName: string;
    fonts: Record<string, string | boolean | object>;
    pageBackground: Record<string, string>;
    widget: Record<string, string | number>;
  };
}

feedbackSection.helpful

/

Methods

The Login Password screen class method is:

login( options? )

This method authenticates the user based on the identifier from the previous step and the provided password. Once authenticated, the user is directed to the next step.

loginPasswordManager.login({
  username: <usernameFieldValue>,
  password: ********
});

feedbackSection.helpful

/

Parameter                  Type Required Description
captcha string Conditionally The captcha code or response from the captcha provider. This property is required if your Auth0 tenant has Bot Detection enabled.
username string Yes The user’s identifier.
password string Yes The user's password.
[key: string] string | number | boolean | undefined No Additional data collected from the user. This data is accessible in the post-login Action trigger.

Login Passwordless Email Code screen class

The Login Passwordless Email Code screen class is part of the Identifier First Authentication flow. It allows the user to authenticate with a one-time password (OTP) code sent to the email provided in their previous step.

Login Passwordless Email Code

Import and instantiate the Login Passwordless Email Code screen class

import LoginPasswordlessEmailCode from '@auth0/auth0-acul-js/login-passwordless-email-code';
const loginPasswordlessEmailCodeManager = new LoginPasswordlessEmailCode();

// SDK Properties return a string, number or boolean
// ex. "login-passwordless-email-code"
loginPasswordlessEmailCodeManager.screen.name;

// SDK Methods return an object or array
// ex. { edit_identifier: "/edit_url" } 
loginPasswordlessEmailCodeManager.screenLinks();

feedbackSection.helpful

/

Properties

The Login Passwordless Email Code screen class properties are:

interface branding {
  settings: null | BrandingSettings;
  themes: null | BrandingThemes;
}

interface BrandingSettings {
  colors?: {
    pageBackground?: string | {
      angleDeg: number;
      end: string;
      start: string;
      type: string;
    };
    primary?: string;
  };
  faviconUrl?: string;
  font?: {url: string;};
  logoUrl?: string;
}

interface BrandingThemes {
  default: {
    borders: Record<string, string | number | boolean>;
    colors: Record<string, string>;
    displayName: string;
    fonts: Record<string, string | boolean | object>;
    pageBackground: Record<string, string>;
    widget: Record<string, string | number>;
  };
}

feedbackSection.helpful

/

Methods

The Login Passwordless Email Code screen class method are:

resendCode( options? )

This method sends a new OTP code to the email provided in the previous step.

// This method does not support any parameters
loginPasswordlessEmailCode.resendCode();

feedbackSection.helpful

/

Parameter                  Type Required Description
[key: string] string | number | boolean | undefined No Optional data collected from user.

SubmitCode( options? )

This method authenticates the user based on the provided email address and OTP code.

loginPasswordlessEmailCode.submitCode({
 email: <EmailFieldValue>;
 code: <OtpCodeFieldValue>;
});

feedbackSection.helpful

/

Parameter                  Type Required Description
captcha string Conditionally The captcha code or response from the captcha provider. This property is required if your Auth0 tenant has Bot Detection enabled.
code string number Yes The OTP code sent to the email.
[key: string] string | number | boolean | undefined No Additional data collected from the user. This data is accessible in the post-login Action trigger.

Login Passwordless SMS OTP screen class

The Login Passwordless SMS OTP screen class is part of the Identifier First Authentication flow. It allows the user to authenticate with a one-time password (OTP) code sent to the phone number provided in the previous step.

Login Passwordless SMS OTP

Import and instantiate the Login Passwordless Email Code screen class

import LoginPasswordlessSmsOtp from '@auth0/auth0-acul-js/login-passwordless-sms-otp';
const loginPasswordlessSmsOtpManager = new LoginPasswordlessSmsOtp();

// SDK Properties return a string, number or boolean
// ex. "login-passwordless-sms-otp"
loginPasswordlessSmsOtpManager.screen.name;

// SDK Methods return an object or array
// ex. { edit_identifier: "/edit_url" } 
loginPasswordlessSmsOtpManager.screenLinks();

feedbackSection.helpful

/

Properties

The Login Passwordless SMS OTP screen class properties are:

interface branding {
  settings: null | BrandingSettings;
  themes: null | BrandingThemes;
}

interface BrandingSettings {
  colors?: {
    pageBackground?: string | {
      angleDeg: number;
      end: string;
      start: string;
      type: string;
    };
    primary?: string;
  };
  faviconUrl?: string;
  font?: {url: string;};
  logoUrl?: string;
}

interface BrandingThemes {
  default: {
    borders: Record<string, string | number | boolean>;
    colors: Record<string, string>;
    displayName: string;
    fonts: Record<string, string | boolean | object>;
    pageBackground: Record<string, string>;
    widget: Record<string, string | number>;
  };
}

feedbackSection.helpful

/

Methods

The Login Passwordless SMS OTP screen class method are:

resendOTP( options? )

This method sends a new OTP code to the email provided in the previous step.

// This method does not support any parameters
loginPasswordlessSmsOtpManager.resendOTP()

feedbackSection.helpful

/

Parameter                  Type Required Description
[key: string] string | number | boolean | undefined No Optional data collected from user.

submitOTP( options? )

This method authenticates the user based on the provided phone number and OTP code.

loginPasswordlessSmsOtpManager.submitOTP({
 username: <PhoneFieldValue>;
 otp: <OtpCodeFieldValue>;
})

feedbackSection.helpful

/

Parameter                  Type Required Description
captcha string Conditionally The captcha code or response from the captcha provider. This property is required if your Auth0 tenant has Bot Detection enabled.
otp string Yes The OTP code sent to the phone number.
username string Yes The phone number from the previous step.
[key: string] string | number | boolean | undefined No Optional data collected from the user.