# Complete your Marketplace onboarding

Welcome to Axiad Mesh! After you purchase Axiad Mesh from the Azure Marketplace,
a short wizard helps you finish setting up your account. This guide walks you
through every screen, in order, exactly as you'll see it. It takes about
**10 minutes**.

## Before you begin

- You've purchased Axiad Mesh on the Azure Marketplace and can open your
  subscription setup page from **Configure account now**.
- You'll need three values from your organization's **Microsoft Entra ID**: a
  **Tenant ID**, an **Application (client) ID**, and a **Client Secret Value**.
  Links to Microsoft's official guides are included at each field.
- You know the name of the group that should have **administrator** access in
  Mesh.

> **note**
If you don't have your Microsoft Entra ID details, ask your Microsoft Entra
administrator before you start. You can gather them and return to onboarding.

## Step 1 — Start onboarding

After you select **Configure account now** on the Azure Marketplace, your Axiad
Mesh subscription setup page opens. Review your subscription details, then select
**Start Onboarding**.

![Axiad Mesh subscription setup page with the Start Onboarding button](/img/getting-started/onboarding-wizard/01-marketplace-landing-page.png)

The onboarding wizard opens on a welcome screen. At the bottom of the screen,
select **Manual Wizard** to set up your account step by step.

![Onboarding welcome screen](/img/getting-started/onboarding-wizard/02-onboarding-selection.png)

## Step 2 — Tell us about your organization

On the **Profile** step, enter your **Company name**, then choose your
**Company size** and **Industry**.

![Profile step with empty fields](/img/getting-started/onboarding-wizard/03-organization-profile-empty.png)

Once your details are filled in, select **Continue**.

![Profile step with the details completed](/img/getting-started/onboarding-wizard/04-organization-profile-filled.png)

## Step 3 — Set up your identity provider

On the **Set up primary IdP** step, connect **Microsoft Entra ID** so your team
can sign in with the work accounts they already use. You'll see this form:

![Identity provider form, top section](/img/getting-started/onboarding-wizard/05-configure-idp-part-1.png)

![Identity provider form, lower section](/img/getting-started/onboarding-wizard/06-configure-idp-part-2.png)

Fill in the fields:

- **Domain** — your organization's email domain (for example, `contoso.com`).
- **Provider** — leave this set to **Microsoft Entra ID**.
- **Instance Type** — choose **Commercial** unless your organization uses Azure
  Government, in which case choose **US Gov**. If you're not sure, choose
  **Commercial**.
- **Microsoft Entra tenant ID** — to find this value, see Microsoft's guide,
  [Find your Microsoft Entra tenant ID](https://learn.microsoft.com/en-us/entra/fundamentals/how-to-find-tenant),
  then paste it here.
- **Application (client) ID** — to get this value, follow Microsoft's guide,
  [Register an application in Microsoft Entra ID](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app),
  then paste it here.
- **Client secret value** — to create one, follow Microsoft's guide,
  [Add a client secret](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app#add-a-client-secret),
  then paste the value here.

Once your details are entered, the form looks like this:

![Identity provider form completed, top section](/img/getting-started/onboarding-wizard/07-configure-idp-filled-part-1.png)

![Identity provider form completed, with Test Connection](/img/getting-started/onboarding-wizard/08-configure-idp-filled-part-2.png)

> **warning**
Microsoft shows the client secret **Value** only once, right after you create
it. Copy it into Mesh before you leave Microsoft — otherwise you'll need to
create a new one.

Select **Test Connection**. When you see **Connection successful**, select
**Continue**.

![Test Connection showing a successful result](/img/getting-started/onboarding-wizard/09-test-connection-success.png)

## Step 4 — Assign admin groups

On the **Assign admins** step, decide which groups have **administrator** access
in Mesh. In the **Admin groups** field, type each group's display name exactly as
it appears in your directory, pressing **Enter** (or using commas) to add each
one.

![Assign admins step before adding a group](/img/getting-started/onboarding-wizard/10-admin-groups-empty.png)

Each group you add appears as a tag.

![Assign admins step with a group added](/img/getting-started/onboarding-wizard/11-admin-groups-filled.png)

> **tip**
Add a group that you belong to, so you'll keep administrator access once
onboarding is complete. Only members of the groups you add will have admin
access.

When you're ready, select **Nominate groups & finish**.

## Step 5 — Finish and sign in

A confirmation appears. Select **Finish initial configurations**. Mesh completes
the onboarding process and redirects you to the sign-in page.

![Confirmation before finishing onboarding](/img/getting-started/onboarding-wizard/12-finish-onboarding.png)

You're taken to the sign-in page. Enter your work email and select **Sign In** —
continue signing in with your work account.

![Axiad Mesh sign-in page](/img/getting-started/onboarding-wizard/13-sign-in-page.png)

## Verify

- The **Test Connection** check showed **Connection successful**.
- You can sign in with your work email.
- Members of the groups you added have administrator access in Mesh.

## Next step

Once you've signed in, continue with the end-user onboarding guide to get
started in the product.

➡️ [End-user onboarding](../user-guide/end-user-onboarding.md)
