Skip to content

Commit 3249c03

Browse files
authored
Merge pull request AzureADQuickStarts#26 from AzureADQuickStarts/readme-updates
Update with Preview app registration steps
2 parents 167ca79 + 05377ab commit 3249c03

File tree

1 file changed

+33
-5
lines changed

1 file changed

+33
-5
lines changed

README.md

+33-5
Original file line numberDiff line numberDiff line change
@@ -15,12 +15,40 @@ To run this sample you will need the following:
1515

1616
## Register the sample
1717

18-
Create a new app at [apps.dev.microsoft.com](https://apps.dev.microsoft.com), or follow these [detailed steps](https://azure.microsoft.com/en-us/documentation/articles/active-directory-v2-app-registration/). Make sure to:
18+
1. Sign in to the [Azure portal](https://portal.azure.com/) using either a work or school account, or a personal Microsoft account.
1919

20-
- Copy down the **Application Id** assigned to your app, you'll need it soon.
21-
- Add the **Web** platform for your app.
22-
- Enter the correct **Redirect URI**. The redirect uri indicates to Azure AD where authentication responses should be directed - the default for this sample is `http://localhost:3000/auth/openid/return'`.
23-
- Add a new **Application secret** by clicking the **Generate new password** button. This value will not be displayed again, so save the result in a temporary location as you'll need it in the next step.
20+
1. If your account is present in more than one Azure AD tenant:
21+
- Select your profile from the menu on the top right corner of the page, and then **Switch directory**.
22+
- Change your session to the Azure AD tenant where you want to create your application.
23+
24+
1. Navigate to [Azure Active Directory > App registrations (Preview)](https://go.microsoft.com/fwlink/?linkid=2083908) to register your app.
25+
26+
1. Select **New registration.**
27+
28+
1. When the **Register an application** page appears, enter your app's registration information:
29+
- In the **Name** section, enter a meaningful name that will be displayed to users of the app. For example: MyWebApp
30+
- In the **Supported account types** section, select **Accounts in any organizational directory and personal Microsoft accounts (e.g. Skype, Xbox, Outlook.com)**.
31+
32+
If there are more than one redirect URIs, you'll need to add these from the **Authentication** tab later after the app has been successfully created.
33+
34+
1. Select **Register** to create the app.
35+
36+
1. On the app's **Overview** page, find the **Application (client) ID** value and record it for later. You'll need this value to configure the application later in this project.
37+
38+
1. In the list of pages for the app, select **Authentication**.
39+
- In the **Redirect URIs** section, select **Web** in the combo-box and enter the following redirect URI:
40+
`http://localhost:3000/auth/openid/return`
41+
- In the **Advanced settings** section, set **Logout URL** to `http://localhost:3000`.
42+
- In the **Advanced settings > Implicit grant** section, check **ID tokens** as this sample requires the [Implicit grant flow](https://docs.microsoft.com/azure/active-directory/develop/v2-oauth2-implicit-grant-flow) to be enabled to sign-in the user.
43+
44+
1. Select **Save**.
45+
46+
1. From the **Certificates & secrets** page, in the **Client secrets** section, choose **New client secret**.
47+
- Enter a key description (for instance app secret).
48+
- Select a key duration of either **In 1 year, In 2 years,** or **Never Expires**.
49+
- When you click the **Add** button, the key value will be displayed. Copy the key value and save it in a safe location.
50+
51+
You'll need this key later to configure the application. This key value will not be displayed again, nor retrievable by any other means, so record it as soon as it is visible from the Azure portal.
2452

2553

2654
## Download the sample application and modules

0 commit comments

Comments
 (0)