Get started
Color

Connections on the Mac

One card per outside service, its account details, a Test button and the last test result.

For
OwnerDispatcherAdministrator
Hosting
Any hosting
Devices
Mac
Business
All businesses

Checked against Pop Dispatch 0.1.0

Connections holds one card for each outside service the server can switch on with the business's own account.

Before you start #

Sign in as a user who may set up the services. Owners and managers change the account details.

Steps #

  1. Choose Connections in the sidebar.
  2. Find the card for the service. Each card says what the service does and whether it is on.
  3. Type the values your account gives you. A secret shows only as Saved after it is stored.
  4. Choose Save.
  5. Choose Turn on.
  6. Choose Test. The result appears under the buttons, with the time of the last test.

An account detail is stored sealed on the server and stays hidden after it is saved.

Technical details

The list is GET /settings/connections. A change is PATCH /settings/connections/:id with fields and enabled. A test is POST /settings/connections/:id/test. A secret is sealed under the install master key and the API answers only whether one is set.

If something goes wrong #

  • Test fails: read the message. It names the value the service refused.
  • Turn on is gray: fill the required fields first.
  • The card shows no fields: the service uses the mail settings in Settings, Mail.