Set up multi-tenancy

Set up multi-tenancy

Learn how to enable multi-tenancy for Identity Platform, and create a new tenant using the Google Cloud console.

---

To follow step-by-step guidance for this task directly in the Google Cloud console, click Guide me:

Guide me

---

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 Google Cloud 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 Google Cloud project.

Enabling multi-tenancy

1. Open the Identity Platform Settings page in the Google Cloud console.
   Go to the Settings page

2. Click the Security tab.

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

   

Clicking this button enables multi-tenancy and opens the Tenants page.

You are now ready to create your first tenant.

Creating a tenant

1. Open the Identity Platform Tenants page in the Google 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. After you've selected a tenant, you can manage it the same way you manage a non-tenant Identity Platform project.

Disabling multi-tenancy

Use the Identity Toolkit API to disable multi-tenancy.

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