com.vmware.card-connectors:connectors

Connectors that have been developed for Workspace One Mobile Flows

License	BSD-2
Categories	VMware Container Virtualization Tools
GroupId	com.vmware.card-connectors
ArtifactId	connectors
Last Version	2.5
Release Date	Oct 16, 2019
Type	pom
Description	Connectors that have been developed for Workspace One Mobile Flows

Download connectors

Filename	Size
connectors-2.5.pom	5 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.vmware.card-connectors/connectors/ -->
<dependency>
    <groupId>com.vmware.card-connectors</groupId>
    <artifactId>connectors</artifactId>
    <version>2.5</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.vmware.card-connectors/connectors/
implementation 'com.vmware.card-connectors:connectors:2.5'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.vmware.card-connectors/connectors/
implementation ("com.vmware.card-connectors:connectors:2.5")

Apache Buildr

'com.vmware.card-connectors:connectors:pom:2.5'

Apache Ivy

<dependency org="com.vmware.card-connectors" name="connectors" rev="2.5">
  <artifact name="connectors" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.vmware.card-connectors', module='connectors', version='2.5')
)

Scala SBT

libraryDependencies += "com.vmware.card-connectors" % "connectors" % "2.5"

Leiningen

[com.vmware.card-connectors/connectors "2.5"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

• airwatch
• aws-cert
• concur
• github-pr
• gitlab-pr
• hub-concur
• jira
• salesforce
• servicenow
• hub-servicenow
• bitbucket-server
• hub-salesforce
• hub-coupa
• testdrive-salesforce

Workspace One Connectors

Overview

These are connectors that have been developed for Workspace One Mobile Flows. Although all of them can be used as-is, they can also be used as base from which VMware customers can develop their own connectors.

The connectors are written in Java and use the Spring Framework. More specifically, they use Spring Boot, embedding Tomcat 8.5.

For a detailed, language-neutral, specification for how to develop connectors, please see the Card Connectors Guide.

This repository also includes common libraries. Please see their README for more details.

Docker

The connectors can be run as Docker containers.

Prerequisites

• Docker

Running

The latest published versions of the connectors are available in the Docker Hub registry.

For example, you can run the latest jira-connector with:

docker run --name jira-connector \
           -p 8080:8080 \
           -d \
           ws1connectors/jira-connector \
           --server.port=8080 \
           --security.oauth2.resource.jwt.key-uri="https://prod.hero.vmwservices.com/security/public-key"

Fat Jars

The connectors can also be built and run as executable "fat" jars.

Prerequisites

• Java 11

Building

Clone this repository or download as zip. Unzip the repo if you downloaded a zip. Use the below command from within the repository directory to build the fat JARs:

./mvnw clean install

Running

After building the JAR(s), you can run them with java -jar. For example, here is a command to run the jira-connector:

java -server \
     -jar \
     connectors/jira/target/jira-connector-2.1-SNAPSHOT.jar \
     --server.port=8080 \
     --security.oauth2.resource.jwt.key-uri="https://prod.hero.vmwservices.com/security/public-key"

NodeJS Based Connectors

The nodejs based connectors can be build and deployed using Docker.

Prerequisites

• Docker

Building

Clone this repository or download as zip. Unzip the repo if you downloaded a zip. Use the below command from within the repository directory to create the docker image:

docker build -t hub-jira-service-desk-connector .

Running

You can run your local container built from the docker build command above with:

docker run --name hub-jira-service-desk-connector \
           -p 8080:8080 \
           -e PORT=8080 \
           -e MF_JWT_PUB_KEY_URI="https://prod.hero.vmwservices.com/security/public-key" \
           -d \
           hub-jira-service-desk-connector

The latest published versions of the connectors are available in the Docker Hub registry.

For example, you can run the latest hub-jira-service-desk-connector with:

docker run --name hub-jira-service-desk-connector \
           -p 8080:8080 \
           -e PORT=8080 \
           -e MF_JWT_PUB_KEY_URI="https://prod.hero.vmwservices.com/security/public-key" \
           -d \
           ws1connectors/hub-jira-service-desk-connector

Troubleshooting

For more information on common mistakes, see TROUBLESHOOTING.md.

Contributing

The connectors-workspace-one project team welcomes contributions from the community. Before you start working with connectors-workspace-one, please read our Developer Certificate of Origin. All contributions to this repository must be signed as described on that page. Your signature certifies that you wrote the patch or have the right to pass it on as an open-source patch. For more detailed information, refer to CONTRIBUTING.md.

License

Workspace One Connectors are available under the BSD 2 license

VMware

Versions

Version
2.5 Oct 16, 2019
2.4 Aug 27, 2019
2.3 Apr 22, 2019
2.2 Apr 11, 2019
2.1 May 18, 2018
2.0 Mar 2, 2018
1.0.0 Dec 20, 2017