Skip to content

Commit 1ded751

Browse files
Merge pull request #249348 from csmulligan/csmulligan-ciam-guide
[CIAM] Promote ability to run get started guide on non-trial tenants (ADO-132738)
2 parents 402293e + a69d9d7 commit 1ded751

File tree

5 files changed

+97
-52
lines changed

5 files changed

+97
-52
lines changed
Loading
Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
title: Quickstart - Get started guide
3+
description: Use our quickstart guide to customize your tenant in just a few steps.
4+
services: active-directory
5+
author: csmulligan
6+
manager: CelesteDG
7+
ms.service: active-directory
8+
ms.workload: identity
9+
ms.subservice: ciam
10+
ms.topic: quickstart
11+
ms.date: 08/25/2023
12+
ms.author: cmulligan
13+
ms.custom: it-pro
14+
15+
#Customer intent: As a dev, devops, or IT admin, I want to personalize the customer tenant.
16+
---
17+
# Quickstart: Get started with our guide to run a sample app and sign in your users (preview)
18+
19+
In this quickstart, we'll guide you through customizing the look and feel of your apps in the customer tenant, setting up a user and configuring a sample app in only a few minutes. With these built-in customer configuration features, Azure AD for customers can serve as the identity provider and access management service for your customers.
20+
21+
## Prerequisites
22+
23+
- Azure AD for customers tenant. If you don't already have one, <a href="https://aka.ms/ciam-free-trial?wt.mc_id=ciamcustomertenantfreetrial_linkclick_content_cnl" target="_blank">sign up for a free trial</a> or [create a tenant with customer configurations in the Microsoft Entra admin center](quickstart-tenant-setup.md).
24+
25+
## Customize your sign-in experience
26+
27+
You can customize your customer's sign-in and sign-up experience in the Azure AD for customers tenant. Follow the guide that will help you set up the tenant in three easy steps. First you must specify how would you like your customer to sign in. At this step you can choose between two options: **Email and password** or **Email and one-time passcode**. You can configure social accounts later, which would allow your customers to sign in using their [Google](how-to-google-federation-customers.md) or [Facebook](how-to-facebook-federation-customers.md) account. You can also [define custom attributes](how-to-define-custom-attributes.md) to collect from the user during sign-up.
28+
29+
If you prefer, you can add your company logo, change the background color or adjust the sign-in layout. These optional changes will apply to the look and feel of all your apps in this tenant with customer configurations. After you have the created tenant, additional branding options are available. You can [customize the default branding](how-to-customize-branding-customers.md) and [add languages](how-to-customize-languages-customers.md). Once you're finished with the customization, select **Continue**.
30+
31+
:::image type="content" source="media/quickstart-trial-setup/customize-branding-in-trial-wizard.png" alt-text="Screenshot of customizing the sign-in experience in the guide.":::
32+
33+
## Try out the sign-up experience and create your first user
34+
35+
1. The guide will configure your tenant with the options you have selected. Once the configuration is complete, the button will change its text from **Setting up...** to **Run it now**.
36+
1. Select the **Run it now** button. A new browser tab will open with the sign-in page for your tenant that can be used to create and sign in users.
37+
1. Select **No account? Create one** to create a new user in the tenant.
38+
1. Add your new user's email address and select **Next**. Don't use the same email you used to create your trial.
39+
1. Complete the sign-up steps on the screen. Typically, once the user has signed in, they're redirected back to your app. However, since you haven’t set up an app at this step, you'll be redirected to JWT.ms instead, where you can view the contents of the token issued during the sign-in process.
40+
1. Go back to the guide tab. At this stage, you can either exit the guide and go to the admin center to explore the full range of configuration options for your tenant. Or you can **Continue** and set up a sample app. We recommend setting up the sample app, so that you can use it to test any further configuration changes you make
41+
42+
:::image type="content" source="media/quickstart-trial-setup/successful-trial-setup.png" alt-text="Screenshot that shows the successful creation of the sign-up experience.":::
43+
44+
## Set up a sample app
45+
46+
The get started guide will automatically configure sample apps for the below app types and languages:
47+
48+
- Single Page Application (SPA): JavaScript, React, Angular
49+
- Web app: Node.js (Express), ASP.NET Core
50+
51+
Follow the steps below, to download and run the sample app.
52+
53+
1. Proceed to set up the sample app by selecting the app type.
54+
1. Select your language and **Download sample app** on your machine.
55+
1. Follow the instructions to install and run the app. Sign into the sample app.
56+
57+
:::image type="content" source="media/quickstart-trial-setup/sample-app-setup.png" alt-text="Screenshot of the sample app setup.":::
58+
59+
1. You've completed the process of creating a trial tenant, configuring the sign-in experience, creating your first user, and setting up a sample app. Select **Continue** to go to the summary page, where you can either go to the admin center or you can restart the guide to choose different options.
60+
61+
## Explore Azure AD for customers
62+
63+
Follow the articles below to learn more about the configuration the guide created for you or to configure your own apps. You can always come back to the [admin center](https://entra.microsoft.com/) to customize your tenant and explore the full range of configuration options for your tenant.
64+
65+
> [!NOTE]
66+
> The next time you return to your tenant, you might be prompted to set up additional authentication factors for added security of your tenant admin account.
67+
68+
## Next steps
69+
- [Register an app in CIAM](how-to-register-ciam-app.md)
70+
- [Customize user experience for your customers](how-to-customize-branding-customers.md)
71+
- [Create a sign-up and sign-in user flow](how-to-user-flow-sign-up-sign-in-customers.md)
72+
- See the [Azure AD for customers Developer Center](https://aka.ms/ciam/dev) for the latest developer content and resources
73+

articles/active-directory/external-identities/customers/quickstart-tenant-setup.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,22 @@ In this quickstart, you'll learn how to create a tenant with customer configurat
6969

7070
:::image type="content" source="media/how-to-create-customer-tenant-portal/tenant-successfully-created.png" alt-text="Screenshot that shows the link to the new tenant.":::
7171

72+
## Customize your tenant with a guide
73+
74+
Our guide will walk you through the process of setting up a user and configuring a sample app in just a few minutes. This means that you can quickly and easily test out different sign-in and sign-up options and set up a sample app to see what works best for you. This guide is available in any customer tenant.
75+
76+
> [!NOTE]
77+
> The guide won’t run automatically in customer tenants that you created with the steps above. If you want to run the guide, follow the steps below.
78+
79+
1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com).
80+
1. If you have access to multiple tenants, use the **Directories + subscriptions** filter :::image type="icon" source="media/common/portal-directory-subscription-filter.png" border="false"::: in the top menu to switch to your customer tenant.
81+
1. Browse to **Home** > **Go to Microsoft Entra ID**
82+
1. On the Get started tab, select **Start the guide**.
83+
84+
:::image type="content" source="media/how-to-create-customer-tenant-portal/guide-link.png" alt-text="Screenshot that shows how to start the guide.":::
85+
86+
This link will take you to the [guide](quickstart-get-started-guide.md), where you can customize your tenant in three easy steps.
87+
7288
## Clean up resources
7389

7490
If you're not going to continue to use this tenant, you can delete it using the following steps:
@@ -86,6 +102,5 @@ The tenant and its associated information are deleted.
86102

87103

88104
## Next steps
89-
- [Customize the sign-in experience](how-to-customize-branding-customers.md)
90-
- [Register an app](how-to-register-ciam-app.md)
91-
- [Create user flows](how-to-user-flow-sign-up-sign-in-customers.md)
105+
106+
To learn more about the set-up guide and how to customize your tenant, see the [Get started guide](quickstart-get-started-guide.md) article.

articles/active-directory/external-identities/customers/quickstart-trial-setup.md

Lines changed: 2 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -51,52 +51,7 @@ During the free trial period, you'll have access to all product features with fe
5151

5252
:::image type="content" source="media/quickstart-trial-setup/setting-up-free-trial.png" alt-text="Screenshot of the loading page while setting up the customer tenant free trial.":::
5353

54-
## Customize your sign-in experience
54+
## Get started guide
5555

56-
You can customize your customer's sign-in and sign-up experience in the Azure AD for customers tenant. Follow the guide that will help you set up the tenant in three easy steps. First you must specify how would you like your customer to sign in. At this step you can choose between two options: **Email and password** or **Email and one-time passcode**. You can configure social accounts later, which would allow your customers to sign in using their [Google](how-to-google-federation-customers.md) or [Facebook](how-to-facebook-federation-customers.md) account. You can also [define custom attributes](how-to-define-custom-attributes.md) to collect from the user during sign-up.
57-
58-
If you prefer, you can add your company logo, change the background color or adjust the sign-in layout. These optional changes will apply to the look and feel of all your apps in this tenant with customer configurations. After you have the created tenant, additional branding options are available. You can [customize the default branding](how-to-customize-branding-customers.md) and [add languages](how-to-customize-languages-customers.md). Once you're finished with the customization, select **Continue**.
59-
60-
:::image type="content" source="media/quickstart-trial-setup/customize-branding-in-trial-wizard.png" alt-text="Screenshot of customizing the sign-in experience in the guide.":::
61-
62-
## Try out the sign-up experience and create your first user
63-
64-
1. The guide will configure your tenant with the options you have selected. Once the configuration is complete, the button will change its text from **Setting up...** to **Run it now**.
65-
1. Select the **Run it now** button. A new browser tab will open with the sign-in page for your tenant that can be used to create and sign in users.
66-
1. Select **No account? Create one** to create a new user in the tenant.
67-
1. Add your new user's email address and select **Next**. Don't use the same email you used to create your trial.
68-
1. Complete the sign-up steps on the screen. Typically, once the user has signed in, they're redirected back to your app. However, since you haven’t set up an app at this step, you'll be redirected to JWT.ms instead, where you can view the contents of the token issued during the sign-in process.
69-
1. Go back to the guide tab. At this stage, you can either exit the guide and go to the admin center to explore the full range of configuration options for your tenant. Or you can **Continue** and set up a sample app. We recommend setting up the sample app, so that you can use it to test any further configuration changes you make
70-
71-
:::image type="content" source="media/quickstart-trial-setup/successful-trial-setup.png" alt-text="Screenshot that shows the successful creation of the sign-up experience.":::
72-
73-
## Set up a sample app
74-
75-
The get started guide will automatically configure sample apps for the below app types and languages:
76-
77-
- Single Page Application (SPA): JavaScript, React, Angular
78-
- Web app: Node.js (Express), ASP.NET Core
79-
80-
Follow the steps below, to download and run the sample app.
81-
82-
1. Proceed to set up the sample app by selecting the app type.
83-
1. Select your language and **Download sample app** on your machine.
84-
1. Follow the instructions to install and run the app. Sign into the sample app.
85-
86-
:::image type="content" source="media/quickstart-trial-setup/sample-app-setup.png" alt-text="Screenshot of the sample app setup.":::
87-
88-
1. You've completed the process of creating a trial tenant, configuring the sign-in experience, creating your first user, and setting up a sample app. Select **Continue** to go to the summary page, where you can either go to the admin center or you can restart the guide to choose different options.
89-
90-
## Explore Azure AD for customers
91-
92-
Follow the articles below to learn more about the configuration the guide created for you or to configure your own apps. You can always come back to the [admin center](https://entra.microsoft.com/) to customize your tenant and explore the full range of configuration options for your tenant.
93-
94-
> [!NOTE]
95-
> The next time you return to your tenant, you might be prompted to set up additional authentication factors for added security of your tenant admin account.
96-
97-
## Next steps
98-
- [Register an app in CIAM](how-to-register-ciam-app.md)
99-
- [Customize user experience for your customers](how-to-customize-branding-customers.md)
100-
- [Create a sign-up and sign-in user flow](how-to-user-flow-sign-up-sign-in-customers.md)
101-
- See the [Azure AD for customers Developer Center](https://aka.ms/ciam/dev) for the latest developer content and resources
56+
Once your customer tenant free trial is ready, the next step is to personalize your customer's sign-in and sign-up experience, set up a user in your tenant, and configure a sample app. The get started guide will walk you through all of these steps in just a few minutes. For more information about the next steps see the [get started guide](quickstart-get-started-guide.md) article.
10257

articles/active-directory/external-identities/customers/toc.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,10 +13,12 @@ items:
1313
- name: Quickstarts
1414
expanded: true
1515
items:
16-
- name: Set up a free trial
16+
- name: Start a free trial without an Azure subscription
1717
href: quickstart-trial-setup.md
18-
- name: Set up a tenant
18+
- name: Create a tenant with an Azure subscription
1919
href: quickstart-tenant-setup.md
20+
- name: Get started guide walkthrough
21+
href: quickstart-get-started-guide.md
2022
- name: Samples
2123
expanded: true
2224
items:

0 commit comments

Comments
 (0)