Installing a Connector
Walkthrough of the available
CLI Based Local Installation
The connector program is bundled as part of the Border0 CLI (download here). The simplest way to install the connector on a machine is to download the CLI and run the command:
border0 connector install
This command will start the Border0 Connector and run it as service (on linux, this is a systemd service)
To check if the connector is installed and running use:
border0 connector status
The border0 service is currently running. (pid = 56992)
Uninstall
To undo the CLI based local installation, you may simply run
border0 connector uninstall
CLI Based Remote Installation (AWS)
If you'd like to install the Border0 connector into your AWS environment, then this is an easy way to get started.
border0 connector install --aws
Under the hood this command:
- Creates a new connector in your Border0 Organization
- Creates a new connector token for the new connector
- Creates a new AWS SSM parameter to store the new connector token
- Creates a new AWS CloudFormation stack including:
- An IAM Role with all the necessary permissions to fetch the token from SSM and make use of all AWS-based connector plugins and be able to connect to any SSM targets and push SSH public keys to any EC2 Instance Connect targets
- An EC2 AutoScaling Group with a Min/Max of 1
- An EC2 Launch Configuration with user data to start the connector
Uninstall
To undo the cloud installation, you may navigate to the CloudFormation service page on the AWS Console, and delete the CloudFormation stack associated with your deployment.
To wipe all resources you will also need to identity the SSM parameter storing the token and delete it.
Finally, you may also want to delete the connector token and the connector itself from the Border0 Admin Portal.
Updated 14 days ago