Skip to content

Commit a2d1520

Browse files
committed
Updating the README.md and the tutorial's map
1 parent 15e53c6 commit a2d1520

File tree

3 files changed

+315
-294
lines changed

3 files changed

+315
-294
lines changed

README.md

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -36,14 +36,14 @@ In this tutorial, you will learn, incrementally, how to add sign-in users to you
3636
3737
### Details of the phases
3838

39-
1. The first phase is to [add sign-in to your Web App](1-WebApp-OIDC) leveraging the Microsoft identity platform for developers (fomerly Azure AD v2.0). You'll learn how to use the ASP.NET Core OpenID Connect (OIDC) middleware itself leveraging [Microsoft Identity Model extensions for .NET](https://github.com/AzureAD/azure-activedirectory-identitymodel-extensions-for-dotnet/wiki) to protect your Web App.
39+
1. The first phase is to [add sign-in users to your Web App](1-WebApp-OIDC) leveraging the Microsoft identity platform for developers (formerly Azure AD v2.0). You'll learn how to use the ASP.NET Core OpenID Connect (OIDC) middleware itself leveraging [Microsoft Identity Model extensions for .NET](https://github.com/AzureAD/azure-activedirectory-identitymodel-extensions-for-dotnet/wiki) to protect your Web App.
4040

4141
![Web apps signs-in users](ReadmeFiles/Web-app-signs-in-users.svg)
4242

4343
Depending on your business needs, you have the flexibility to decide which audience to sign-in to your application:
4444
1. If you are a Line of Business (LOB) developer, you'll want to [sign-in users in your organization](./1-WebApp-OIDC/1-1-MyOrg) with their work or school accounts.
4545
1. If you are an ISV, you'll want to [sign-in users in any organization](./1-WebApp-OIDC/1-2-AnyOrg), still with their work or school accounts.
46-
1. If you are an ISV targetting both organizations and individuals, you'll want to [sign-in users with their work and school accounts or Microsoft personal accounts](./1-WebApp-OIDC/1-3-AnyOrgOrPersonal).
46+
1. If you are an ISV targeting both organizations and individuals, you'll want to [sign-in users with their work and school accounts or Microsoft personal accounts](./1-WebApp-OIDC/1-3-AnyOrgOrPersonal).
4747
1. LOB developer or ISV, if you target organizations (work or school accounts), you can also enable your application to sign-in users in [national and sovereign clouds](./1-WebApp-OIDC/1-4-Sovereign).
4848
1. If you are a business wanting to connect with your customers, or with small business partners, you might also want to [sign-in users with their social identities](./1-WebApp-OIDC/1-5-B2C) using Microsoft Azure AD B2C.
4949
1. Finally, you'll want to let users [sign-out](./1-WebApp-OIDC/1-6-SignOut) of our application, or globally of the browser.
@@ -57,27 +57,31 @@ In this tutorial, you will learn, incrementally, how to add sign-in users to you
5757
1. Using the [authorization code flow](2-WebApp-graph-user/2-1-Call-MSGraph), initiated by ASP.NET Core, but completed by Microsoft Authentication Library for .NET (MSAL.NET)
5858
2. Learn how to [customize the token cache serialization](2-WebApp-graph-user/2-2-TokenCache)
5959
) with different technologies depending on your needs (in memory cache, Session token cache, SQL Cache, Redis Cache)
60-
3. Learn the [**coming soon**] [best practices and practices to avoid](./2-WebApp-graph-user/2-3-Best-Practices) when calling an API.
60+
3. Learn the [**Planned**] [best practices and practices to avoid](./2-WebApp-graph-user/2-3-Best-Practices) when calling an API.
6161

6262
3. Your Web App might also want to call other Web APIs than Microsoft Graph.
6363

6464
![Web apps calls Microsoft APIs](ReadmeFiles/web-app-calls-microsoft-apis.svg)
6565

66-
Learn how to [call several Microsoft APIS](./3-WebApp-multi-APIs), feature conditional access and claims challenge:
66+
Learn how to [call several Microsoft APIS](./3-WebApp-multi-APIs). This also explains how to handle conditional access, incremental consent and claims challenge:
6767

6868
1. the Azure Storage API. This is the opportunity to learn about incremental consent, and conditional access, and how to process them.
6969
2. the Azure ARM API. This is the opportunity to learn about admin consent.
7070

71+
> Note that this phase, contrary to the others, requires you to have an Azure Subscription
72+
7173
4. Then you might yourself have written a Web API, and want to call it from your Web App.
7274

7375
![Web apps calls Microsoft APIs](ReadmeFiles/web-app-calls-your-api.svg)
7476

75-
5. Once you know how to sign-in users and call Web APIs from your Web App, you might want to restrict part of the application depending on the user having a role in the application or belonging to a group. So far you've learnt how to add and process authentication. Now learn how to [add authorization to your Web application](./5-WebApp-AuthZ):
77+
Learn how to update your Web App to [call your own web api](./4-WebApp-your-API)
78+
79+
5. Once you know how to sign-in users and call Web APIs from your Web App, you might want to restrict part of the application depending on the user having a role in the application or belonging to a group. So far you've learnt how to add and process authentication. Now learn how to [add authorization to your Web application](./5-WebApp-AuthZ), restricting part of it to users
7680

77-
1. [with application roles](./5-WebApp-AuthZ/5-1-Roles)
78-
2. [with Azure AD groups](./5-WebApp-AuthZ/5-2-Groups)
81+
1. [based on their application roles](./5-WebApp-AuthZ/5-1-Roles)
82+
2. [based on their belonging to Azure AD groups](./5-WebApp-AuthZ/5-2-Groups)
7983

80-
6. [Planned] Chances are that you want to [deploy your complete app to Azure](./6-Deploy-to-Azure). Learn how to do that, applying best practices:
84+
6. Chances are that you want to [deploy your complete app to Azure](./6-Deploy-to-Azure). Learn how to do that, applying best practices:
8185

8286
1. Changing the app registration to add more ReplyUris
8387
2. Using certificates instead of client secrets
@@ -96,7 +100,6 @@ This tutorial only covers the case the Web App calls a Web API on behalf of a us
96100
### Pre-requisites
97101

98102
- Install .NET Core for Windows by following the instructions at [dot.net/core](https://dot.net/core), which will include [Visual Studio 2017](https://aka.ms/vsdownload).
99-
- An Internet connection
100103
- An Azure Active Directory (Azure AD) tenant. For more information on how to get an Azure AD tenant, see [How to get an Azure AD tenant](https://docs.microsoft.com/azure/active-directory/develop/quickstart-create-new-tenant)
101104
- A user account in your Azure AD tenant, or a Microsoft personal account
102105

0 commit comments

Comments
 (0)