Getting Started with LogonBox

ashishkhanal32@gmail.com

Introduction

Welcome to the getting started guide for LogonBox. This guide will help you:

Server Side:

  • Deploy LogonBox VM on VMWare ESXi 6.x 
  • Configure the LogonBox VMCentre
  • Set up LogonBox
  • Set up Active Directory
  • Configure default HTTPS certificate
  • Configure two-factor authentication
  • Set up an SMTP server to send emails
  • Configure messages

User Side:

  • Configure user profile
  • Reset your password

To learn more about LogonBox, see LogonBox Website and What is LogonBox?.

 

Step 1 - Deploy LogonBox VM on VMware ESXi 6.x

This guide helps you Deploy LogonBox VM on VMware ESXi 6.x. To learn how to deploy LogonBox on other hypervisors and platforms, see Installing LogonBox.

Install the LogonBox VM

1. Log in to your VMware ESXi server.

2. Select Virtual Machines from the Navigator menu.

 

 

3. Click Create/Register VM.

4. Select Deploy a Virtual Machine from an OVF or OVA file on the new virtual machine window and click Next.

5. Enter a name for the LogonBox VM.

 

 

6. Click the specified area to upload or drag and drop the OVF and VMDK files. Ensure you have unzipped the downloaded LogonBox zip file.

7. Click Next.

8. Select the storage and click Next.

9. Select the deployment options and click Next

 

 

10. Review the configuration and click Finish.

      Wait for the installation to complete. 

You have successfully deployed the LogonBox VM on VMware ESXi 6.x. 

Note: To learn how to deploy LogonBox on other hypervisors and platforms, see Installing LogonBox.

Step 2 - Configure the LogonBox VMCentre

1. Select the recently installed LogonBox VM. Click Power On if the VM is powered off.

2. Open the LogonBox VM's browser console.

 

 

3. Enter a New Password and confirm it.

4. Select the Keymap and the Language.

5. Click Set.

6. On the Login window, note down the IP address. You will use this IP address to access LogonBox in your web browser.

 

 

7. Enter the recently set password and click Login.

Configure LogonBox Networking

Note: This is an optional step. LogonBox automatically configures an IPv4 address using DHCP. You can use the existing IPv4 address to access LogonBox.

1. Click the Network Configuration icon from the left.

 

 

2. Enter a new DNS Server Address and a new Domain Search.

3. Enter a Hostname.

4. Uncheck the Use DHCP option.

5. Enter the Address, Gateway, Broadcast, and Netmask.

6. Click Save

7. Click Apply to confirm.

8. Reboot the system. LogonBox VMCentre changes the network settings.

9. Enter the IP address in your web browser to access LogonBox. For example, https://192.168.111.89.

You have successfully configured the LogonBox VMCentre.

Step 3 - Set Up LogonBox

1. Once you access LogonBox in your web browser, LogonBox prompts you to the Setup Wizard.

2. Go through the license agreement, accept the terms, and click Next.

3. Enter the Username for the administrative account.

 

 

4. Enter a Password and confirm it.

5. Click Next.

6. On the Configure External Access step, click Next. See the Configuring Proxy Server guide below if you require LogonBox to connect to your product via a proxy server.

7. Enter your registration details - Your Name, the Company Name, and your Email, and click Next.

8. On the Download/Install Components step, Click Next.

9. Select the schemes to which 2-factor authentication will apply. 

 

 

10. Select two or more secondary factor authentication modules for the selected schemes and click Next. You can also change the modules later from the admin homepage. LogonBox provides numerous secondary factor authentication modules (see Step 6 - Configure Two-factor Authentication).

    This guide uses LogonBox Authenticator as one of the authentication modules.

 

 

11. Enter the number of Minimum Factors the users will require to authenticate the selected schemes.

12. Click Next

13. The setup is complete. Click Restart to apply the configuration.

14. Once LogonBox restarts, you land on the account management page. Click Administration to go to the admin login page.

 

15. Enter your Username and Password and click Next.

 

Configure Proxy Server

Note: This is an optional step. If you require LogonBox to connect to your product via a proxy server:

1. On the Configure External Access page, select the I need to configure the proxy settings to allow access to the update server option.