You can access your HCP Boundary instance through the Boundary web UI using a browser or Command Line Interface (CLI) using the installed Boundary binary.
Before you can use the Boundary CLI, you must complete the initial setup using the Boundary web UI. In this tutorial series you will use the Manual setup wizard to have a better understanding of how Boundary is organized.
- An HCP account to complete this tutorial.
- Boundary 0.11.0 installed.
From the HCP Portal's Boundary page, click Open Admin UI - a new page will open.
Enter the admin username and password you created when you deployed the new instance and click Authenticate.
You are now logged into your HCP Boundary instance via the web UI and presented with the Boundary setup wizard.
Select the Manual radio button and click Next.
In the Name field enter
quick-start-organd click Save.
You are now authenticated to your HCP Boundary instance's Global scope via the web UI. This is the default scope for all new Boundary clusters.
The Org Settings page includes the Name of the org, an optional Description, and the org ID (highlighted).
ID's are an important concept to understand in Boundary. Each resource in Boundary is identified by an ID. ID's are commonly referenced when managing your Boundary instance, or connecting to Boundary resources. These additional resources will be covered throughout the Getting Started series.
From the Boundary web UI, click the org menu and select quick-start-org.
Click Org Settings.
Copy the org ID by clicking the copy icon.
Switch to your terminal and export a environment variable for the org ID.
$ export ORG_ID=<actual-org-id>
Click Orgs in the left navigation menu to return to the global scope.
Note: You can verify the active org in the Boundary UI by the org pull down menu.
Click Auth Methods and copy the Password auth method ID.
Open your terminal and set an environment variable named
BOUNDARY_AUTH_METHOD_IDto the copied ID.
$ export BOUNDARY_AUTH_METHOD_ID=<actual-auth-id>
Close the Boundary web UI.
Return to the HCP Portal Boundary page and click the copy icon for the Cluster URL in the Getting started with Boundary section.
In your terminal, set the
BOUNDARY_ADDRenvironment variable to the copied URL.
$ export BOUNDARY_ADDR=<actual-boundary-address>
Log in with the administrator credentials you created when you deployed the HCP Boundary instance. Enter the password you selected when creating your Boundary instance at the
Please enter the password (it will be hidden):prompt.
$ boundary authenticate password \ -auth-method-id=$BOUNDARY_AUTH_METHOD_ID \ -login-name=$BOUNDARY_ADMIN
Authentication information: Account ID: acctpw_TBnUEBekWg Auth Method ID: ampw_eDXtKF7g5x Expiration Time: Mon, 09 May 2022 15:13:31 EDT User ID: u_B7cPickLel
You are now logged into your HCP Boundary instance's Global scope via the CLI. This is the default scope for all new Boundary clusters.
Now that you have authenticated to the HCP Boundary instance, you will setup and connect to your first target.