changing repos

Author: BobbySchmidt2

articles/active-directory/develop/scenario-protected-web-api-app-configuration.md

@@ -23,20 +23,24 @@ ms.collection: M365-identity-device-management
 
 # Protected web API: Code configuration
 
-To configure the code for your protected web API, you need to understand what defines APIs as protected, how to configure a bearer token, and how to validate the token.
+To configure the code for your protected web API, you need to understand:
 
-## What defines ASP.NET/ASP.NET Core APIs as protected?
+- What defines APIs as protected.
+- How to configure a bearer token.
+- How to validate the token.
 
-Like web apps, the ASP.NET and ASP.NET Core web APIs are protected because their controller actions are prefixed with the `[Authorize]` attribute. So the controller actions can be called only if the API is called with an authorized identity.
+## What defines ASP.NET and ASP.NET Core APIs as protected?
+
+Like web apps, the ASP.NET and ASP.NET Core web APIs are protected because their controller actions are prefixed with the **[Authorize]** attribute. The controller actions can be called only if the API is called with an authorized identity.
 
 Consider the following questions:
 
-- How does the web API know the identity of the app that calls it, since only an app can call a web API?
-- If the app called the web API on behalf of a user, what's the user's identity?
+- Only an app can call a web API. How does the API know the identity of the app that calls it?
+- If the app calls the API on behalf of a user, what's the user's identity?
 
 ## Bearer token
 
-Unless the web app accepts service-to-service calls from a daemon app, information about the app identity and about the user is held in the bearer token that's set in the header when the app is called.
+The bearer token that's set in the header when the app is called holds information about the app identity. It also holds information about the user unless the web app accepts service-to-service calls from a daemon app.
 
 Here's a C# code example that shows a client calling the API after it acquires a token with Microsoft Authentication Library for .NET (MSAL.NET):
 
@@ -55,7 +59,7 @@ HttpResponseMessage response = await _httpClient.GetAsync(apiUri);
 > [!IMPORTANT]
 > A client application requests the bearer token to the Microsoft identity platform endpoint *for the web API*. The web API is the only application that should verify the token and view the claims it contains. Client apps should never try to inspect the claims in tokens.
 >
-> In the future, the web API could require that the token be encrypted. This requirement would prevent access for client apps that can view access tokens.
+> In the future, the web API might require that the token be encrypted. This requirement would prevent access for client apps that can view access tokens.
 
 ## JwtBearer configuration
 
@@ -91,9 +95,9 @@ This section describes how to configure a bearer token.
 
 ### Code initialization
 
-When an app is called on a controller action that holds an `[Authorize]` attribute, ASP.NET and ASP.NET Core look at the bearer token in the Authorization header of the calling request and extracts the access token. The token is then forwarded to the JwtBearer middleware, which calls Microsoft IdentityModel Extensions for .NET.
+When an app is called on a controller action that holds an **[Authorize]** attribute, ASP.NET and ASP.NET Core extract the access token from the Authorization header's bearer token. The access token is then forwarded to the JwtBearer middleware, which calls Microsoft IdentityModel Extensions for .NET.
 
-In ASP.NET Core, this middleware is initialized in the Startup.cs file:
+In ASP.NET Core, this middleware is initialized in the Startup.cs file.
 
 ```csharp
 using Microsoft.AspNetCore.Authentication.JwtBearer;
@@ -105,7 +109,7 @@ The middleware is added to the web API by this instruction:
  services.AddAzureAdBearer(options => Configuration.Bind("AzureAd", options));
 ```
 
- Currently, the ASP.NET Core templates create Azure Active Directory (Azure AD) web APIs that sign in users within your organization or any organization. They do not sign in users with personal accounts. But you can easily change the templates to use the Microsoft identity platform endpoint by adding this code to the Startup.cs file:
+ Currently, the ASP.NET Core templates create Azure Active Directory (Azure AD) web APIs that sign in users within your organization or any organization. They don't sign in users with personal accounts. But you can change the templates to use the Microsoft identity platform endpoint by adding this code to the Startup.cs file:
 
 ```csharp
 services.Configure<JwtBearerOptions>(AzureADDefaults.JwtBearerAuthenticationScheme, options =>
@@ -127,19 +131,19 @@ services.Configure<JwtBearerOptions>(AzureADDefaults.JwtBearerAuthenticationSche
 });
 ```
 
-This preceding code snippet is extracted from the ASP.NET Core Web Api incremental tutorial in [Microsoft.Identity.Web/WebApiServiceCollectionExtensions.cs#L50-L63](https://github.com/Azure-Samples/active-directory-dotnet-native-aspnetcore-v2/blob/154282843da2fc2958fad151e2a11e521e358d42/Microsoft.Identity.Web/WebApiServiceCollectionExtensions.cs#L50-L63). The **AddProtectedWebApi** method, which does a lot more, is called from Startup.cs.
+This preceding code snippet is extracted from the ASP.NET Core web API incremental tutorial in [Microsoft.Identity.Web/WebApiServiceCollectionExtensions.cs#L50-L63](https://github.com/Azure-Samples/active-directory-dotnet-native-aspnetcore-v2/blob/154282843da2fc2958fad151e2a11e521e358d42/Microsoft.Identity.Web/WebApiServiceCollectionExtensions.cs#L50-L63). The **AddProtectedWebApi** method, which does more than the snippet shows, is called from Startup.cs.
 
 ## Token validation
 
-In the preceding snippet, the JwtBearer middleware, like the OpenID Connect middleware in web apps, is directed by the value of `TokenValidationParameters` to validate the token. The token is decrypted as needed, the claims are extracted, and the signature is verified. The middleware then validates the token by checking for this data:
+In the preceding snippet, the JwtBearer middleware, like the OpenID Connect middleware in web apps, validates the token based on the value of `TokenValidationParameters`. The token is decrypted as needed, the claims are extracted, and the signature is verified. The middleware then validates the token by checking for this data:
 
 - Audience: The token is targeted for the web API.
-- Sub: The token was issued for an app that's allowed to call the web API.
-- Issuer: The token was issued by a trusted security token service (STS).
-- Expiry: The token's lifetime is in range.
-- Signature: The token wasn't tampered with.
+- Sub: It was issued for an app that's allowed to call the web API.
+- Issuer: It was issued by a trusted security token service (STS).
+- Expiry: Its lifetime is in range.
+- Signature: It wasn't tampered with.
 
-There can also be special validations. For example, it's possible to validate that signing keys, when embedded in a token, are trusted and that the token isn't being replayed. Also, some protocols require specific validations.
+There can also be special validations. For example, it's possible to validate that signing keys, when embedded in a token, are trusted and that the token isn't being replayed. Finally, some protocols require specific validations.
 
 ### Validators
 
@@ -150,19 +154,19 @@ The validators are described in this table:
 | Validator | Description |
 |---------|---------|
 | **ValidateAudience** | Ensures the token is for the application that validates the token for you. |
-| **ValidateIssuer** | Ensures the token was issued by a trusted STS, meaning from someone you trust. |
-| **ValidateIssuerSigningKey** | Ensures the application validating the token trusts the key that was used to sign the token. The is a special case where the key is embedded in the token. But this case does not usually arise. |
-| **ValidateLifetime** | Ensures the token is still or already valid. The validator checks if the lifetime of the token, meaning the **notbefore** and **expires** claims, is in range. |
+| **ValidateIssuer** | Ensures the token was issued by a trusted STS, meaning it's from someone you trust. |
+| **ValidateIssuerSigningKey** | Ensures the application validating the token trusts the key that was used to sign the token. There's a special case where the key is embedded in the token. But this case doesn't usually arise. |
+| **ValidateLifetime** | Ensures the token is still or already valid. The validator checks if the lifetime of the token is in the range specified by the **notbefore** and **expires** claims. |
 | **ValidateSignature** | Ensures the token hasn't been tampered with. |
-| **ValidateTokenReplay** | Ensures the token isn't replayed. There is a special case for some onetime-use protocols. |
+| **ValidateTokenReplay** | Ensures the token isn't replayed. There's a special case for some onetime-use protocols. |
 
-The validators are associated with properties of the **TokenValidationParameters** class. The properties are initialized from the ASP.NET and ASP.NET Core configuration. In most cases, you won't need to change the parameters.
+The validators are associated with properties of the **TokenValidationParameters** class. The properties are initialized from the ASP.NET and ASP.NET Core configuration. In most cases, you don't need to change the parameters.
 
-There's one exception for apps that aren't single tenants. These are web apps that accept users from any organization or from personal Microsoft accounts. In this case, the issuer must be validated.
+Apps that aren't single tenants are exceptions. These web apps accept users from any organization or from personal Microsoft accounts. In this case, issuers must be validated.
 
 ## Token validation in Azure Functions
 
-It's also possible to validate incoming access tokens in Azure Functions. You can find examples of validating tokens in Azure Functions in [Microsoft .NET](https://github.com/Azure-Samples/ms-identity-dotnet-webapi-azurefunctions), [NodeJS](https://github.com/Azure-Samples/ms-identity-nodejs-webapi-azurefunctions), and [Python](https://github.com/Azure-Samples/ms-identity-python-webapi-azurefunctions).
+You can also validate incoming access tokens in Azure Functions. You can find examples of such validation in [Microsoft .NET](https://github.com/Azure-Samples/ms-identity-dotnet-webapi-azurefunctions), [NodeJS](https://github.com/Azure-Samples/ms-identity-nodejs-webapi-azurefunctions), and [Python](https://github.com/Azure-Samples/ms-identity-python-webapi-azurefunctions).
 
 ## Next steps