ContentsHide

Configure Bring Your Own Ingest Custom Plug-in Instances

For custom ingest plug-ins, you must configure key-value pairs in the Paragon Insights GUI.

To configure a custom ingest plug-in instance:

Select Configuration > Ingest > BYOI Plugins.
The Bring Your Own Ingest Plugin page appears.
Click +New Instance in the Custom tab.
The Create Custom Plugins page appears.
Enter the details as described in Table 1.

Do one of the following:

Save—Save your ingest mapping but do not deploy the updated configuration. You can use this option when, for example, you are making several changes and want to deploy all your updates at the same time later. See Commit or Roll Back Configuration Changes in Paragon Insights for more information.
Save & Deploy—Save the custom plug-in instance configuration and deploy the configuration in Paragon Insights.

Fields marked with an asterisk (*) are mandatory.

Table 1: Fields on the Create Custom Plugins Page
Fields	Description
Name	Enter the name of the custom ingest plug-in instance.
Plugin Name	Enter the name given to the input ingest plug-in that you created.
Service Name	Enter a name for the service. The service name can be same as the name of the custom ingest plug-in.
Key	Name of key parameters in the ingest plug-in. For example, sensor or frequency. You can add one or more ingest parameters as a key using the + icon.
Value	Enter the value for the key parameter. For example, you must enter a sensor path as value if sensor is your key.
Authentication
SASL Username	Enter the plain text username for authentication.
Password	Enter a password. The password must be 6 to 128 characters long and must contain a combination of uppercase and lowercase characters. It must also contain numbers and special characters.
TLS
CA Profile Name	Enter the name of the trusted certificate authority (CA).
Local Certification Profile Name	Enter the name of the self-signed certificate you created for Paragon Insights.
Skip Certification Chain and Host Verification	Toggle the switch on if you want to skip verifying the integrity of the CA certificate. Note: Connection between the input ingest plug-in and the external data source is encrypted even if you skip verification of the certificate.

After you configure a custom plug-in instance, you must create a new rule with the BYOI ingest parameters. To collect data using the custom ingest plug-in, you must add this rule to a new playbook and run a playbook instance on device or network groups. See Use the Sample Rule and Playbook Configurations for BYOI Custom Plug-ins for sample rule and playbook configurations for custom BYOI plugins.

Help us to improve. Rate this article.

Feedback Received. Thank You!

Need more help?

Ask questions in TechWiki

Contact Customer Support

Check documentation in TechLibrary

Rating by you:

Configure Bring Your Own Ingest Custom Plug-in Instances

Help us to improve. Rate this article.

Related Documentation