Up to five ARN Connect installations can be connected to one WordPress site, for example the host's and a reseller's. Each connection has its own keys, its own name and its own level, and the Agent enforces that level.
Where to find it: the Connections tab of a site in ARN Connect (shown only to the Owner), and Settings → ARN Connect on the site, the Agent's screen in wp-admin.
Levels
| Level | What the connection may do |
|---|---|
| Owner | Everything, including Agent updates and managing the other connections. A site has at most one Owner. |
| Full | Plugin, theme and WordPress updates, rollback copies, plugin activation and deactivation, caches, cron, maintenance mode and its own update lock, but never the Agent plugin itself |
| Full + backups | Full, plus complete backups of the site |
| Monitoring only | Reads health, inventory and diagnostics; changes nothing |
- Only the site's administrator can make a connection the Owner, on Settings → ARN Connect. No remote request can create or raise an Owner.
- Backups mean full control. A backup contains
wp-config.phpand the whole database, including the encrypted keys of every connection. For a Full connection, backup permission is off by default and labelled May download complete backups — gives full control of the site. The Owner can always create backups. - Full is a powerful level. Activating an installed plugin runs its code. Give Full only to installations you trust, and Monitoring only to everyone else.
In ARN Connect, the site header shows the level of your connection, and buttons your level does not allow are hidden.
Connect another installation
From ARN Connect, as the Owner:
- Open the site and go to its Connections tab.
- Click Create connection key.
- Enter a Name (for example the other company's name), choose Full or Monitoring only, and tick May download complete backups only if needed.
- Set Valid for (minutes): 30 to 1440, 60 by default.
- Click Create key and copy the key. It is shown once and never stored.
The other installation adds the site with + Add site and this key. The request is signed with your command key and recorded in the audit log.
From wp-admin: on Settings → ARN Connect, enter a Name, choose the Level, optionally tick the backup permission and click Create connection key. A key created there is valid for 30 minutes.
Manage connections
The Connections tab lists every connection with its name, level, backup permission, application and version, when it was paired, its last contact and who created it, and shows "N of 5 connections, N of 3 waiting keys".
- Change level and Disconnect are available for every connection except your own and an Owner.
- Waiting keys can be cancelled with Revoke.
On Settings → ARN Connect, the site's administrator can also:
- tick Make this the Owner when creating a key, or use Make Owner on a connection; the previous Owner becomes Full without backups;
- allow or remove the backup permission of a connection;
- turn remote changes off for one connection;
- Disconnect one connection or Disconnect all.
A level changed on the site appears in the site's timeline in ARN Connect. A connection removed on the site shows Disconnected on the site with who removed it and when; to connect again, add the site with a new connection key.
When two installations work on one site
Two connections never change a site at the same time. While one runs a change, a backup, an Agent update or a maintenance window, ARN Connect shows that another connection is working on the site. Queued updates, actions and backups wait and are tried again every minute until their authorization expires.
The update lock is shared: each connection keeps its own locked items, and an item stays locked while any connection locks it.
On sites with SiteWatch, each connection must be approved in SiteWatch on its own. See Updates on sites with SiteWatch.
Move to a new computer
The command key is bound to your Windows account, so a new computer needs a new pairing for remote changes:
- Install ARN Connect on the new computer.
- On each site's Settings → ARN Connect, create a new key and tick Make this the Owner, which replaces the old Owner.
- Add the site on the new computer with + Add site.
- Disconnect the old installation on the same screen.
Monitoring data can be moved by copying the data folder while ARN Connect is closed.