Get access key

Only users with Team administrator or Trimble Developer role can publish API through CI/CD. To obtain the access keys for invoking the API Automation APIs, you need to:

1. Register your service application in Trimble Cloud Console.
2. Subscribe Service Application to API Cloud Management API.
3. Generate Access Key.

Register your application

To register your service application in Trimble Cloud Console:

1. On the left pane select Identity Management > Applications.

2. On the Applications home page, in the top right corner select + ADD APPLICATION. The Create Application page displays.

3. In the Application Type section, select one of the following options:

   • Service Application A service application are intended to be used in programmatic workflows or server-server communication.
   • Application Refers to any Trimble application that is intended to be accessed by an end user.

4. Select Continue to enter the applications details.

Field	Description
Application Environment	Select the environment that the applications must be registered to, Prod or Pre-Prod.
Name	Version of the API published. The name of your client.
Display Name	Provide a display name of the application.
Description	Provide a description for the application.

5. Continue with completing the Configurations section. The fields that display depend on your selection in step 3.

   • For Service Application

   Service Application Grant types - Only Client Credentials Grant displays.

   • For Application

   Field	Description
   Application Grant Types	Select the grant types that will be used for authenticating users or applications.
   Allowed Callback URLS	Refers to the redirect URI of the application after logging into Identity. More than one UL can be added to this field. The total URI length should not exceed 400kb. This field appears only when you select the Authorization Grant type.
   Allowed Logout URLS	The URIs that Identity can redirect to after log out. More than one UL can be added to this field. The total URI length should not exceed 400kb. This field appears only when you select the Authorization Grant type.

6. Select COMPLETE to save changes.

.

Subscribe service to the API Cloud Management API

To subscribe a service application to the API Cloud Management

1. From the Trimble Cloud Console, on the left pane select Marketplace > Developer Marketplace.
2. Search for and select the API Cloud Management API.

3. To subscribe your application with the API Cloud Management API, select the +ADD SUBSCRIPTION icon.

Generate access key

To generate an access key

1. With the Application key & decret, generate base 64.
2. Use the following cURLcall to generate the access token for your application.

curl --location --request POST 'https://id.trimble.com/oauth/token' \
--header 'Authorization: Basic {base64}' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials'

3. Use the obtained key for invoking Trimble Developer APIs like the Truststore Management APIs.