Skip to content

Credentials plugin for Jenekins - use Device42 enterprise password vault

License

Notifications You must be signed in to change notification settings

device42/device42-jenkins-credentials-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

device42-credentials-plugin

This Device42 plugin securely provides credentials that are stored in Device42 to Jenkins jobs.

Installation

From Source

To build the plugin from source, Maven is required. Build it like this:

git clone {repo}
cd device42-jenkins-credentials-plugin
mvn install -DskipTests

From Binaries

As another option, you can use the latest .hpi found under the binaries folder.

Install in Jenkins

When you have the .hpi file, log into Jenkins as an administrator. Then go to Jenkins -> Manage Jenkins -> Manage Plugins -> Advanced. In the Upload Plugin section, browse for the .hpi and upload it to Jenkins:

Upload Plugin

After installing the plugin, restart Jenkins:

Install Plugin

Usage

After installing the plugin and restarting Jenkins, you are ready to start.

Device42 Login Credential

The first step is to store the credential required for Jenkins to connect to Device42. Click the Credentials tab.

Define the credential as a standard "Username with password" credential. In the example below, the credentials are a Device42 host and its API key:

  • Username is admin. The host must already be defined as a host in Device42 policy.
  • Password is the password for that host. (default password: adm!nd42)

Device42 Login Credential

Global Configuration

A global configuration allows any job to use the configuration, unless a folder-level configuration overrides the global configuration. Go to Jenkins -> Manage Jenkins -> Configure System. Scroll to the Device42 Appliance section.

Define the Device42 Account and Appliance URL to use.

Global Configuration

Device42 Secret Definition

The secrets that you want to obtain from Device42 must be defined explicitly. Use the Device42Secret tab to define secrets. Define them as credentials of kind "Device42 Secret Credential".

Device42 Secret Definition

Use Secret in Build Execute Node Configuration

To use Device42 secrets with a Build Execute Node, use Launch method Launch agent agents via SSH. Select the Device42 Secret for the Credentials

Secret bindings on Freestyle Project

Usage from a Jenkins Freestyle Project

To bind to Device42 secrets, use the option "Use secret text(s) or file(s)" in the Build Environment section of a Freestyle project. Click Add and select "Device42 Secret credentials"

Secret bindings on Freestyle Project

Secrets are injected as environment variables to the build steps of the project.

About

Credentials plugin for Jenekins - use Device42 enterprise password vault

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages