Skip to content

Commit 7075859

Browse files
committed
Update README.md based on feedback
1 parent 2a9a62b commit 7075859

1 file changed

Lines changed: 11 additions & 8 deletions

File tree

README.md

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,11 @@ If you want to register your apps manually, as a first step you'll need to:
7272

7373
1. Open the **app.config** file located in **TodoListClient** project's root folder and then paste **Application Id** from the application you just registered for your *TodoListService* under `TodoListServiceScope` parameter, replacing the string `{Enter the Application Id of your TodoListService from the app registration portal}`.
7474

75-
> Note: Make sure it uses has the format `api://{TodoListService-Application-Id}/access_as_user` (where {TodoListService-Application-Id} is the Guid representing the Application Id for your TodoListService).
75+
> Note: Make sure it uses the following format:
76+
>
77+
> `api://{TodoListService-Application-Id}/access_as_user`
78+
>
79+
>(where {TodoListService-Application-Id} is the Guid representing the Application Id for your TodoListService).
7680
7781
### Step 3: Register the client app (TodoListClient)
7882

@@ -84,34 +88,33 @@ In this step, you configure your *TodoListClient* project by registering a new a
8488
1. Select **New registration**.
8589
1. When the **Register an application page** appears, enter your application's registration information:
8690
- In the **Name** section, enter a meaningful application name that will be displayed to users of the app, for example `NativeClient-DotNet-TodoListClient`.
87-
- Change **Supported account types** to **Accounts in any organizational directory and personal Microsoft accounts (e.g. Skype, Xbox, Outlook.com)**.
91+
- Change **Supported account types** to **Accounts in any organizational directory**.
8892
- Select **Register** to create the application.
89-
1. On the app **Overview** page, find the **Application (client) ID** value and record it for later. You'll need it to configure the Visual Studio configuration file for this project (`ida:ClientId` in `TodoListClient\App.Config`).
9093
1. From the app's Overview page, select the **Authentication** section.
9194
- In the **Redirect URLs** | **Suggested Redirect URLs for public clients (mobile, desktop)** section, check **urn:ietf:wg:oauth:2.0:oob**
9295
- Select **Save**.
9396
1. Select the **API permissions** section
9497
- Click the **Add a permission** button and then,
95-
- Ensure that the **My APIs** tab is selected
98+
- Select the **My APIs** tab.
9699
- In the list of APIs, select the `AppModelv2-NativeClient-DotNet-TodoListService API`, or the name you entered for the Web API.
97-
- In the **Delegated permissions** section, ensure that the right permissions are checked: **access_as_user**. Use the search box if necessary.
100+
- Check the **access_as_user** permission if it's not already checked. Use the search box if necessary.
98101
- Select the **Add permissions** button
99102

100103
#### Configure your *TodoListClient* project
101104

102-
1. In the *Application registration portal*, copy the value of the **Application Id**
105+
1. In the *Application registration portal*, in the **Overview** page copy the value of the **Application (client) Id**
103106
1. Open the **app.config** file located in the **TodoListClient** project's root folder and then paste the value in the `ida:ClientId` parameter value
104107

105108
### Step 4: Run your project
106109

107110
1. Press `<F5>` to run your project. Your *TodoListClient* should open.
108-
1. Select **Sign in** in the top right and sign in with the same user you have used to register your aplication, or a user in the same directory.
111+
1. Select **Sign in** in the top right and sign in with the same user you have used to register your application, or a user in the same directory.
109112
1. At this point, if you are signing in for the first time, you may be prompted to consent to *TodoListService* Web Api.
110113
1. The sign-in also request the access token to the *access_as_user* scope to access *TodoListService* Web Api and manipulate the *To-Do* list.
111114

112115
### Step 5: Pre-authorize your client application
113116

114-
One of the ways to allow users from other directories to acces your Web API is by *pre-authorizing* the client applications to access your Web API by adding the Application Ids from client applications in the list of *pre-authorized* applications for your Web API. By adding a pre-authorized client, you will not require user to consent to use your Web API. Follow the steps below to pre-authorize your Web Application::
117+
One of the ways to allow users from other directories to access your Web API is by *pre-authorizing* the client applications to access your Web API by adding the Application Ids from client applications in the list of *pre-authorized* applications for your Web API. By adding a pre-authorized client, you will not require user to consent to use your Web API. Follow the steps below to pre-authorize your Web Application::
115118

116119
1. Go back to the *Application registration portal* and open the properties of your **TodoListService**.
117120
1. In the **Expose an API** section, click on **Add application** under the *Pre-authorized applications* section.

0 commit comments

Comments
 (0)