|
| 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 | + |
0 commit comments