Follow this procedure if you are configuring the first Cryptographic Security Platform Vault node in the cluster. If you are adding the node to an existing cluster, see Configuring Additional CSP Vault Nodes in Azure.
Before You Begin
Make sure you have the following information:
The private SSH key file that was used when the instance was created.
Important: The private part of the SSH key file cannot be reset or recovered once the VM is configured, even if you use the Azure "Reset Password" method. Please ensure that you keep it in a safe place.
A virtual network where the Cryptographic Security Platform Vault nodes can communicate via private IP addresses. The nodes can either be launched in the same virtual network, or in virtual networks connected by peering. See your Azure documentation on network security groups or virtual network peering for more information.
Alternatively, you could use the Public IP address associated with the instance if one is assigned.
To find the Public IP address, select All resources from the Azure Resource Manager dashboard, then click on the virtual machine name on which the Cryptographic Security Platform Vault node is running. The public IP address is displayed in the VM details section at the top of the page.
Azure might disconnect ssh sessions if idle for more than 5 minutes. To prevent this, please use the ServerAliveInterval and ServerAliveCountMax opens in the ssh client command line to keep the session active during Cryptographic Security Platform Vault management.
We recommend using ssh CLI options to send a KeepAlive packet with a frequency duration of less than 5 minutes. Please refer to the sshd_config man page for how to use the ServerAliveInterval and ServerAliveCountMax options. For example:
ssh -o ServerAliveInterval=180 -o ServerAliveCountMax=10 user@hostProcedure
To initialize Cryptographic Security Platform Vault for this cluster, do the following:
- Use a web browser to navigate to
https://<Public-IP-addy>, where<Public-IP-addy>is the Public IP address Azure assigned to the Cryptographic Security Platform Vault VM. For security reasons, you must explicitly specifyhttps://in the URL. If prompted, add a security exception for the Cryptographic Security Platform Vault IP address and proceed to the Cryptographic Security Platform Vault Management webGUI.
Cryptographic Security Platform Vault uses its own Root Certificate Authority to create its security certificate, which means that certificate will not be recognized by the browser. For details, see About CSP Vault Certificates.
- On the Entrust Cryptographic Security Platform Vault Management login page, enter
secrootfor the username and enter the VM unique ID (vmId) for the password. - Review the EULA (end user license agreement). When you are done, click I Agree to accept the license terms.
- On the Welcome to Cryptographic Security Platform Vault screen, click Continue as a Standalone Node.
On the Change Password page, enter a new password for the
secrootaccount and click Update Password.On the Configure E-Mail and Mail Server Settings page, specify your email settings.
If you specify an email address, Cryptographic Security Platform Vault sends an email with the Admin Key for the new node. It also sends system alerts to this email address.
To disable alerts, select the Disable e-mail notifications checkbox. You are then prompted to download the Admin Key.
When you are done, click Continue.
On the Download Admin Key page, click the Download button to save the admin key locally. Please keep the admin key in a safe place for later use. When Cryptographic Security Platform Vault prompts for an admin key to recover your Cryptographic Security Platform Vault system, you must provide this admin key to proceed. If you do not have your admin key, you may lose your data.
Note: Whenever the admin key is regenerated, Cryptographic Security Platform Vault forces you to download the admin key.
When you are finished, click Continue.
Cryptographic Security Platform Vault displays the Cryptographic Security Platform Vault Management webGUI. For details about the tasks you can perform from the webGUI, see User guide.
- Use a web browser to navigate to
The secroot password and the htadmin password are the same for the first login, and are by default set to the vmId. You can either change it, or leave it as is. If you change the htadmin password in the System Console, it only changes the password for this particular node, and does not affect the secroot password.
If you do not know the vmId, you can access using one of the following methods:
Access the CLI by clicking the Cloud Shell icon in the Azure GUI, then type the following command:
Azure:~$ az vm show -g <resource-group> -n <name> --query vmIdMake sure that v, m, and d are lower-case and that I is the upper-case i in vmId.
Open the JSON View link from the VM's Essentials information screen and locate the vmId.
What to Do Next
If you want to add another Cryptographic Security Platform Vault node to this cluster, create another Azure resource as described in Deploying a CSP Vault Node in Azure and then configure it as described in Configuring Additional CSP Vault Nodes in Azure.