Subsections of End User Documentation

Acreto Connect Client

About Acreto Connect Client

Acreto Connect Client is a simple application that allows to connect your device to Acreto Ecosystem. It is available on Windows, macOS, Android and iOS.

This client application securely connects and protects remote users, developers, and 3rd party vendors with the Acreto cloud platform. A lightweight client that enables remote users to securely work from anywhere. The client application, when utilized with the Acreto platform, enables both encryption and in-line security to ensure that malicious files and attacks are prevented and removed.

Tip

Do not use any other VPN Clients when ACC is connected

Please avoid using any other VPN clients when the Acreto Connect Client (ACC) is connected. Running multiple VPN clients simultaneously can cause network conflicts, connectivity issues, and may compromise security. To ensure optimal performance and a secure connection, disconnect any other VPN services before connecting with ACC.

Table of Contents

Subsections of Acreto Connect Client

Import Profile and Establish Connection

Getting started

The first step after installation is the profile import. The profile contains information about the Ecosystem you can connect to.

You may use one of three methods to import the profile:

  1. Import Profile from code
  2. Import Profile from URL
  3. Import Profile from file

After your profile is imported make sure that you established the connection

Import Profile from code

  1. Under the Code option, enter the 6 digit code provided by your system administrator and then click on the button Submit:

import_profile_code import_profile_code

  1. If the profile requires Username and Password to connect, please enter them followed by a click on button Import:

import_profile_credentials import_profile_credentials

  1. All set. The imported profile should be available under the Profiles list.

Import Profile from URL

  1. Select the option URL under the available import options:

import_profile_url import_profile_url

  1. Under the URL field and enter the profile URL provided by your system administrator:

import_profile_url_field import_profile_url_field

  1. If the profile requires Username and Password to connect, please enter them followed by a click on button Import:

import_profile_credentials import_profile_credentials

  1. All set. The imported profile should be available under the Profiles list.

Import Profile from file

  1. Select the option File under the available import options:

import_profile_file import_profile_file

  1. Pick the VPN Profile file provided by your system administrator.

  2. If the profile requires Username and Password to connect, please enter them followed by a click on button Import:

import_profile_credentials import_profile_credentials

  1. All set. The imported profile should be available under the Profiles list.

Establishing connection

To establish the connection with the intended Acreto server, just toggle the connection switch to the On position:

connect_profile connect_profile

Once the connection starts, the switch should be displayed in blue, like in the image below:

connect_profile connect_profile

To disconnect from that VPN connection just toggle the switch back and wait until its color becomes grey again.

Tip

Do not use any other VPN Clients when ACC is connected

Please avoid using any other VPN clients when the Acreto Connect Client (ACC) is connected. Running multiple VPN clients simultaneously can cause network conflicts, connectivity issues, and may compromise security. To ensure optimal performance and a secure connection, disconnect any other VPN services before connecting with ACC.

Supported Operating Systems

Introduction

Acreto is focused on security. One crucial part of infrastructure security is up-to-date software. That’s why our Acreto Connect Client does not support installation on outdated operating systems.

Supported Operating Systems

You can install and use Acreto Connect Client on any popular and up-to-date operating system.

Windows:

  1. Windows 10 - minimum version 21H2 - build 19044
  2. Windows 11 - minimum version 21H2 - build 22000
  3. Windows Server - minimum 2016 LTSC - build 14393

macOS:

  1. macOS - minium version 14 (Sonoma)

iOS

  1. iOS - minimum version 15

Android

  1. Android - minimum version 12 (Snow Cone)

We strongly suggest that users of Acreto Connect Client update their operating systems to the versions the creators support to ensure maximum security, compatibility, and performance.

What if my Device does not meet Minimal Requirements?

If your operating system is older than the one on the list, we strongly suggest updating it or changing your device.

Acreto can’t ensure proper support for those devices. This means we cannot guarantee that the software will work properly and allow you to connect securely to the Ecosystem.

Edit or Delete Profile

Getting started

If you need to edit details of your connection or completely remove one of the existing profiles use procedures described below.

Editing VPN profile

  1. To Edit a Profile, navigate to the Profile Details:

profile_details_button profile_details_button

  1. Then click on the Edit button located on the top right corner:

profile_edit_button profile_edit_button

  1. Edit the Profile details and then save the changes by clicking the Save button:

profile_edit profile_edit

Deleting VPN profile

To delete a profile, navigate to the Edit Screen as shown in the steps of the Editing VPN Profile section above and then click the button Delete to completely erase the VPN profile from your system:

profile_delete profile_delete

Troubleshooting

Issue?

If you getting any issues please check is it one of the below list.

Can’t connect to the Ecosystem

Symptoms:

Solution:

Internet connection breaks when connected to Ecosystem

Symptoms:

Solution:

Cant import the profile

Symptoms:

Solution:

Issue descripion

Symptoms:

Solution:

Android Installation

Installation

Please follow the steps below to install Acreto Connect Client:

  1. Go to the download page and click on the Google Play Store image.

  2. Install the Acreto Connect Client application.Install Play Store Install Play Store

  3. Once the application is installed, launch it from your home screen or menu.

  4. All set, now you can start using Acreto Connect Client.

Always-on VPN configuration

Always-on VPN is an Android function that works like an automated service that establishes a connection between the client and the VPN with no user interactions whatsoever. It is a one-time configuration.

How to enable always-on VPN:

  1. Go to device settings
  2. Choose the Connections from the list of options
  3. Swipe up to see More connection settings
  4. Tap on the VPN option
  5. Tap on the Settings icon for Acreto Connect Client.
  6. Turn on the Always-on VPN option
  7. If Andoird will ask for permission grant them.

To test if it works, establish any connection to Acreto Ecosystem and restart your device. After reboot, this connection should be established automatically.

Android will automatically establish a VPN connection to the Acreto ecosystem when needed - for example, after restarting the device. If you have more than one profile in ACC, the most recently used profile will start.

This feature is available for Android 7.0 and above.

Next step

Import profile and connect to the Acreto Ecosystem

MacOS Installation

Installation

Please follow the steps bellow to install Acreto Connect Client:

  1. Go to the download page and download client for MacOS.:

  2. Double click on the downloaded installer file:

launch_installer launch_installer

  1. Click Continue to continue installation:

install_screen1 install_screen1

  1. Select the destination of the installation and then click Continue:

install_screen2 install_screen2

  1. Select the installation type and then click Install:

install_screen3 install_screen3

  1. Once installation is completed, just click button Close:

install_screen3 install_screen3

  1. All set, now you can start using Acreto Connect Client.

get_started get_started

Next step

Import profile and connect to the Acreto Ecosystem

ACC Logs Collecting on macOS

When Should I Collect the Logs?

The main scenario for the Logs Collecting:

  1. Troubleshooting Connectivity Issues: If users report difficulties in establishing or maintaining a VPN connection, logs can provide insights into whether the problem lies with the client, network, or server.
  2. Performance Degradation: When there is a noticeable drop in network performance or speed while using the VPN, collecting logs can help identify bottlenecks or configuration issues causing the slowdown.
  3. Error Analysis: After encountering specific error messages or codes on the VPN client, logs can help decipher the exact nature and cause of these errors.

In essence, a logs collecting should be done whenever there is a need to analyze and understand the behavior of the VPN client and the network, diagnose issues, maintain security standards, and ensure optimal performance.

In most of the cases Acreto Support Engenners may ask you to collect the logs and share the results, before they start to solving your issue.

How to Collect the Logs?  

To collect logs from a macOS device, you need to copy and paste specific files.

  1. Create acc-logs catalog at dektop.
  2. Open Finder and move to /private/var/log/ directory.
  3. Copy the acreto.log to the acc-logs catalog.
  4. Use Finder and move to <user_path>/Library/Application Support/acreto/profiles/ catalog and copy all .log and .conf to the acc-logs catalog.
  5. Move to <user_path>/Library/Application Support/acreto/ and copy the acreto.log file to the acc-logs catalog.
  6. Right-click (or Control-click) on the acc-logs catalog, and from the menu, choose Compress [filename].
  7. Share the compressed file with Acreto Support Engineers.

Netwok Configuration

Network configuration is a crucial part of understanding connection issues on user devices. To share this configuration with Support Engineers, run the below commands in the terminal, replacing the acc-logs path with the full path to the directory:

  1. ifconfig >> acc-logs/ifconfig.txt
  2. netstat -an >> acc-logs/netstat.txt
  3. route -n get default >> acc-logs/route.txt
  4. arp -a >> $acc-logs/arp.txt

Summary

The Logs Collectin gathers all information that may be useful in the issue-solving process. It reduces the time needed to solve the issue at end-user device.

Windows Installation

Windows version of the Acreto Connect Client may be installed by .EXE file (All Windows versions)

Installing from an EXE file

Please follow the steps bellow to install Acreto Connect Client:

  1. Download the installer available here:

  2. Double click the .exe installer:

launch_installer launch_installer

  1. Select the desired installation options and click Next to continue installation:

setup_config setup_config

  1. Confirm the options and click Install to complete the app installation:

confirm_install confirm_install

  1. Once installation is completed, the following screen should be displayed:

install_completed install_completed

  1. All set, now you can start using Acreto Connect Client.
Tip

Do not use any other VPN Clients when ACC is connected

Please avoid using any other VPN clients when the Acreto Connect Client (ACC) is connected. Running multiple VPN clients simultaneously can cause network conflicts, connectivity issues, and may compromise security. To ensure optimal performance and a secure connection, disconnect any other VPN services before connecting with ACC.

Next step

Import profile and connect to the Acreto Ecosystem

Subsections of Users Onboarding Portal

I Got an Invitation - What's Next?

Overview

If you’re reading this article, you probably got an invitation email or link from a security or network officer in your company. At this point, you may like to read this article to learn what Acreto is.

This article will guide you through the onboarding process to Acreto, allowing you to secure your internet connection and provide access to your company infrastructure.

How to Join - Onboarding Procedure

  1. Click on the provided URL or email invitation.
  2. A new page will open in your default browser. You must validate two values:
    1. Company name - on the screen below it’s a TestCompany, you should see the name of your company here.
    2. Ecosystem - on the screen below it’s a Test Ecosystem, you should see the name of your physical location, project or company department here.
  3. Website should recognize the platform/operating system you’re using and propose a proper connection route. If the platform isn’t recognized, you can choose another using the other supported platforms button.

Onboarding steps via various operating systems can be found in the below articles:

  1. Onboard on Android,
  2. Onboard on iOS,
  3. Onboard on MacOS,
  4. Onboard on Windows.

Onboard on Android

Overview

This article will help you connect your Android device to an Acreto Ecosystem.

If you open the Acreto invitation on an Android device, the onboarding page should recognize that you’re using an Android and guide you through the proper onboarding process.

Follow the steps below to secure your internet connection via Android.

How-To

To connect your device:

  1. Click on the Connect your Android button on the invitation page.
  2. The Onboarding Portal allows you to download elements necessary to start using Acreto:
    1. Install our client app from Google Play - this button allows you to download the OpenVPN for the Android app.
    2. Install Profile - this button allows you to download the configuration from the OpenVPN app.
  3. Click on the Google Play link and install OpenVPN for Android - wait until the installation is complete.
  4. Go back to the Web Browser.
  5. Click on the Install Profile button to download the configuration file.
  6. When the download finishes, select the Open option to launch the downloaded file.
  7. OpenVPN for Android should automatically import this file and prompt you to choose a name for a new connection (you can enter a new name or leave as default). Select to accept.
  8. On the Profile list, click on the newly added configuration.
  9. Fill the modal window with the Username/Password that you use within your organization (LDAP or Octa credentials).
  10. Wait until a connection is established and confirm that your connection is secured.
  11. Success, you are now connected to Acreto!

Onboard on iOS

Overview

This article will help you to connect your iOS device to an Acreto Ecosystem.

If you open the Acreto invitation on an iOS device, the onboarding page should recognize that you’re using an iOS device and guide you through the proper onboarding process.

Follow the steps below to secure your internet connection via iOS.

How-To

To connect your device:

  1. Click on the Connect your iOS button on the invitation page.
  2. The Onboarding Portal allows you to download elements necessary to start using Acreto:
    1. Install our client app from App Store - this button allows you to download the OpenVPN Connect app.
    2. Install Profile - this button allows you to download the configuration from the OpenVPN app.
  3. Click on the App Store link and install OpenVPN Connect - wait until the installation is complete.
  4. Go back to the Web Browser.
  5. Click on the Install Profile button to download the configuration file.
  6. When the download finishes, open the downloaded file - click the Open option.
  7. OpenVPN Connect should automatically import the configuration file and prompt you to choose a name for a new connection (you can enter a new name or leave as default). Select to accept.
  8. On the Profile list, click on the newly added configuration.
  9. Fill the modal window with the Username/Password that you use within your organization (LDAP or Octa credentials).
  10. Wait until a connection is established and confirm that your connection is secured.
  11. Success, you are now connected to Acreto!

Onboard on MacOS

Overview

This article will help you to connect your MacOS device to an Acreto Ecosystem.

If you open the Acreto invitation on a macOS device, the onboarding page should recognize that you’re using a macOS device and guide you through the proper onboarding process.

Follow the steps below to secure your internet connection via MacOS.

How-To

To connect your device:

  1. Click on the Connect your macOS button on the invitation page.
  2. The Onboarding Portal allows you to download elements necessary to start using Acreto:
    1. Download Client - this button allows you to download Tunnelblick.
    2. Install Profile - this button allows you to download the configuration from OpenVPN.
  3. Install Tunnelblick - double click on the downloaded installation file and proceed with an installation wizard.
  4. Run Tunnelblick.
  5. Double-click on the Tunnelblick icon in the Tunnelblick disk image Finder window.
  6. On the modal window, select file with the configuration downloaded in step 2.2.
  7. Click connect option.
  8. Fill modal window with Username/Password that you are using in your organization (LDAP or Octa credentials).
  9. Once the installation is complete, you will see a pop-up notification:

Installation succeeded. Tunnelblick was successfully installed. Do you wish to launch Tunnelblick now? (An administrator username and password will be required so Tunnelblick can be secured).

Click Launch

  1. Wait until a connection is established and confirm that your connection is secured.
  2. Success, you are now connected to Acreto!

Onboard on Windows

Overview

This article will help you to connect your Windows device to an Acreto Ecosystem.

If you open the Acreto invitation on a Windows device, the onboarding page should recognize that you’re using a Windows device and guide you through the proper onboarding process.

Follow the steps below to secure your internet connection via Windows.

How-To

To connect your device:

  1. Click on the Connect your Windows button on the invitation page.
  2. The Onboarding Portal allows you to download elements necessary to start using Acreto:
    1. Download Client - this button allows you to download the OpenVPN GUI client.
    2. Install Profile - this button allows you to download the configuration from OpenVPN. Download both of those files.
  3. Install OpenVPN - double click on the downloaded installation file and proceed with an installation wizard.
  4. Run OpenVPN - search for the new icon, it should be visible on the Windows tray.
  5. Right click on this OpenVPN icon and select the Import file… option.
  6. On the modal window, select file with the configuration downloaded in step 2.2.
  7. Right-click the tray icon once again - a new profile should be added. Select this profile and choose Connect from the submenu.
  8. Fill the modal window with the Username/Password that you are using in your organization (LDAP or Octa credentials).
  9. Wait until a connection is established and confirm that your connection is secured.
  10. Success, you are now connected to Acreto!