Intel® Trust Authority tenant CLI

The Intel Trust Authority Command-Line Interface (CLI) is a set of commands used by tenants to create and manage Intel Trust Authority resources with a focus on ease of use. The Intel Trust Authority CLI must be installed and configured for your environment.

The Intel Trust Authority CLI is an open-source tool available on GitHub.

Intel Trust Authority CLI commands

The Intel Trust Authority CLI contains the following command groups.

• User Management — Used to manage Intel Trust Authority users and administrators.
• Service Management — Used to manage Intel Trust Authority services.
• API client management — Used to manage attestation APIs.
• Policy Management — Used to create and update Intel Trust Authority policies.

How to use command line options

The Intel Trust Authority CLI uses the following format:

CLI: trustauthorityctl < command > < resource >

Note

If you're using a network proxy service, you must add the Intel Trust Authority FQDN to NO_PROXY environment variable.

Retrieve an attestation API key

All the attestation-related APIs, CLI commands, and client libraries require an attestation API key for authorization. For more information, see Attestation API keys. These instructions explain how to retrieve an attestation API key.

Note

These instructions assume that your API key has already been created. If you need to create an API Key, follow the Creating API keys steps.

1. Sign in to the Intel Trust Authority portal.

2. Go to the Manage services page.

   

3. Scroll down to the Attestation API Keys section.

4. Locate the API from which you want to retrieve the key.

   Note

   You can have more than one API key associated with your account. Be sure to select the appropriate API key for the CLI request you are attempting.

5. Select the View icon.

6. Select the Copy icon.

Retrieve Admin API keys

All the tenant management-related APIs, CLI commands, and client library methods require an Admin API key for authorization. Admin API keys can only be retrieved through the Intel Trust Authority web portal. For more information, see Tenant admin API keys.

1. Sign in to the Intel Trust Authority portal.

2. Select Admin API keys.

   

3. Select the View icon for API key you want to copy.

   The API key is displayed.

4. Select the copy icon.

   The API key is copied to your system memory.

5. The API key can be used with the Tenant CLI to manage admins and users.