# Plan for Workspace ONE integration
Whether your Workspace ONE configuration includes the Adaptiva Server and AirWatch Cloud Connector (ACC) installed on the same server, two separate servers, or each component completely isolated, Adaptiva OneSite provides integration options at installation. Workspace ONE uses the ACC to contact the Adaptiva Server.
Adaptiva recommends installing the Adaptiva Server and ACC on the same server. The SQL Server is also installed on this server. This ensures platform performance and security as there is no outside network access to the Adaptiva Server with all components installed on one server.
## AirWatch Cloud Connector
Workspace ONE uses the ACC as a proxy to securely contact the Adaptiva Server by calling the Adaptiva APIs. The ACC must be installed before installing the Adaptiva Server. Install the correct version of the ACC. For more information, see [Enable AirWatch Cloud Connector from the Workspace ONE console (Omnissa)](https://docs.omnissa.com/bundle/AirWatchCloudConnectorVSaaS/page/EnableAirWatchCloudConnectorfromtheWorkspaceONEUEMconsole.html).
## ACC Account and Permissions
Grant Adaptiva the ACC permissions to integrate the Adaptiva Server with Workforce ONE during the server installation.
| Permissions | Account | Permission |
| ----------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ACC | AirWatch Service Account | Local Administrators group
Minimum permissions:
Registry Full Control access to the following paths:
- HKLM\Software\Adaptiva
- HKLM\Software\Microsoft\SystemCertificates
File System Read access for the following Adaptiva DLLs file path:
- C:\Program Files\Adaptiva
|
## ACC Integration Options
Based on the security requirements for your site configuration, decide which of the integration options below works best for your organization. In all cases, Workspace ONE requires the ACC installed on a server to communicate with the Adaptiva Server.
* Adaptiva Server, the ACC, and the Adaptiva Server on the same server.
* Adaptiva Server is separate from the ACC.
* Adaptiva Server, the ACC, and the SQL Server are each on separate servers.
### Adaptiva Server and the ACC on the same server
In this example, integrating the ACC and the Adaptiva Server on the same server is the simplest configuration and eliminates any network communications between the components.
### Adaptiva Server separate from the ACC
In this example, the Adaptiva Server and the ACC are installed on different servers. This configuration is often with SQL Server Express installed with Adaptiva.
### Adaptiva Server, the ACC, and the SQL Server each on separate servers
In this example, the `AdaptivaServerSetup.exe`, SQL Server, and ACC are completely separated, with each component installed on a different server. This enables the database administration team to maintain all databases on managed servers. This also provides for the use of Always On Availability Groups to cluster the SQL servers.
## Setting up the ACC
Enable the ACC in the Workspace ONE console, and then download the VSEC certificate to a designated installation path.
### Install the ACC
1. If the ACC is already installed, navigate to the following file path to open the log file **CloudConnect.log**:
`%InstallPath%\Airwatch\Logs\CloudConnector`
2. Search for **Starting CloudConnector**. The ACC must be version **19.7.0.0** or later.
3. If the ACC is not installed or if the ACC version is older than 19.7.0.0, open the Workspace ONE UEM console and navigate to **Groups & Settings | All Settings | System | Enterprise Integration | Cloud Connector**.
4. Select **Download AirWatch Cloud Connector Installer**.
5. Select **Open File** after the download has completed to start the installation.
6. In the UEM console, select **Test Connection** to verify if the ACC is active.
### Download the vSEC Certificate
1. Open the Workspace ONE UEM console, and navigate to **Groups & Settings | All Settings | System | Enterprise Integration | Peer Distribution | Adaptiva**.
2. Select the **Download vSEC Certificate** link to download the certificate to a location on your computer. This will be used later.
### Adaptiva Certificate for Workspace ONE Installation
After the Adaptiva Server setup is complete, you must return to the Workspace ONE UEM console to upload the Certificate on the **Adaptiva Peer Distribution Software Setup** page. Adaptiva automatically generates the `AdaptivaServer.cer` file and downloads it to a location on your computer during the Adaptiva Server installation.
### Adaptiva APIs
The ACC communicates with the Adaptiva Server by calling the **Adaptiva APIs**. The ACC requires access to the Adaptiva DLLs to call the Adaptiva APIs. The `.dlls` act as a shared library of content that allows multiple components simultaneous access. Adaptiva recommends installing the `.dlls` on the server hosting the ACC.
#### Install the DLLs
1. Locate the Adaptiva installation files from downloaded `.zip` file.
2. Copy the file `AdaptivaWorkspaceONEACCInstaller.exe` from Installers or Windows to the ACC.
3. Right-click on the `AdaptivaWorkspaceONEACCInstaller.exe`, select **Run as an administrator**, and then select **Yes** (if prompted).
4. This opens the **Installs Adaptiva DLLs To The Workspace ONE AirWatch Cloud Connector (ACC)** dialog. The current installation status appears on the dialog.
5. Select **Install**, and then select **Yes** on the **Are You Sure You Wish To Install Adaptiva DLLs?** dialog.
6. Select **OK** on the **Installation Was Successful** dialog.
You are now ready to install the Adaptiva Server and integrate it with Workspace ONE.
#### Record the Location Details
* Record either the FQDN or the internal IP address of the Adaptiva Server.
* Record the location of the downloaded vSec certificate.
* Record the location of the Adaptiva Server certificate, which defaults to the following path:
`\Adaptiva\Adaptiva Server\data\security`
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.adaptiva.com/platform-install/planning-guides/workspace-one-planning.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.