How to Deploy a CloudGen Access User Directory Connector on Bare Metal / Virtual Machine

This article offers the option to either use the install script or use the manual steps listed below. Before you begin, check the prerequisites.

Minimum OS supported versions:

• CentOS 7
• RHEL 8
• Any modern Debian-based OS (Ubuntu)

Install Script

• Download and execute the installation script:

  sudo bash -c "$(curl -fsSL https://url.access.barracuda.com/connector-linux)"

• This script can also be used for unattended installations:

  curl -fsSLo install-connector-linux.sh https://url.access.barracuda.com/connector-linux
  
  chmod +x install-connector-linux.sh
  
  ./install-connector-linux.sh -h
  
  Install CloudGen Access User Directory Connector script
  
  Available parameters:
  
   -e - Extra connector environment variables (can be used multiple times)
  
   -h - Show this help
  
   -l string - Loglevel (debug, info, warning, error, critical), defaults to info.
  
   -n - Don't start services after install
  
   -t token - Specify CloudGen Access Connector enrollment token
  
   -u - Unattended install, skip requesting input <optional>
  
   -z - Skip configuring ntp server <optional>

./ install-connector-linux.sh -u -t "https://xxxxxxxxxxxx" -e "FYDE_AZURE_AUTH_TOKEN=xxxxxxxx" 

1. Install prerequisites.

   sudo yum -y install yum-utils chrony

2. Ensure chrony daemon is enabled on system boot and started.

   sudo systemctl enable chronyd
   sudo systemctl start chronyd

3. Ensure time synchronization is enabled.

   sudo timedatectl set-ntp on

4.   Install yum repository manager and update cURL (necessary in old CentOS 7.0 versions.   
     

   sudo rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7  
   sudo yum -y install yum-utils curl 

   
   

5. Add CloudGen Access repository.

   sudo yum-config-manager -y --add-repo https://downloads.fyde.com/fyde.repo

      

6. Install the CloudGen Access User Directory Connector.
    

   sudo yum -y install fyde-connector  
   sudo systemctl enable fyde-connector 

7. Configure environment using a service unit override (example with Okta). Check all the available parameters. 

   NOTE: Do *not* quote the environment variable values, even if they contain spaces.

   Example:

         Environment='FYDE_LDAP_AUTH_USERNAME=Joe Doe'  – Correct

         Environment='FYDE_LDAP_AUTH_USERNAME="Joe Doe"'  – Incorrect

   sudo mkdir -p /etc/systemd/system/fyde-connector.service.d  
   sudo bash -c "cat > /etc/systemd/system/fyde-connector.service.d/10-environment.conf <<EOF 
   [Service]  
   Environment='FYDE_ENROLLMENT_TOKEN=https://enterprise.fyde.com/connectors/v1/connectorid1? 
   
   auth_token=connector1_token&tenant_id=tenantid1'  
   Environment='FYDE_OKTA_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'  
   Environment='FYDE_OKTA_DOMAINNAME=xxxxxx.okta.com' 
   EOF" 
   
   sudo chmod 600 /etc/systemd/system/fyde-connector.service.d/10-environment.conf 

8. Reload and start the CloudGen Access User Directory Connector.
   

   sudo systemctl --system daemon-reload  
   sudo systemctl start fyde-connector 

sudo yum upgrade fyde-connector 

1. Ensure time synchronization is enabled.

   sudo timedatectl set-ntp on

2. Add CloudGen Access repository.

   REPO_URL="downloads.fyde.com"
   wget -q -O - "https://$REPO_URL/fyde-public-key.asc" | sudo apt-key add -
   sudo bash -c "cat > /etc/apt/sources.list.d/fyde.list <<EOF
   deb https://$REPO_URL/apt stable main
   EOF"
   sudo apt update

3. Install CloudGen Access User Directory Connector:

   sudo apt install fyde-connector 
   sudo systemctl enable fyde-connector 

4. Configure environment using a service unit override (example with Okta). Check all of the available parameters.

   sudo mkdir -p /etc/systemd/system/fyde-connector.service.d 
   sudo bash -c "cat > /etc/systemd/system/fyde-connector.service.d/10-environment.conf <<EOF 
   [Service] 
   Environment='FYDE_ENROLLMENT_TOKEN=https://enterprise.fyde.com/connectors/v1/connectorid1? 
   auth_token=connector1_token&tenant_id=tenantid1' 
   Environment='FYDE_OKTA_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' 
   Environment='FYDE_OKTA_DOMAINNAME=xxxxxx.okta.com' 
   EOF" 
   sudo chmod 600 /etc/systemd/system/fyde-connector.service.d/10-environment.conf 

5. Reload and start Barracuda CloudGen Access User Directory Connector. 

   sudo systemctl --system daemon-reload 
   sudo systemctl start fyde-connector 

sudo journalctl -u fyde-connector -f