There are two ways to authenticate to the APM OData API:

• For jobs that run in the background, without user interaction, you can authenticate with client credentials. A self-serve portal for creating and managing these credentials is coming in the future; however, for now contact Bentley Support. They can generate and provide a whitelisted clientid and secret to access your data
• For access to reliability data that involves user interaction, your organization’s administrator can use the Bentley Role-Based Access Control (RBAC) portal to give individuals in your organization Read access

Your organization’s administrators have access to manage roles and permissions for your organization. They can follow the instructions in this section to manage user access to the APM OData API. This article explains how to use the RBAC portal to manage user roles.

For related information, see Roles and Permissions.

To Work with Roles and Permissions

1. Go to Bentley CONNECT Center and sign in.

2. Click your company name at the top to access the Subscription Services Portal.

3. Scroll down to the Resources section and click the Roles and Permissions tile:

4. This takes you to the RBAC portal. To manage roles for your organization, click Define Roles.

On the left side of the screen, you will see a list of roles defined for your organization. For example:

Tip In the Service Access and Permissions list, expand the Reliability node. The Read permission is required to access the APM OData API. You can either add the Read permission to an existing role or create a new role that can be used to assign the role to users.

In this article, we will create a new role and assign it to users.

5. Click New Role in the top right.

6. In the Create New Enterprise Role dialog, provide a name and description for the new role, for example, “Reliability API User”.

7. Click Save. The dialog closes and your new role is selected on the left side.

8. On the right side, select "Read" under the Reliability service. Click Save.

9. Now that you have created the role with the required permission, you can assign it to users. Click Manage Users:

10. Ensure that “All Users” is selected in the role filter. You should see a list of users in your organization.

11. Select the users you wish to assign the role. Click Modify Roles. For example:

12. Select the Role you defined previously to assign it to the users.

13. Click Review. You will see that the role has now been assigned to the users.

14. Click Submit. The users can now authenticate and use the APM OData API.

Users with the Reliability API User role can access the AssetWise Reliability OData API Swagger page (https://reliability.bentley.com/odata/swagger/index.html). The page provides information about building basic queries, including syntax and authentication. You can use the “try out” functionality on the Swagger page to see queries at work.

Next, set up Postman to build queries.