Overview

Puppet Enterprise is an infrastructure automation platform that helps organizations manage and enforce consistent configurations across their device environments. It enables teams to define system configurations as code, ensuring consistency, security, and compliance across on-prem, cloud, and hybrid environments.

Available Integrations

Product(s)	Supported Asset Type(s)	Integration Type
Puppet Enterprise	Devices	Source

Why You Should Integrate

Integrating with Puppet Enterprise will provide visibility into your devices being managed by Puppet Enterprise.

How Does the Integration Work

This integration works by pulling device asset information from Puppet Enterprise using its REST API.

This data is only used internally; we do not share it with any parties outside of Sevco. Refer to our privacy policy for details.

⚠️
Please review the configuration instructions in the section below before setting up permissions for apps.

Configuration

Install a runner: Follow our instructions to install a runner.
Configure the Access Schema

Field	Description	Example
`DNS`*	The DNS address associated with your instance of PuppetDB	`puppet.company.local`
`Port`*	The network port used by your instance of PuppetDB	`8143`
`Auth Token`*	The personal access token generated in your PuppetDB console	`***********************`

Add an Integration: Select the integration(s) you'd like to add.
- Collect devices
Configure General Information: OPTIONAL: You can use the following fields to provide additional information about your configuration.

Field	Description	Example
`Name (optional)`	Uniquely identifiable attribute of the configuration to delineate other similar configurations with the existing organization.	`DMZ network`
`Contact Person (optional)`	A placeholder to input a name or email address of a contact associated with the integration.	`Jane Doe`
`Link to Console (optional)`	A placeholder to input a link to the console of the product Sevco is integrating with for quick reference and access when configuring or editing the integration.	`www.product.com/devices`
`Email me about frequent errors`	Select this toggle to receive an email whenever an Integration has a ≥30% error rate in a 24-hour period.	n/a

Activate Config: Select "Activate" to enable this configuration and begin pulling data.

External Documentation

Creating credentials

You will be asked to provide credentials that Sevco will use for the integrations. This link will take you through the steps for creating a personal access token to configure the Access Schema.

Required Permissions

The account used must belong to a user who either:

is an Inventory administrator
has List permissions for viewing node Inventory information

Learn more

API Documentation

Inventory endpoint

Contact Us

If you're having problems configuring an Integration, or if you've found something wrong in this document, please email us at [email protected] or suggest edits directly by selecting the Suggest Edits link located in the upper right hand corner of the documentation.