Skip to content

Commit e1fdc6b

Browse files
committed
improve doc
1 parent 4963112 commit e1fdc6b

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

articles/energy-data-services/how-to-generate-auth-token.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ In this article, you learn how to generate the service principal auth token, a u
1717
## Register your app with Microsoft Entra ID
1818

1919
1. To provision the Azure Data Manager for Energy platform, you must register your app on the [Azure portal app registration page](https://go.microsoft.com/fwlink/?linkid=2083908). You can use either a Microsoft account or a work or school account to register an app. For steps on how to configure, see [Register your app documentation](../active-directory/develop/quickstart-register-app.md#register-an-application).
20-
1. In the app overview section, if there are no redirect URIs specified, you can select **Add a platform** > **Web**, add `http://localhost:8080`, and select **Save**.
20+
1. In the application overview section, if no redirect Uniform Resource Identifiers (URIs) are specified, select **Add a platform** > **Web**, add `http://localhost:8080`, and then select **Save**.
2121

2222
:::image type="content" source="media/how-to-generate-auth-token/app-registration-uri.png" alt-text="Screenshot that shows adding the URI to the app.":::
2323

@@ -38,7 +38,7 @@ You can also find the parameters after the app is registered on the Azure portal
3838

3939
### Find client-id
4040

41-
A `client-id` is the same value that you use to register your application during the provisioning of your [Azure Data Manager for Energy instance](quickstart-create-microsoft-energy-data-services-instance.md). It's often referred to as `app-id`.
41+
A `client-id` is the value used to register your application during the provisioning of your [Azure Data Manager for Energy instance](quickstart-create-microsoft-energy-data-services-instance.md). It is often referred to as `app-id`.
4242

4343
1. Go to the Azure Data Manager for Energy **Overview** page. On the **Essentials** pane, find **client ID**.
4444
1. Copy the `client-id` value and paste it into an editor to be used later.
@@ -51,7 +51,7 @@ A `client-id` is the same value that you use to register your application during
5151

5252
### Find client-secret
5353

54-
A `client-secret` is a string value your app can use in place of a certificate to identify itself. It's sometimes referred to as an application password.
54+
A `client-secret` is a string value your app can use in place of a certificate to identify itself. It is sometimes called an application password.
5555

5656
1. Go to **App registrations**.
5757
1. Under the **Manage** section, select **Certificates & secrets**.
@@ -159,11 +159,11 @@ The first step to get an access token for many OpenID Connect (OIDC) and OAuth 2
159159
|Parameter| Description|
160160
| --- | --- |
161161
|code|The authorization code that the app requested. The app can use the authorization code to request an access token for the target resource. Authorization codes are short lived. Typically, they expire after about 10 minutes.|
162-
|state|If a state parameter is included in the request, the same value should appear in the response. The app should verify that the state values in the request and response are identical. This check helps to detect [CSRF attacks](https://tools.ietf.org/html/rfc6749#section-10.12) against the client.|
162+
|state|If a state parameter is included in the request, the same value should appear in the response. The app should verify that the state values in the request and response are identical. This check helps to detect Cross-Site Request Forgery (CSRF) attacks. For more information, see [CSRF attacks](https://tools.ietf.org/html/rfc6749#section-10.12).|
163163
|session_state|A unique value that identifies the current user session. This value is a GUID, but it should be treated as an opaque value that's passed without examination.|
164164

165165
> [!WARNING]
166-
> Running the URL in other GUI-based API clients won't work because they require extra configuration for token retrieval.
166+
> Running the URL in other GUI-based API clients doesn't work because they require extra configuration for token retrieval.
167167
168168
### Get an auth token and a refresh token
169169

0 commit comments

Comments
 (0)