Register Sidecar
Notice
Prerequisites:
Hostname is established that can be used to access a sidecar instance
RSA key pair has been generated for sidecar authentication
Registering a sidecar in ALTR provides the necessary information for the sidecar to securely connect with ALTR and retrieve policy and configuration information. Communication is always initiated by the sidecar; ALTR never reaches into your environment.
To register a sidecar and sidecar port to ALTR:
Log into ALTR via Okta.
Select → in the Navigation menu.
Click Register Sidecar.
Enter a Display Name. This is a user-friendly name to identify your sidecar.
Enter Host Location of the sidecar in RFC 1123 specification, which is a URL without
http://. This is the DSN name of the network load balancer.Enter Public Key of the sidecar. This is the public key from your RSA private-public key pair.
Note
The Public Key must begin with
-----BEGIN RSA PUBLIC KEY-----and end with-----END PUBLIC KEY-----. For example:-----BEGIN PUBLIC KEY----- ab59a....sja8 -----END PUBLIC KEY-----
Click Register.
Note
In addition to the public key registered, a second public key field displays. This is used to rotate keys. Learn more.
After registering a sidecar in ALTR, use the returned Sidecar ID, Data Plane URL and ALTR Organization ID to deploy the sidecar in your environment.
Once a sidecar is registered, ALTR displays information for all instances of that sidecar that have connected to ALTR. A single configured sidecar can have multiple deployed instances.
Removing a sidecar from ALTR prevents repository users from accessing data repositories using this sidecar. You must remove relevant sidecar ports before removing a sidecar.
To remove a sidecar from ALTR:
Log into ALTR via Okta.
Select → in the Navigation menu.
Click the sidecar to view details.
Click Remove Sidecar; a modal displays to confirm.
Click Remove Sidecar.