From Admin Essentials, the user interactions for creating and configuring Integrations occur primarily through the dialog views for Integrations and Integration Models, respectively. Please note that available views, features, and interactions in the UI can be limited based on user permissions.
See related page ➟ Integration Models
Creating Integrations Using Integration Models
To create an integration, click the plus (+) sign in the top-left toolbar of Admin Essentials to open the Create dialog. Alternately, from the Integration Model details view, you can click the + Integration button.
Select the appropriate Integration Model and click the Save button. You will be redirected to another dialog where you select the appropriate Integration Model to create and configure your Integration.
Figure 1: Create Integration
Figure 2: New Integration from Integration Model
Configuring Integration Properties
From the details view, if your integration has properties to edit, they will be displayed here in a form under the Configuration tab. If not, properties can be configured and edited in the Advanced View (if the user has been granted permission through the generic Integrations - updateIntegration method). The Advanced View editor is enabled (displayed) by using the toggle switch in the upper-right corner.
Figure 3: Integration Properties
From the Advanced view, the More button (stacked dots icon) next to the toggle switch can be used to clone or delete an integration if the user has been granted permission. Authorization to clone an integration is set with the Integrations - createIntegration permission method. To delete, the Integrations - deleteIntegration method is used.
Figure 4: Advanced Configuration View
SSL Configuration for Integrations
Itential has created two SSL configuration properties for Integrations: enabled and rejectUnauthorized. These properties are used when making integration requests to a service even if it has an invalid TLS certificate.
Property Schema
"tls":{
"enabled":false,
"rejectUnauthorized":false
}
The schema allows an integration instance to have configurable TLS properties to enable/disable the rejectUnauthorized property. This will allow users to bypass HTTPS TLS certificate checks.
| Property | Type | Default | Description |
|---|---|---|---|
| enabled | Boolean | False | Enables certificate request from endpoint and verify retrieved certificate. |
| rejectUnauthorized | Boolean | False | If true, the request will reject a connection that is not authorized with valid CAs. This option only has an effect if "enabled" is on. |
Integration Logging
Log Levels are controlled by configurations within Admin Essentials. Increasing the size of the log level under the Logging tab will impact all of Itential Platform, not just Integrations.
Moreover, if the Syslog properties are not configured in the Advanced View of the Integration, the user will be unable to change that property in the Logging tab.