Enable Trimble Compass for your setup

Before you can use Trimble Compass, you must have a Trimble ID with Compass access.

Get a Trimble ID

There are three parts to a Trimble ID (TID):

  • The Key ID

  • The Key Secret

  • The Account Name

Your Project Manager gets the Key ID and Key Secret values from TMT Support and provides it to your Technical Services. TMT Fleet Maintenance completes the Account Name field for you once you enter the Key ID and Key Secret values.

If you are requesting a TID for the first time, make sure the Trimble Support representative knows that you want to enable Compass for TMT Fleet Maintenance. Your TID Account Name must have permission to access the Atlas service for Compass to work. Contact Trimble TMT Support by sending an email to [email protected].

TID is part of the Trimble Trust Center. For more information, see Trimble Trust Center User Guide.

Complete the Trimble ID Integration Options

This section will review the key points about setting up your TID Integration Option for Compass. For detailed information on setting up the TID integration option, see Integration options: Trimble ID.

  1. In TMT, open the Trimble ID node in Integration Options (Menu > Setup > Options > Integration Options > Trimble ID > Basic).

  2. Set Enabled to YES.

  3. Complete these fields:

    Required field: *
    Read-only field: §

    Field Definition

    Key ID *

    Enter the value given to you by your Project Manager or Trimble Support representative.

    Key Secret *

    Enter the value given to you by your Project Manager or Trimble Support representative.

    Account Name §

    The program generates the Account Name for you once you complete the other fields and select Save.

    Remember, your Account Name must have permission to access the Atlas service. Only a Trimble Support representative can set this up.

    Configuration Service URL *

    Enter one of these values. They are the same for all customers:

    Trimble Identity URL *

    Enter https://id.trimble-transportation.com/oauth2/

    Authentication Type *

    This value is the same for all customers: client_credentials

    AMS Server API URL *

    Enter the AMS Server API URL.

    If you do not know your AMS Server API URL, you can find it using these steps:

    1. Open TMT Fleet Maintenance.

    2. From your User menu, select Debug Information. The Debug Information page opens.

    3. Select the Application Settings tab. The tab shows the AppSettings table.

    4. Scroll down until you see the AMSServerApi entry.

    5. Copy the entry for use on the TID Integration Options page.

    Connected Maintenance URL §

    This read-only field is auto-populated by default.

    TMT Repair Request URL *

    Important: Other integrations also make use of this field. If a value already exists in this field, do not change it.

    For TID, the value is the same for all customers:

    TTC Base URL *

    Enter https://cloud.api.trimble.com/transportation/

    TTC Role Endpoint *

    Enter api/v1/roles

    This is the URL endpoint the program uses to call the role-related API from Trimble Trust Center.

    TTC User Invite Endpoint *

    Enter iam/v2/user-invites

    This is the URL endpoint the program uses to call the user-invitation API from Trimble Trust Center.

    TTC Account Endpoint *

    Enter api/core/v2/accounts

    This is the URL endpoint the program uses to call the account-related API from Trimble Trust Center.

    TTC Default Role Id *

    Enter 628e35d3a7d4ab567c5c801f

    This is the default role ID of the role the program will assign to every invited user.

  4. Select Save.