Download 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.

Download

To download Acreto Connect Client go to product page: https://acc.acreto.io

See also

• List of other connectivity options
• Administrator Guide

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:

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

3. 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:

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

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

4. 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:

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

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

4. 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:

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

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

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:

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

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

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:

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.

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

iOS Installation

Installation

Please follow the steps bellow to install Acreto Connect Client:

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

2. Tap on the GET button to install the app

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

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:

1. Click Continue to continue installation:

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

1. Select the installation type and then click Install:

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

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

Next step

Import profile and connect to the Acreto Ecosystem

ACC Logs Collector

Designed to streamline troubleshooting for Acreto Connect Client VPN issues, the Logs Collector gathers comprehensive log data, aiding Acreto Support Engineers in diagnosing and resolving issues effectively.

When Should I Use the Logs Collector?

The main scenario for the Logs Collector:

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 collector should be used 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 use this tool and share the results, before they start to solving your issue.

How to Use Logs Collector?

Windows Logs Collector

Logs Collector for Windows is a PowerShell script that the User needs to run on the device where the issue occurs. Follow the below procedure:

1. Download the Logs Collector Script and save it in Download folder.

2. Run the PowerShell tool with Admin Priveledges:

   1. In the system search bar, type PowerShell
   2. Find the PowerShell on the list
   3. From the options, choose Run as Administrator

   

3. Go to the Download where you saved the Logs Collector - paste the below code in the PowerShell terminal

   cd ~\Downloads

   then hit Enter.

4. Paste the below code in the terminal to temporarily change the Execution Policy.

   Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope LocalMachine

   Confirm the change in the terminal prompt.

5. Run the Logs Collector Script:

   .\acc-logs-collector.ps1

   

   Press Enter, and confirm that you want to run this script.

6. Now, the script collects all logs and helpful information for the issue-solving process. From the script output, you can get where the .zip archive with all logs is stored:

   

7. This directory should now contain an archive with all the logs.

   

8. Restore the old Execution Policy by pasting this code into the PowerShell terminal

   Set-ExecutionPolicy -ExecutionPolicy Restricted -Scope LocalMachine

9. Share this archive with the support engineers

Summary

The Logs Collector tool gathers all information that may be useful in the issue-solving process. It reduces the time needed to collect information from the 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:

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

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

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

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

Next step

Import profile and connect to the Acreto Ecosystem

Tap Adapter Issue

If you are a Windows 11 user, and you can’t connect using Acreto Connect Client you may experience a connection problem similar to one video below.

If you check the logs, you may find the logs with this information:

All tap-windows6 adapters on this system are currently in use or disabled

Cause of a problem

In one of the last updates, Microsoft changed the way of driver verification—all drivers signed in the old way may stop working or start misbehaving.

One of the affected drivers is a TUN/TAP interface driver used by Acreto Connect Client.

Solution

Please follow the steps below to solve the issue:

1. Click Start (or hit the Windows key) to open the Start Menu.
2. In the search dialog box, type ncpa.cpl and press enter.
3. You will see the list of all interfaces available in your system.
4. Seach for any interface with Acreto Connect Client X name (where ‘X’ is a number).
5. Click the right mouse button on this interface and choose Enable from the list of options.
6. Go to Acreto Connect Client and try to establish a connection once again.

Next step

This issue may repeat continuously if using the Acreto Connect Client below version 2.9.7. Please repeat the procedure I’ve described any time an issue happens.

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!