---
title: "Connection agent for units"
canonical: "https://docs.cuesystem.com/space/TAM/243171329/Connection%20agent%20for%20units"
format: markdown
---
This connection agent is used in CUE Solution Units (panels and touchONE-overview) for working with resource calendars and for sending emails (e.g., with service requests).

For this connection agent, you need a service account to work with resource calendars and on behalf of which the emails are sent. The service account needs full access to resource calendars.

![image](media://e5a82c39-6baf-44f8-a0a1-3975c3b956cb)

API operations are performed on the following servers:

- Microsoft 365 using Microsoft Graph
- Exchange server using EWS (Exchange Web Services)
- Google Workspace using Google Calendar API and Gmail API

For details, expand the procedures for the given server types below:

<details>
<summary>Microsoft 365</summary>

Connection agent for units in Microsoft 365 needs an application registered in Azure AD. The procedure for creating an application is described here: <u>[Registered app creating](https://cue.atlassian.net/wiki/spaces/M3SG/pages/255950885)</u>

Use the procedure **Configuration For units** or **Configuration for Common app**.

> Macro (excerpt-include)

  

> ℹ️ Since there is a limitation in access to Microsoft 365 using Microsoft Graph, one connection agent is suitable for up to 50 touchONE devices that work with the same service account. If you need to use more devices, use a different connection agent that uses either a different service account or a different application registered in Azure AD.

To create a new connection agent, press the <span style="color: #0747a6">***+ NEW***</span> button in the top right corner and then <span style="color: #0747a6">***NEW MICROSOFT 365***</span> in the section **For units**.

![image](media://40bea9df-1f4f-463b-835f-e759d770cd33)

> Macro (excerpt-include)



> Macro (excerpt-include)

  

#### > Macro (excerpt-include)



#### > Macro (excerpt-include)



#### > Macro (excerpt-include)

  

#### Username

Enter here the username of the service account used for units. For Microsoft 365, the username is typically in the email format, e.g. **touchone@contoso.com**.

#### > Macro (excerpt-include)

  

> Macro (excerpt-include)



> Macro (excerpt-include)



> Macro (excerpt-include)

 

> Macro (excerpt-include)
</details>

<details>
<summary>Exchange server</summary>

For Exchange, you need the address of the Exchange server. EWS (Exchange Web Services) is used for communication.

> ℹ️ Since there is a limitation in access to Exchange, using one connection agent is suitable for up to 25 touchONE devices that work with the same service account. This restriction arises because, by default, Exchange Server has a limit on the maximum concurrent access to the account at one time, given by the EWSMaxConcurrency parameter. The EWSMaxConcurrency parameter has a default value of 27. If you need to use more devices, use a different connection agent that uses a different service account. Alternatively, you can increase the EWSMaxConcurrency value for the service account.

To create a new connection agent, press the <span style="color: #0747a6">***+ NEW***</span> button in the top right corner and then <span style="color: #0747a6">***NEW EXCHANGE***</span> in the section **For units**.

![image](media://488166ad-dc55-4117-a82d-1082deb69fb5)

> Macro (excerpt-include)

  

> Macro (excerpt-include)

  

#### Username

Enter here the username of the service account used for units. For the Exchange server, the username is typically in the format **username** or **domain/username**, e.g. **touchone** or **contoso/touchone**. If this is enabled on your Exchange/AD server, it can also be in email format, e.g. **touchone@contoso.com**.

> Macro (excerpt-include)

    

> Macro (excerpt-include)

   

> Macro (excerpt-include)

 

> Macro (excerpt-include)
</details>

<details>
<summary>Google Workspace</summary>

For Google Workspace, you need a project with the appropriate APIs enabled, a certificate for secure communication, and a user account for sending emails. The procedure for creating a project, a certificate, and a user account is described here: [Configuration process](https://cue.atlassian.net/wiki/spaces/GWSG/pages/198672847)

To create a new connection agent, press the <span style="color: #0747a6">***+ NEW***</span> button in the top right corner and then <span style="color: #0747a6">***NEW GOOGLE***</span> in the section **For units**.

![image](media://240c4837-2488-4eab-bbd6-544450cc2e04)

> Macro (excerpt-include)

  

#### Username

Enter here the username of the user account used for sending emails from units. For Google Workspace, the username is typically in the email format, e.g. **touchone@contoso.com**.

> Macro (excerpt-include)

 

> Macro (excerpt-include)

     

> Macro (excerpt-include)
</details>