keychain-passwd-maven-plugin

This plugin retrieves the password from OSX keychain and sets it as a Maven Project property - which can be used by other plugins.

License	The MIT License (MIT)
Categories	Maven Build Tools KeY Data Data Formats Formal Verification
GroupId	com.github.sriki77
ArtifactId	keychain-passwd-maven-plugin
Last Version	1.0
Release Date	Feb 6, 2014
Type	maven-plugin
Description	keychain-passwd-maven-plugin This plugin retrieves the password from OSX keychain and sets it as a Maven Project property - which can be used by other plugins.
Project URL	https://github.com/sriki77/keychain-passwd-maven-plugin
Source Code Management	https://github.com/sriki77/keychain-passwd-maven-plugin

Download keychain-passwd-maven-plugin

Filename	Size
keychain-passwd-maven-plugin-1.0.pom
keychain-passwd-maven-plugin-1.0.jar	22 KB

How to add to project

Apache Maven

<plugin>
    <groupId>com.github.sriki77</groupId>
    <artifactId>keychain-passwd-maven-plugin</artifactId>
    <version>1.0</version>
</plugin>

Dependencies

compile (3)

Group / Artifact	Type	Version
org.apache.maven : maven-plugin-api	jar	3.1.1
org.codehaus.plexus : plexus-utils	jar	3.0.8
org.apache.maven : maven-core	jar	3.1.1

provided (1)

Group / Artifact	Type	Version
org.apache.maven.plugin-tools : maven-plugin-annotations	jar	3.2

test (4)

Group / Artifact	Type	Version
junit : junit	jar	4.9
org.apache.maven.plugin-testing : maven-plugin-testing-harness	jar	3.0.0
org.codehaus.plexus : plexus-container-default	jar	1.5.5
org.apache.maven : maven-compat	jar	3.1.1

Project Modules

There are no modules declared in this project.

OSX Keychain Password Maven Plugin

I use maven for deployments. This requires me to provide credentials - username and password to maven. You can provide the password when the command is run everytime or store it in maven pom file. Securing password is an issue with all the systems that support only username/password base authentication.

Thats the background for creation of this plugin. This plugin retrieves the password from OSX keychain and sets it as a Maven Project property - which can be used by other plugins. As expected, the plugin is OSX specific.

Usage

• Create a password item in Mac key chain. Screenshot below.
• Configure the maven plugin as follows to access the created keychain it

<plugin>
      <groupId>com.github.sriki77</groupId>
      <artifactId>keychain-passwd-maven-plugin</artifactId>
      <version>1.0</version>
      <configuration>
            <accountName>maven-test-item</accountName>
            <itemName>maven-test-item</itemName>
            <passwordProperty>password</passwordProperty>
      </configuration>
      <executions>
            <execution>
                  <goals>
                        <goal>getpasswd</goal>
                  </goals>
            </execution>
      </executions>
</plugin>

• itemName (default: mvn-app-passwd) and accountName (default: mvn-app-passwd) are help identify the password item from keychain
• passwordProperty (default: password)is the name of the system property to which the retrieved password value should be set. In the above case a Java system property named password will set the value retrieved from keychain.
• When the keychain is accessed by maven plugin, OSX will prompt on whether you like the Java program to access keychain; reply Allow will cause the password to be retrived successfully.
• If the password retrieval fails, an error is logged in console indicating the same. The failure to retrive password is not considered fatal and will not halt maven execution. The passwordProperty value will be null.
• The plugin by default runs in validate phase of the maven build lifecycle.

Location of Maven Plugin

This maven plugin is found in OSS Sonatype repository

      <repository>
            <id>Sonatype repository</id>
            <name>Sonatype's Maven repository</name>
            <url>https://oss.sonatype.org/content/repositories/releases</url>
            <snapshots>
                  <enabled>false</enabled>
            </snapshots>
      </repository>

Acknowledgments

• This maven plugin uses an excellent Java based implementation - osx-key-chain-java by Conor McDermottroe to access the OSX keychain. This implementation is core to the plugin. Thanks to him for letting me use the same for the plugin.

Versions

Version
1.0 Feb 6, 2014