Getting started with multi-tenancy

This document shows you how to enable multi-tenancy for Identity Platform, and create a new tenant using the Cloud Console.

Before you begin

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud Console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Cloud project. Learn how to confirm that billing is enabled for your project.

4. In the Google Cloud Console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Cloud project. Learn how to confirm that billing is enabled for your project.

Enabling multi-tenancy

1. Open the Identity Platform Settings page in the Cloud Console.
   Go to the settings page

2. Select the Security tab.

3. Click Allow tenants at the bottom of the page.

   

4. Click Save.

You are now ready to create your first tenant.

Creating a tenant

1. Open the Identity Platform Tenants page in the Cloud Console.
   Go to the tenants page

2. Click Add tenant.

3. Enter a Name for the tenant. This does not need to be unique; Identity Platform will automatically assign a distinct ID.

4. Click Save.

Congratulations! You've created an Identity Platform tenant.

Selecting a tenant

Use the drop-down menu in the top-left corner to switch between tenants.

Each tenant has its own providers, settings, and users. Once you've selected a tenant, you can manage it the same way as a non-tenant Identity Platform project.

What's next

• Sign in users with tenants
• Create a sign-in page for multiple tenants
• Migrate existing users to a tenant
• Manage tenants programmatically