---
title: "Test the application"
url: https://docs.catalyst.zoho.com/en/tutorials/embedded-auth/python/test-app/
description: "Create a simple web application using the features of Catalyst Embedded Authentication that provides user sign-up, application login, password reset, and implements sign-in using common identity providers."
last_updated: 2026-08-17T12:16:04Z
service: All Services
type: tutorial
related_links:
  - name: "Serve CLI Resources"
    url: /en/cli/v1/serve-resources/introduction
---

# Test the Application

Before you deploy the application to the remote console, you can test the application on a local server and check if everything works using the Catalyst CLI. For detailed information on `catalyst serve`, refer to the [Serve Resources help page](https://docs.catalyst.zoho.com/en/cli/v1/serve-resources/introduction).

To serve the Catalyst project locally, execute the following command from your project directory:

```sh
catalyst serve
```

The authorization portal application will now be served at default `port 3000`. The local endpoint URLs of the components will be displayed in the CLI.

**Basic web app**

![basic-serve](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/python/basic-serve.webp)

> **Note:** Every time you access the homepage or any of the sub-pages of your client, or the function, the CLI will display a live log of the accessed URL, along with the HTTP method that is used to access it.

You can now open the client component’s local URL in a browser to access the application.

![client_app](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/client_app.webp)

### Test Case 1

#### Sign up using email address

1. Click **Sign Up** to create a new account.
![signup](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/signup.webp)

2. Enter the required details and click **Sign Up**.
![signup_details](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/signup_details.webp)

3. The [Email Verification](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/email-templates/introduction/) email will be sent to the email address you used to sign up.
![email_verification](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/email_verification.webp)

4. Click the link in the email
![email_link](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/email_link.webp)

5. Follow the instructions and set your password
![create_password](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/create_password.webp)

Once the password is set, you will be signed in to the application.
![signed_in](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/signed_in.webp)

You can verify this by viewing the user information in the [User Management](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/user-management/introduction/) section of the *Authentication* component in the console.
![user_details](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/user_details.webp)

### Test Case 2

#### Test Custom User Validation

1. Sign up to the application using an email address that will induce a failure instance.
![signup_page2](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/signup_page2.webp)

> **Note:** For the purpose of this tutorial, we have coded a logic for the Custom User Validation function where if the user's email provider is anyone other than Zylker Technology (`@zylker.com`) the end-user will not be able to sign up to the application.

2. You will not be able to sign up to the application using any email address other than the one coded to permit in the function logic.
![error_message](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/error_message.webp)

### Test Case 3

#### Sign up to the application using Identity Provider Logins

1. You can click a identity provider login that you had configured to begin the sign up process. For this test, we are signing up using the [Zoho Identity Provider login](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/social-logins/configuring-social-logins/#enable-zoho-social-login).
![idp_login](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/idp_login.webp)

2. Click **Accept**.
![accept_login](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/accept_login.webp)

You will be logged in to the application.
![logged_in](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/logged_in.webp)

You can verify the end-user has been added by viewing their details in the *User Management* section of the Authentication component in the console.

### Test Case 4

#### Password reset functionality

1. Click the **Forgot Password** option.
![forgot_password](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/forgot_password.webp)

2. Enter the email address
![enter_email](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/enter_email.webp)

3. Enter the captcha.
![enter_captcha](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/enter_captcha.webp)

4. You can still unlock an option if you remember any earlier password you had used to create this account. However, to test this functionality, click **Continue to reset password**.
![send_otp](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/send_otp.webp)

5. Click **SEND OTP** to send the OTP to your email address.
![verify_otp](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/verify_otp.webp)

6. Enter the OTP received in your email and click **Verify**.
![create_new_password](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/create_new_password.webp)

7. You can create your new password now and click **Change Password**.
![catalyst_authentication_hosted_catalyst_serve_pwd_confirm_reset](https://catalyst-docs-development.zohostratus.in/images/tutorials/hosted-login/catalyst_authentication_hosted_catalyst_serve_pwd_confirm_reset.webp)

You will be redirected to the login page, where you can log in to the application using the new password.

**React web app**

![react-serve](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/python/react-serve.webp)

> **Note:** Every time you access the homepage or any of the sub-pages of your client, or the function, the CLI will display a live log of the accessed URL, along with the HTTP method that is used to access it.

You can now open the client component’s local URL in a browser to access the application.

![client_app](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/client_app.webp)

### Test Case 1

#### Sign up using email address

1. Click **Sign Up** to create a new account.
![signup](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/signup.webp)

2. Enter the required details and click **Sign Up**.
![signup_details](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/signup_details.webp)

3. The [Email Verification](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/email-templates/introduction/) email will be sent to the email address you used to sign up.
![email_verification](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/email_verification.webp)

4. Click the link in the email
![email_link](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/email_link.webp)

5. Follow the instructions and set your password
![create_password](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/create_password.webp)

Once the password is set, you will be signed in to the application.
![signed_in](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/signed_in.webp)

You can verify this by viewing the user information in the [User Management](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/user-management/introduction/) section of the *Authentication* component in the console.
![user_details](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/user_details.webp)

### Test Case 2

#### Test Custom User Validation

1. Sign up to the application using an email address that will induce a failure instance.
![signup_page2](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/signup_page2.webp)

> **Note:** For the purpose of this tutorial, we have coded a logic for the Custom User Validation function where if the user's email provider is anyone other than Zylker Technology (`@zylker.com`) the end-user will not be able to sign up to the application.

2. You will not be able to sign up to the application using any email address other than the one coded to permit in the function logic.
![error_message](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/error_message.webp)

### Test Case 3

#### Sign up to the application using Identity Provider Logins

1. You can click a identity provider login that you had configured to begin the sign up process. For this test, we are signing up using the [Zoho Identity Provider login](https://docs.catalyst.zoho.com/en/cloud-scale/help/authentication/social-logins/configuring-social-logins/#enable-zoho-social-login).
![idp_login](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/idp_login.webp)

2. Click **Accept**.
![accept_login](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/accept_login.webp)

You will be logged in to the application.
![logged_in](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/logged_in.webp)

You can verify the end-user has been added by viewing their details in the *User Management* section of the Authentication component in the console.

### Test Case 4

#### Password reset functionality

1. Click the **Forgot Password** option.
![forgot_password](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/forgot_password.webp)

2. Enter the email address
![enter_email](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/enter_email.webp)

3. Enter the captcha.
![enter_captcha](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/enter_captcha.webp)

4. You can still unlock an option if you remember any earlier password you had used to create this account. However, to test this functionality, click **Continue to reset password**.
![send_otp](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/send_otp.webp)

5. Click **SEND OTP** to send the OTP to your email address.
![verify_otp](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/verify_otp.webp)

6. Enter the OTP received in your email and click **Verify**.
![create_new_password](https://catalyst-docs-development.zohostratus.in/images/tutorials/embedded_auth/create_new_password.webp)

7. You can create your new password now and click **Change Password**.
![catalyst_authentication_hosted_catalyst_serve_pwd_confirm_reset](https://catalyst-docs-development.zohostratus.in/images/tutorials/hosted-login/catalyst_authentication_hosted_catalyst_serve_pwd_confirm_reset.webp)

You will be redirected to the login page, where you can log in to the application using the new password.