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