API Authentication¶

EnOS API authentication uses service accounts (SA) to verify the identity of applications or developers. When making requests to the EnOS API, application developers need to send the SA to EnOS, which will use it to verify the user’s identity and perform the necessary authorized access.

Prerequisites¶

Make sure your account in EnOS Application Portal has the role of DCM Admin or App Developer and can access the Developer Console. If not, contact the OU administrator to assign a role to your account.

Step 1: Getting the Service Account¶

Operated By: Application Developer

Service account(SA) consists of AccessKey and SecretKey of the application. One application corresponds to one SA. You need to first get the SA of the application as the credentials for calling the EnOS APIs.

Log in to EnOS Application Portal, select the button in the upper right corner, enter the Developer Console, and select App > Application Registration in the left navigation bar.
Select 1 existing application, or add a new application to the OU using any of the following methods:
- Register an application: Create a new application from scratch within the OU. See Registering an Application.
- Obtain an application: Obtain 1 existing application from another OU to the current OU. See Obtaining an Application.
Under the OU Apps or Obtained tab, click the application card to open the Application Details page and view the application’s AccessKey and SecretKey.

Step 2: (Optional)Getting API Calling Permissions¶

Operated By: Application Developer

Note

By default, you can call the EnOS APIs without any authorization. Only before calling the following APIs, you need to get API calling permissions for your application:

Model Service

Connection Service

Asset Service

Asset Tree Service

If you do not need to call these APIs, you can skip this step.

Follow these steps to assign API call permissions to your application:

Log in to EnOS Application Portal, select the button in the upper right corner, enter the Developer Console, and select Application > API Management > API Authorization in the left navigation bar.
Select New Authorization, and configure the following information:
- Authorized Application: Select your application name.
- Authorization Method: Select Manually and check the APIs that require authorization in the API list below.

Results¶

You can use the application SA to get or update specified resources by referring to Invoking EnOS APIs Using EnOS SDKs or Invoking EnOS APIs Using Access Token.