IDE plugin connecting to REST API

Getting Started

Build Plugin

• Install Java JDK (minimal version 8) and maven 3.3.x
• clone repository
• cd ide-plugin-eclipse
• cd targets && mvn clean install
• cd .. && mvn clean install -Djarsigner.skip=true -DskipTests

Install Plugin

• open Eclipse
• select Help>Install New Software>Add
• click Archive...
• select updatesite/target/contrastide.updatesite-(version)-SNAPSHOT.zip
• select Contrast IDE
• restart Eclipse

Testing

Project is currently configured to run tests with maven from project source using maven goal integration-test. This will run unit and integration tests together. In order to run successfully integration tests, it is required to pass some values as maven parameters:

• username
• apiKey
• serviceKey
• restApiUrl
• organizationId

Example command:

mvn clean integration-test -Dusername=someone -DapiKey=youApiKeyForOrganization -DserviceKey=yourServiceKey -DrestApiUrl=tsApiUrl -DorganizationId=orgId1

Development

Requirements: Eclipse SDK Mars 4.5 or higher, recommended m2e and EGit

• import all "Existing Projects"
• create an Eclipse PDE Run/Debug configuration with included com.contrastsecurity.ide* plugins

Signing

Plugin build makes use of Apache Maven Jarsigner Plugin to sign automatically during package phase. Sign required parameters are passed as maven build parameters as follow:

• keystore.path : Path location of the keystore file (.jks).
• keystore.storepass : Keystore password.
• keystore.alias : Key alias.
• keystore.keypass : Key password.

Example maven command:

mvn clean install -Dkeystore.path=/path/to/keystore -Dkeystore.storepass=keystorePass -Dkeystore.alias=alias -Dkeystore.keypass=keyPass

To disable this behavior add this line at the end of your maven build command:

mvn ... -Djarsigner.skip=true

License

GPL version 3