Create a VMware NSX Advanced Load Balancer (AVI) machine¶
Create a VMware NSX Advanced Load Balancer (AVI) machine so Certificate Manager - SaaS can discover the SSL certificates in the controller's tenants and provision certificates to its virtual services. VMware NSX Advanced Load Balancer was formerly known as Avi Networks. Certificate Manager - SaaS connects to the controller through a VSatellite.
Before you begin¶
- The System Administrator, PKI Administrator, or Resource Owner role. If you have the Resource Owner role, you must own or belong to at least one team.
- An active VSatellite that can reach the controller on port 443.
- The hostname or IP address of the VMware NSX Advanced Load Balancer controller.
- A controller account with administrative permissions in the
admintenant and in every tenant where you want to discover or provision certificates.
To create a VMware NSX Advanced Load Balancer (AVI) machine¶
- Sign in to Certificate Manager - SaaS.
- Click Installations > Machines.
- Click New, and then select VMware NSX Advanced Load Balancer (AVI).
- On the Properties step, in Name, enter a name for the machine.
- For Owning Team, choose the team that owns the machine. System Administrators and PKI Administrators can choose any team. Resource Owners can choose only a team they own or belong to.
-
For VSatellite, choose a VSatellite that can reach the machine. A VSatellite that's the primary of a high availability group shows its number of active replicas, and Certificate Manager - SaaS can run the machine's operations on any healthy VSatellite in the group.
-
In VMware NSX-ALB Address/Hostname, enter the hostname or IP address of the controller.
-
(Optional) In Port, enter the port of the controller if it isn't 443. If you leave it empty, Certificate Manager - SaaS uses 443.
Note
The connector currently connects on port 443 even if you enter a different port.
-
For Credential Type, choose how to provide the credentials:
- Enter Credentials to enter the credentials in the next step. This is the default.
- Select Credentials to use shared credentials from a credential manager integration. Then, for Credential, choose the credential.
Note
Select Credentials requires the credential manager capability, which requires additional licensing. Without it, Credential shows No credentials are available. System Administrators and PKI Administrators can choose any credential. Resource Owners can choose only the credentials that belong to their teams.
-
If you chose Enter Credentials, enter the Username and Password of the controller account. If you chose Select Credentials, the stored account needs the same controller access.
Note
Certificate Manager - SaaS encrypts the credentials you enter and doesn't display them again. On the machine's Properties tab, they appear masked. To keep a stored credential when you edit the machine, leave its masked value unchanged. Keep your own secure record of the credentials in case you need them again.
-
Click Test Access. After the connection succeeds, click Continue. The Discovery step opens.
Note
A successful test confirms that Certificate Manager - SaaS can sign in to the controller in the
admintenant and read the controller version. It doesn't check access to other tenants. Certificate Manager - SaaS doesn't verify the controller's server certificate, but the connection is still encrypted. -
(Optional) In Tenant(s), enter a comma-separated list of the tenants to discover. The default is
Common. If you leave the field empty, discovery searches every tenant. -
(Optional) To skip certificates that have already expired, enable Exclude expired certificates.
-
(Optional) To skip certificates that no virtual service uses, enable Exclude certificates that are not in use by a virtual service.
Discovery finds the controller's system and virtual service SSL certificates, along with their CA certificates.
-
(Optional) To discover certificates on a schedule, enable Schedule. For Repeat every, choose Day, Week, or Month, and then in At, enter the time. For Week, select the days of the week. For Month, enter the days in Day of month. Times are in Coordinated Universal Time (UTC).
- Click Continue. The Provisioning step opens.
-
(Optional) To provision certificates on a schedule, enable Schedule. For Repeat every, choose Day, Week, or Month, and then in At, enter the time. For Week, select the days of the week. For Month, enter the days in Day of month. Times are in Coordinated Universal Time (UTC).
Scheduled provisioning pushes only certificates that are queued for deployment, such as renewed certificates, so renewals install during the window you choose.
-
Click Finish.
What's next?¶
After you create the machine, provision a certificate to it. You can also run discovery on the machine at any time to track the certificates in your tenants.