Storage Providers

Note: Plain WebDAV servers are not supported. The Nextcloud provider needs the Nextcloud sharing API to create download and upload links.

Requirements

• You need the Organisation administrator role to manage storage providers.

• The Upload to storage provider action requires XEOX agent version 2.4.0.90 or newer on the device.

• The storage backend must be reachable from the XEOX servers (for the connection test and file browser) and from your managed devices (for the actual file transfer).

Where to find storage providers

1. Open Administration - Integrations.

2. Click the Storage Providers card.

How to create a storage provider

1. In the storage provider list click Create.

2. Select the Provider type. The type cannot be changed after the provider has been saved.

3. Enter a Name. This name is shown in automations and file pickers.

4. Fill in the Connection fields of the selected type (see the sections below).

5. Click Test connection to verify the configuration. The result is shown directly below the connection fields.

6. Click Save.

Options

• Use as default storage provider - uploads and automations use this provider unless another one is selected explicitly. Only one provider can be the default, and a disabled provider cannot be the default.

• Enabled - disabled providers are kept but no longer offered in automations and file pickers. Automation actions that still reference a disabled provider fail until it is enabled again or a different provider is chosen.

Tip: When editing an existing provider, secret fields (secret key, client secret, app password) are shown empty. Leave them blank to keep the current value.

Amazon S3 / S3 compatible

Prerequisites

1. Create a bucket (or choose an existing one).

2. Create an access key for a user that may access the bucket. The key needs the following permissions on the bucket:
• s3:ListBucket
• s3:GetObject
• s3:PutObject
• s3:DeleteObject

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:ListBucket"],
      "Resource": "arn:aws:s3:::my-bucket"
    },
    {
      "Effect": "Allow",
      "Action": ["s3:GetObject", "s3:PutObject", "s3:DeleteObject"],
      "Resource": "arn:aws:s3:::my-bucket/*"
    }
  ]
}

Connection settings

Good to know

• Download and upload links for S3 are valid for at most 7 days. Longer automation runtimes are capped at this limit.

• A single upload from a device is limited to 5 GB per file.

Troubleshooting

SharePoint / OneDrive (Microsoft Graph)

Prerequisites: create an app registration

1. Sign in to the Azure portal as a global administrator.

2. Open Microsoft Entra ID - App registrations - New registration.

3. Enter a name (e.g. XEOX Storage), keep Accounts in this organizational directory only and click Register.

4. On the overview page note the Application (client) ID and the Directory (tenant) ID.

5. Open Certificates & secrets - New client secret. Choose an expiry and click Add. Copy the secret Value immediately, it is only shown once.

6. Open API permissions - Add a permission - Microsoft Graph - Application permissions.

7. Select Sites.ReadWrite.All and click Add permissions.

8. Click Grant admin consent for <your tenant> and confirm.

Note: Without admin consent the connection test fails with an authorisation error.

Connection settings

Good to know

• A single upload from a device is limited to 60 MB per file.

• Download links are valid for about one hour.

• Client secrets expire. Create a new secret before the old one expires and update the provider, otherwise transfers stop working.

Troubleshooting

Nextcloud

Prerequisites

1. Sharing via link must be allowed on the Nextcloud instance: Administration settings - Sharing - Allow users to share via link. For uploads from devices, Allow public uploads must be enabled as well.

2. Create an app password for the Nextcloud user XEOX should use:
1. Log in to Nextcloud as that user.
2. Open Settings - Security.
3. Under Devices & sessions enter a name (e.g. XEOX) and click Create new app password.
4. Copy the generated password.

App passwords also work when two-factor authentication is enabled for the user.

Connection settings

Recommendation: Set a Folder. Nextcloud cannot create upload links for the root folder of a user, so uploads from devices only work into a folder. If no folder is configured, a folder has to be picked in the upload action.

Good to know

• Share links created by XEOX expire automatically. If your Nextcloud administrator enforces a maximum link lifetime, XEOX uses that limit.

• The maximum upload size is limited by the free quota of the Nextcloud user.

• Only real Nextcloud instances are supported. A plain WebDAV server is rejected by the connection test.

Troubleshooting

Browsing files

Using storage providers in automations

• Download from storage provider - downloads a file from the provider onto the target device. Pick the provider, choose the file in the file browser and optionally set a destination directory. Without a destination the file is downloaded to the task's working directory.

• Upload to storage provider - uploads a file from the target device into a folder of the provider. Enter the full path of the file on the device (e.g. C:\logs\report.zip), pick the provider and the destination folder, and optionally a new file name.

Managing storage providers

• Edit - click the provider name in the list. The provider type cannot be changed; create a new provider instead.

• Disable - untick Enabled on the provider page. The provider is kept but no longer offered in automations and file pickers.

• Delete - choose Delete from the row menu. Files that were stored through the provider are not deleted in the backend, but they are no longer accessible from XEOX.