# Connection Contracts tab
## Create a Connection Contract
To create a Connection contract, follow these steps:
1. Navigate to the **Actors** section and open the Actor.
2. Access the **Connection contracts** tab and click **New**.
3. On the **New Connection contract** page, enter the name of the Connection Contract. This field is **mandatory**. You can enter up to **128 characters**. The name must be unique within the actor.
4. Optionally, provide a description for the Connection Contract. This text helps identify the purpose or usage of the Contract. The field accepts up to **255 characters**.
## Associate a server
To select the server that will be used to access the VFS, follow these steps:
1. Click **SELECT** to open the list of available servers. Once a server is assigned to a Connection contract - and therefore linked to an Actor - it is removed from the **Select server** window. This is because each server can be associated with **only one** Connection Contract.
{% hint style="danger" %}
#### Warning!
When you select a PR4, PR5, or PR5S server, remember that associated Virtual File Systems must be defined as described here: [Virtual File Systems and Spazio 2 protocols PR4 and PR5](/data-mover-1.21/virtual-file-systems/what-is-a-virtual-file-system.md#virtual-file-systems-and-spazio-2-protocols-pr4-and-pr5).
{% endhint %}
2. Click **Confirm** and the selected server will be displayed with the following information:
* **Server** – The name of the selected server.
* **Protocol** – The communication protocol used by the server (e.g., HTTPS, SFTP).
* **Cluster** – The cluster the server belongs to.
* **Port** – The port number used for the connection.
To change the assigned server, click the **edit** icon on the right.
## Associate Users and Groups
When you click **ADD** in the **VFS and Users/Groups** section, the **New User/Group Association** window opens. Here you can define how Users and Groups are granted access to the selected VFS.
### Access through
Choose how access to the VFS will be granted:
* **Direct assignment**: explicitly select the **VFS** and **VFS path** to which access will be granted.
* **Provide VFS access through assigned groups**: access to the VFS is granted **via the Groups** the users belong to.
{% hint style="danger" %}
In both modes, assignments are **autosaved in real time** (no manual save required).
{% endhint %}
#### Data Watcher Source/Destination display
When **Provide VFS access through assigned groups** is selected and **internal users** perform uploads/downloads via Connection Contracts, **Data Watcher** displays, by default, a flow **from/to the Company** in the **Source/Destination** column.
To display the **VFS owner actor** instead of the Company, use the advanced property overrideSourceDestinationWithActor:
* Set overrideSourceDestinationWithActor to true → the **owner of the identified VFS** is shown.
* Not set or set to **false** → a flow **from/to the Company** is shown.
The value of this advanced setting is applied **immediately -** **no restart** of **Data One** or **Data Watcher** is required.
### Virtual File System
This section is displayed **only when** the **Direct assignment** option is selected in the **Access through** field.
Here you define which part of the VFS the Users and Groups will be allowed to access.
* **VFS (\*)**: select the VFS you want to grant access to.
* **VFS path (\*)**: select the specific path within the VFS.
Both fields are **mandatory**.
### Users and Groups
Use the **Users** and **Groups** tabs to specify which external Users and Groups should be granted access to the selected VFS.
#### Users Tab
1. Choose a User from the **Select User** drop‑down menu.
* Type at least **3 characters** to filter the list.
* The search is **case‑sensitive**.
* Wildcards are **not supported**.
* Users must already be created in **Actor > Users**.
2. Click **ADD** to add the User to the association list.
Once added, Users appear in the table at the bottom of the window.
* The list displays **10 users per page**.
* A navigation bar allows you to search and move between pages: **First, Previous, Next, Last**.
* You can run the search even by typing a **single character** (letter or number).
**Upload Limit per User**
For the **FTP, FTPS, SFTP, HTTP, HTTPS, PR4, PR5, and PESIT** protocols, you can configure a custom upload limit for each User.
For each User in the list:
1. Switch **Upload limit** to **ON** to enable the configuration.
2. Enter the **maximum file size**.
3. Select a **unit of measurement**:
* **KB** (default)
* **MB**
* **GB**
* **TB**
{% hint style="info" %}
**Note:** Upload limits defined for Users **override** limits defined for Groups.
{% endhint %}
You can enable or modify upload limits **individually for each User** directly from this table.
To remove a User from the association list, click the **bin icon** on the corresponding row.
#### Groups Tab
The **Groups** tab works in the same way as the Users tab.
Remember that upload limits defined for Users **override** limits defined for Groups.
### Autosave
All changes in this window are **saved automatically in real time**.
No additional confirmation is required.
---
# 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.primeur.com/data-mover-1.21/contracts/create-your-first-contract/create-a-connection-contract/connection-contracts-tab.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.