s

windows/security/threat-protection/windows-defender-atp/exposed-apis-create-app-nativeapp.md

@@ -26,23 +26,23 @@ ms.date: 09/03/2018
 [!include[Prerelease information](prerelease.md)]
 
 
-This page describe how to create an application to get programmatical access to Windows Defender ATP on behalf of a user.
+This page describe how to create an application to get programmatic access to Windows Defender ATP on behalf of a user.
 
-If you need programmatical access Windows Defender ATP without a user, refer to [Access Windows Defender ATP without a user](exposed-apis-create-app-webapp.md).
+If you need programmatic access Windows Defender ATP without a user, refer to [Access Windows Defender ATP with application context](exposed-apis-create-app-webapp.md).
 
 If you are not sure which access you need, read the [Introduction page](apis-intro.md).
 
-Windows Defender ATP exposes much of its data and actions through a set of programmatic APIs. Those APIs will enable you to automate workflows and innovate based on Windows Defender ATP capabilities. The API access requires OAuth2.0 authentication. For more information, see [OAuth 2.0 Authorization Code Flow](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-protocols-oauth-code).
+Windows Defender ATP exposes much of its data and actions through a set of programmatic APIs. Those APIs will enable you to automate work flows and innovate based on Windows Defender ATP capabilities. The API access requires OAuth2.0 authentication. For more information, see [OAuth 2.0 Authorization Code Flow](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-protocols-oauth-code).
 
 In general, you’ll need to take the following steps to use the APIs:
-- Create an app
-- Get an access token
+- Create an AAD application
+- Get an access token using this application
 - Use the token to access Windows Defender ATP API
 
-This page explains how to create an app, get an access token to Windows Defender ATP and validate the token includes the required permission.
+This page explains how to create an AAD application, get an access token to Windows Defender ATP and validate the token.
 
 >[!NOTE]
-> When accessing Windows Defender ATP API on behalf of a user, you will need the correct app permission and user permission.
+> When accessing Windows Defender ATP API on behalf of a user, you will need the correct App permission and user permission.
 > If you are not familiar with user permissions on Windows Defender ATP, see [Manage portal access using role-based access control](rbac-windows-defender-advanced-threat-protection.md). 
 
 >[!TIP]
@@ -50,7 +50,7 @@ This page explains how to create an app, get an access token to Windows Defender
 
 ## Create an app
 
-1.	Log on to [Azure](https://portal.azure.com).
+1.	Log on to [Azure](https://portal.azure.com) with user that has Global Administrator role.
 
 2.	Navigate to **Azure Active Directory** > **App registrations** > **New application registration**. 
 
@@ -75,13 +75,10 @@ This page explains how to create an app, get an access token to Windows Defender
 
     ![Image of API access and API selection](images/webapp-add-permission-2.png)
 
-6. Click **Select permissions** > check **Read alerts** and **Collect forensics** > **Select**.
+6. Click **Select permissions** > **Check the desired permissions** > **Select**.
 	
 	>[!IMPORTANT]
     >You need to select the relevant permissions. 'Read alerts' and 'Collect forensics' are only an example.
-
-    ![Image of select permissions](images/nativeapp-select-permissions.png)
-
 	For instance,
 
     - To [run advanced queries](run-advanced-query-api.md), select 'Run advanced queries' permission
@@ -89,6 +86,8 @@ This page explains how to create an app, get an access token to Windows Defender
 
        To determine which permission you need, look at the **Permissions** section in the API you are interested to call.
 
+    ![Image of select permissions](images/nativeapp-select-permissions.png)
+
 
 7. Click **Done**
 

windows/security/threat-protection/windows-defender-atp/exposed-apis-create-app-webapp.md

@@ -34,11 +34,11 @@ If you are not sure which access you need, see [Get started](apis-intro.md).
 Windows Defender ATP exposes much of its data and actions through a set of programmatic APIs. Those APIs will help you automate workflows and innovate based on Windows Defender ATP capabilities. The API access requires OAuth2.0 authentication. For more information, see [OAuth 2.0 Authorization Code Flow](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-v2-protocols-oauth-code).
 
 In general, you’ll need to take the following steps to use the APIs:
-- Create an app
-- Get an access token
+- Create an AAD application
+- Get an access token using this application
 - Use the token to access Windows Defender ATP API
 
-This page explains how to create an app, get an access token to Windows Defender ATP and validate the token includes the required permission.
+This page explains how to create an AAD application, get an access token to Windows Defender ATP and validate the token.
 
 ## Create an app
 
@@ -67,7 +67,7 @@ This page explains how to create an app, get an access token to Windows Defender
 
     ![Image of API access and API selection](images/webapp-add-permission-2.png)
 
-6. Click **Select permissions** > **Choose the desired permissions** > **Select**.
+6. Click **Select permissions** > **Check the desired permissions** > **Select**.
 	
 	**Important note**: You need to select the relevant permissions. 'Run advanced queries' is only an example!
 

windows/security/threat-protection/windows-defender-atp/prerelease.md

@@ -1,6 +1,5 @@
 ---
 ms.date: 08/28/2017
 ---
->[!IMPORTANT]
-	
+	>[!IMPORTANT]
 	>Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.