Skip to main content
Version: 2.7 (Current)

πŸ”— System Integrations

You can manage the configurations and deployment operations of system applications you want to integrate with SecTrail CM from this section. Supported systems:

  • F5 BIG-IP Β· Citrix NetScaler Β· FortiWeb Β· FortiGate Β· FortiManager
  • NGINX / NGINX Plus Β· Palo Alto Networks Β· PaloAlto Panorama
  • Apache Β· IIS Β· Apache Tomcat
  • Windows TrustStore Β· Java Keystore (JKS) Β· Azure Key Vault
  • IBM DataPower Β· HashiCorp Vault
Integration Configurations

You can access general configuration steps for all system integrations from the Integrations β†’ System page.

Devices on Remote Networks

Devices on networks the CM cannot reach directly can be managed by selecting a Distributed Discovery Agent (DDA) in the device definition. See Devices on Remote Networks (DDA) for details.

Devices​

The configurations of system applications you want to integrate are listed on the Automation β†’ Devices page.

Device List

Defined Device List

You can add a new device configuration by clicking the Create button.

Create Device

New Device Configuration Form

Devices on Remote Networks (DDA)​

Devices on a network the CM server cannot reach directly can be managed through a Distributed Discovery Agent (DDA) deployed on that network.

Simply select the relevant agent in the DDA Agent field on the device form:

ValueBehavior
Empty / Not SetThe connection is made directly from the CM server (or the selected Execution Server)
A DDA agentDeploy jobs run from the tunnel-owning host and the connection is routed through the agent's SOCKS5 proxy

In the device's IP field, enter the target device's IP address or hostname within the remote network β€” not an address reachable from CM.

Devices with a DDA agent assigned are marked with a DDA badge next to their name in the Devices list.

Prerequisites
  • The SOCKS5 Proxy option must be enabled in the selected agent's definition; otherwise the connection cannot be routed.
  • The agent's tunnel status must be Connected. Deployments started while the tunnel is down will fail.
  • The connection originates from the agent's network, not from the CM server. Access rules on the target device (firewalls, allow-lists, management-interface restrictions) must permit the agent's IP address.
Related Page

For agent installation, enabling the SOCKS5 proxy, and tunnel management, see the Distributed Discovery Agents (DDA) page.

Deployment Verification and Auto Rollback​

After a certificate deployment completes, SecTrail CM reads the certificate the target device is actually serving and compares its fingerprint against the deployed one. This confirms not only that the deployment finished without errors, but that the device is genuinely serving the new certificate.

The Verify Mismatch β†’ Auto Rollback toggle on the device form determines what happens when the fingerprints do not match:

ValueBehavior
EnableOn a mismatch, the deployment is rolled back automatically; the device keeps running with its previous certificate
DisableNo rollback is performed; the mismatch is flagged in the UI and left for your manual review

The verification result appears in the Status column on the Automation β†’ Process page:

DisplayMeaning
Completed Β· βœ“ VerifiedDeployment completed and the certificate served by the device was verified
Completed · ⏳ PendingDeployment completed, verification has not run yet
Manual-Rollback · ⚠ UnavailableThe live certificate could not be read, so verification could not be performed
Rollback on Failure

This setting applies only to post-deployment verification. If an error occurs at any step of the deployment itself, the system already performs an automatic rollback regardless of this toggle.

Manual Rollback

If you want to roll back a deployment later even though verification succeeded, select the operation on the Automation β†’ Process page and use the Rollback action. For device-specific rollback steps, see the relevant integration page.

Process​

From the Automation β†’ Process section, all operations performed on devices (certificate deployment, etc.) can be viewed in detail. The Status column shows the post-deployment verification state alongside the operation's result β€” see Deployment Verification and Auto Rollback.

Device Process

Process History - All Device Operations

Device Users​

From the Automation β†’ Device Users section, you can create user definitions to be used in device connections.

Device Users List

Device Users List

Create Device User

Create New Device User

Service Deployment​

From the Automation β†’ Deployments β†’ Service Deployments page, you can initiate an instant certificate deployment to selected devices.

Service Deployment

Instant Service Certificate Deployment

TrustStore Deployment​

From the Automation β†’ Deployments β†’ TrustStore Deployments page, you can initiate an instant TrustStore deployment to selected devices.

TrustStore Deployment

Instant TrustStore Deployment