Skip to content

Commit 4aaa20c

Browse files
authored
Update how-to-manage-users.md
1 parent d2cd17f commit 4aaa20c

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

articles/energy-data-services/how-to-manage-users.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,14 @@ ms.custom: template-how-to
1010
---
1111

1212
# How to manage users
13-
In this article, you'll learn how to manage users and their memberships in OSDU groups in Azure Data Manager for Energy. [Entitlements APIs](https://community.opengroup.org/osdu/platform/security-and-compliance/entitlements/-/tree/master/) are used to add or remove users to OSDU groups and to check the entitlements when the user tries to access the OSDU services or data. For more information about OSDU groups, see [entitlement services](concepts-entitlements.md).
13+
In this article, you learn how to manage users and their memberships in OSDU groups in Azure Data Manager for Energy. [Entitlements APIs](https://community.opengroup.org/osdu/platform/security-and-compliance/entitlements/-/tree/master/) are used to add or remove users to OSDU groups and to check the entitlements when the user tries to access the OSDU services or data. For more information about OSDU groups, see [entitlement services](concepts-entitlements.md).
1414

1515

1616
## Prerequisites
1717
1. Create an Azure Data Manager for Energy instance using the tutorial at [How to create Azure Data Manager for Energy instance](quickstart-create-microsoft-energy-data-services-instance.md).
1818
2. Generate the access token needed to call the Entitlements APIs.
1919
3. Get various parameters of your instance such as client-id, client-secret, etc.
20-
4. Keep all these parameter values handy as they will be needed for executing different user management requests via the Entitlements API.
20+
4. Keep all these parameter values handy as they are needed for executing different user management requests via the Entitlements API.
2121

2222
## Fetch Parameters
2323
#### Find `tenant-id`
@@ -30,7 +30,7 @@ In this article, you'll learn how to manage users and their memberships in OSDU
3030
:::image type="content" source="media/how-to-manage-users/tenant-id.png" alt-text="Screenshot of finding the tenant-id.":::
3131

3232
#### Find `client-id`
33-
It's the same value that you 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`.
33+
It's 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 is often referred to as `app-id`.
3434

3535
1. Find the `client-id` in the *Essentials* pane of Azure Data Manager for Energy *Overview* page.
3636
2. Copy the `client-id` and paste it into an editor to be used later.
@@ -99,7 +99,7 @@ curl --location --request POST 'https://login.microsoftonline.com/<tenant-id>/oa
9999
"access_token": "abcdefgh123456............."
100100
}
101101
```
102-
2. Copy the `access_token` value from the response. You'll need it to pass as one of the headers in all calls to the Entitlements APIs.
102+
2. Copy the `access_token` value from the response. You need it to pass as one of the headers in all calls to the Entitlements APIs.
103103

104104
## Fetch OID
105105
`object-id` (OID) is the Microsoft Entra user Object ID.
@@ -112,7 +112,7 @@ curl --location --request POST 'https://login.microsoftonline.com/<tenant-id>/oa
112112
:::image type="content" source="media/how-to-manage-users/profile-object-id.png" alt-text="Screenshot of finding the object-id from the profile.":::
113113

114114
## First time addition of users in a new data partition
115-
In order to add entitlements to a new data partition of Azure Data Manager for Energy instance, use the SPN token of the app which was used to provision the instance. If you try to directly use user tokens for adding entitlements, it results in 401 error. The SPN token must be used to add initial users in the system and those users (with admin access) can manage rest of the additional users.
115+
In order to add entitlements to a new data partition of Azure Data Manager for Energy instance, use the SPN token of the app that was used to provision the instance. If you try to directly use user tokens for adding entitlements, it results in 401 error. The SPN token must be used to add initial users in the system and those users (with admin access) can then manage additional users.
116116

117117
The SPN is generated using client_credentials flow
118118
```bash
@@ -135,7 +135,7 @@ Run the below curl command in Azure Cloud Bash to get all the groups that are av
135135
--header 'Authorization: Bearer <access_token>'
136136
```
137137

138-
## Add user(s) to a OSDU group in a data partition
138+
## Add user(s) to an OSDU group in a data partition
139139

140140
1. Run the below curl command in Azure Cloud Bash to add the user(s) to the "Users" group using the Entitlement service.
141141
2. The value to be sent for the param **"email"** is the **Object_ID (OID)** of the user and not the user's email.

0 commit comments

Comments
 (0)