This task consists of two steps. First, you install Baffle Manager on a virtual machine (VM), then you unlock and configure Baffle Manager.
Before You Begin
It's important that you verify that your site meets the Baffle Prerequisites and Requirements.
Step 1: Install Baffle Manager
This step walks you through the process of installing Baffle Manager on a virtual machine (VM).
To install Baffle Manager, do the following:
- Log in to your VM and install CentOS 7 or 7.5.
IMPORTANT! DO NOT use CentOS 8.1.
- Ensure that the locale is set. If not, use the following commands:
- Copy the latest version of Baffle Manager to your VM.
- Unpack the tar file into the /tmp directory using the following command:
tar xvf BM-DEPLOY-Build-EXAMPLE-BM3Release-<buildnumber>.tar.gz /tmp
- Change your current directory to the installation path:
- Run the following installation script as super user:
- Wait for the install to finish, then access the Baffle Manager with a web browser via HTTPS. Use the public IP address of the instance. For example, https://192.168.1.1 as an address.
TIP: If you are unable to connect to the instance via HTTPS, check your security group inbound rules. Also ensure that your instance has finished initializing.
Because the instance is bootstrapped with a self-signed certificate, you will receive an invalid CA warning. Select the browser option to “proceed”. You will have the opportunity to upload and use your organization’s certificate later in this section. The following dialog should appear, indicating that Baffle Manager is in a locked state.
- Proceed to the next section to unlock and configure Baffle Manager.
Step 2: Unlock and Configure Baffle Manager
This step walks you through the process of unlocking Baffle Manager and configuring the settings for your environment.
To unlock and configure Baffle Manager, do the following:
- Access the virtual machine via SSH. Use “baffle” as the username for the SSH connection, followed by the public IP address, for example: email@example.com. You will also need the key pair file that you selected when you launched the instance.
- After you have connected to the instance via SSH, issue the following command to retrieve the unlock code: sudo more /opt/baffle/baffle-manager/initpass
- In your browser, paste the unlock code into the password field and click CONTINUE.
- Configure System Settings. You will be prompted for hostname and domain settings. All system users must have this domain name as part of this email going forward.
- Configure Email Settings. This allows Baffle Manager to send emails to provide notifications and for password resets. Enter the SMTP server to use as well as the credential to use to authentication to the SMTP server.
- Create Admin Account. The screen below prompts you to create the initial Baffle Manager administrator account. This account is used to configure the subsequent components such as the key management store, data store connections, and Baffle Shields.
- Configure Credential Keystore. This configuration screen establishes an encrypted credential store for any system access credential or access key that the Baffle Manager or Baffle Shield utilize. The default name is “baffle_credential_store” and cannot be changed.
Select LOCAL for Keystore type. For Secret Key, enter any random string which will be used to generate a random key to encrypt the Keystore Config Password. For Config Password, enter a secure password or passphrase to secure the actual keystore.
- Install SSL Certificate. This configuration step allows you to install an SSL certificate to secure access to the Baffle Manager web interface. Upload the certificate and key file for your organization or respective CA to enable SSL for the Baffle Manager console.
- This should complete the initial setup process and bring you to the login page.
- Enter the credentials for the administrator account you created in Step 9 to login and continue the configuration process.
- Continue with Connect to a Keystore.