# Tenant Onboarding

#### Introduction

This page is intended to give extended clarity regarding new Tenant onboarding within the CMS.

This process assumes the following activities have already occurred:

1. Regions have been added and tested.
2. Distributors and Partners have been added and tested.
3. Pricing has been established for the Region.

<table border="1" id="bkmrk-note%3A-the-steps-belo" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>**Note**: The steps below can be easily incorporated into an API driven workflow for CMS operators who already have a pre-existing customer front end. [The API is described here.](https://docs.cloudaxis.cloud/books/cms-for-azure-stack-hub/page/rest-api-overview)</td></tr></tbody></table>

---

#### Prerequisite Information

The table below attempts to help service providers with forward planning ahead of onboarding a new tenant.

<table border="1" id="bkmrk-prerequisite-questio" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 28.4863%;"></col><col style="width: 45.4125%;"></col><col style="width: 26.1012%;"></col></colgroup><thead><tr><td>Prerequisite</td><td>Question to Ask</td><td>Sample Answer</td></tr></thead><tbody><tr><td>Entra Tenant for Azure Stack and CMS Authentication.</td><td>Provide the Microsoft Entra Tenant you wish to use for Authentication to the Azure Stack?</td><td>nwtraders.onmicrosoft.com</td></tr><tr><td>Entra User to be the default / initial owner of the Azure Stack Subscription / CMS Tenant.</td><td>Provide the Entra user who will be the initial owner of the Azure Stack subscription?

This can be any user or guest user within the Entra Tenant?

</td><td>jdoe@northwindtraders.com.au</td></tr><tr><td>Billing Information (Tenant)</td><td>Provide the following Billing Contact information:

- Contact Name
- Contact Email Address
- Contact Phone Number
- Street Address
- City
- State / County / Region / Prefecture etc.
- Post Code

</td><td>John Doe

jdoe@northwindtraders.com.au

+61359763070

3 Schnapper Point Dr

Melbourne

Victoria

Australia

</td></tr><tr><td>Billing Information (Internal)</td><td>**If using the CMS for month end billing.**

- Payment Terms
- Billing Currency

</td><td>30 Days

Australian Dollar

</td></tr></tbody></table>

---

#### Create a new Tenant

The first step involves create a new Tenant within the CMS.

<table border="1" id="bkmrk-note%3A-this-links-the" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>**Note:** This links the Tenant to a Partner.</td></tr></tbody></table>

<table border="1" id="bkmrk-note%3A-follow-the-ste" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>**Note**: [Follow the steps here to create a new Tenant.](https://docs.cloudaxis.cloud/books/cms-for-azure-stack-hub/page/relationship-management#bkmrk-add-a-tenant)</td></tr></tbody></table>

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/aeMimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/aeMimage.png)

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/2tWimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/2tWimage.png)

---

#### Setup Users for the New Tenant

One the Tenant has been created; the next step is to create at least one Tenant Administrators.

<table border="1" id="bkmrk-note%3A-tenant-adminis" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr><td>**Note**: Tenant Administrators can then create and manage additional users and Administrators within the Tenant.</td></tr></tbody></table>

<table border="1" id="bkmrk-note%3A-follow-the-ste-1" style="border-collapse: collapse; width: 100%; height: 10px;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr style="height: 10px;"><td style="height: 10px;">**Note**: [Follow the steps here to create a new User](https://docs.cloudaxis.cloud/books/cms-for-azure-stack-hub/page/user-management#bkmrk-1.-add-a-new-tenant)</td></tr></tbody></table>

[![Q8Zimage.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/q8zimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/q8zimage.png)

[![WW6image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/ww6image.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/ww6image.png)

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/I3Wimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/I3Wimage.png)

<table border="1" id="bkmrk-note%3A-one-option-of-" style="border-collapse: collapse; width: 100%; height: 97.969px;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr style="height: 97.969px;"><td style="height: 97.969px;">Note: One option of interest is the CMS Login Allowed. This can be switched to Federated Only, ensuring the user cannot login using the CMS authentication flow and making the tenants Entra or Google authentication system responsible.

**In most cases, as the Azure Stack requires an Entra tenant in order to authenticate with the Azure Stack anyway, it is far easier to simply set CMS login Allowed to Federated Login Only as shown below.**

Again, this simply blocks the user from attempting CMS authentication and delegates the Auth responsibility to the tenants Entra authority.

</td></tr></tbody></table>

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/vnXimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/vnXimage.png)

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/AZYimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/AZYimage.png)

---

#### Create a new Subscription

Now that at least one user has been granted access to the CMS tenant, the first subscription can be created by a Platform Administrator, the Distributor who manages the Partner, the Partner who manages the Tenant or the Tenant themselves.

<table border="1" id="bkmrk-note%3A-follow-these-s" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>**Note**: [Follow these steps to create a new subscription.](https://docs.cloudaxis.cloud/books/cms-for-azure-stack-hub/page/subscription-management#bkmrk-add-a-subscription)</td></tr></tbody></table>

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/dHGimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/dHGimage.png)

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/NRyimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/NRyimage.png)

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/kRNimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/kRNimage.png)

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/ouMimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/ouMimage.png)

---

#### Register the Entra Tenant with the Azure Stack

<table border="1" id="bkmrk-note%3A-this-operation" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>Note: This operation is managed through the Azure Stack itself and requires the tenant to complete the process, the tenant must use an Entra user with permission to register Entra Applications. Such as a Global Administrator.</td></tr></tbody></table>

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/jtuimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/jtuimage.png)

<table border="1" id="bkmrk-note%3A-the-steps-to-c" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>**Note**: [The steps to complete the Azure Stack Entra Tenant registration can be found on the Microsoft website here.](https://docs.cloudaxis.cloud/books/cms-for-azure-stack-hub/page/subscription-management#bkmrk-add-a-subscription)</td></tr></tbody></table>

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/v5gimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/v5gimage.png)

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/dcJimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/dcJimage.png)

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/oVgimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/oVgimage.png)

---

#### Create bespoke Pricing

Some opportunities may have been sold to tenants with custom pricing or with credits which need to be applied each month. The section below continues the flow by showing custom pricing and credits being applied to specific Azure Stack VM SKUs.

<table border="1" id="bkmrk-note%3A-this-is-an-opt" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>**Note**: This is an optional step and only required if the tenant requires bespoke pricing or credits.</td></tr></tbody></table>

<table border="1" id="bkmrk-note%3A-follow-these-s-1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr><td>**Note**: [Follow these steps to create a new price list.](https://docs.cloudaxis.cloud/books/cms-for-azure-stack-hub/page/price-management#bkmrk-create-or-edit-a-pri)</td></tr></tbody></table>

<table border="1" id="bkmrk-note%3A-the-tenant-spe" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.881%;"></col></colgroup><tbody><tr><td>**Note**: The tenant specific price list will apply during the next usage collection run or can be updated on demand in the pricing page using the recalculate button.</td></tr></tbody></table>

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/HGNimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/HGNimage.png)

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/k00image.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/k00image.png)

[![image.png](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/scaled-1680-/ygyimage.png)](https://docs.cloudaxis.cloud/uploads/images/gallery/2025-09/ygyimage.png)