Integrations
Copy link to the page “Integrations”Find the integration that installs the certificate on your server or service. All integrations with search and categories are on sslbrain.com/en/integrations.
What you need
Copy link to the section “What you need”- The service name, such as IIS or Exchange.
- An administrator login for the appliance if you need to approve a version.
Find the integration
Copy link to the section “Find the integration”- Find the service on the integrations page. The card opens its own integration page with setup, ports and access.
- Open Appliance › Integrations › Installed in the appliance and find the integration’s version.
- If the integration is missing, open Appliance › Integrations › Catalogue, find the signed version and click Approve.
Check that it works
Copy link to the section “Check that it works”Under Appliance › Integrations › Catalogue, the version shows Verified and Runs …. Select the service in the installation plan.
If it fails
Copy link to the section “If it fails”- Invalid or Unsigned → do not approve the version. Contact FairSSL with the integration name and version.
- The service is missing from the catalogue → see Platforms outside the catalogue.
- The certificate is found but never installed → see Integrations that only find certificates.
Where the integration runs
Copy link to the section “Where the integration runs”| Server or service | Execution |
|---|---|
| Windows and Linux with a service agent | Locally via service agent. It fetches the task at its next check-in |
| Cloud services, firewalls, load balancers, storage and vCenter | Push installation via API using access from Servers › Credentials |
| pfSense and VMware ESXi without a service agent | Push installation over SSH |
| Fortinet FortiMail | Push installation to FortiMail’s command line over SSH |
Discovery finds the services and their integrations. FairSSL signs the integrations, and the appliance and service agent check the signature before execution. See Signing.
See installed versions
Copy link to the section “See installed versions”Appliance › Integrations › Installed shows integration features and versions. All users can view the page.
Read code and approve a version
Copy link to the section “Read code and approve a version”Appliance › Integrations › Catalogue is for administrators. Preview opens the script, Approve approves a version and Update switches versions. See Your own integrations for scripts you supply.
Keep integrations up to date
Copy link to the section “Keep integrations up to date”Under Appliance › Integrations › Automatic, administrators can enable these settings:
- Approve new versions automatically (recommended) uses the latest signed version and also enables downloading.
- Download new versions automatically fetches integration versions and service agent installation files from sslbrain Cloud (EU). You can review them in Catalogue before approval.
If you turn off automatic approval, the versions already running are approved in your name. Other versions wait in Catalogue for an administrator to approve them.
Integrations that only find certificates
Copy link to the section “Integrations that only find certificates”Milestone XProtect and Veeam Backup & Replication find services and certificates without installing them. They are marked Discovery only. Their certificates appear under Certificates › Not automated. The IIS and Exchange cards also include integrations that only find certificates.
Platforms outside the catalogue
Copy link to the section “Platforms outside the catalogue”Use your own integration for your script. See also Servers sslbrain does not know.