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.
- Java 8
There are two ways of building. The first is simply to create the fat jars:
./mvnw clean install
Additionally, it is possible to build RPMs, which install the connectors as services on RPM-based systems:
./mvnw clean install -Pmake-rpm
Building the RPMs is possible only within an RPM-based system. A Vagrantfile
is provided for this purpose.
Each connector has its own RPM. For example, jira-connector-1.0.0.noarch.rpm.
The first step is to use the RPM to install the connector as a service. For example:
yum install jira-connector-1.0.0.noarch.rpm
Before the service can be run, some configuration is required. The connectors authenticate requests expecting an access token from VMware IDM. These tokens are JWTs whose signatures must be verified using a public key. This public key is acquired from a URL that is supplied to the connector via a new configuration file.
For example, for the Jira connector:
echo "security.oauth2.resource.jwt.key-uri=https://acme.vmwareidentity.com/SAAS/API/1.0/REST/auth/token?attribute=publicKey&format=pem" \
> /etc/opt/vmware/connectors/jira/application.properties
The hostname of the URL will vary depending on your IDM tenant.
The configuration file created above must be part of the roswell user and group. Again, using Jira as an example:
chown roswell:roswell /etc/opt/vmware/connectors/jira/application.properties
The connector being a Spring Boot application, many other configuration options are available—for example, server.port. Please see the Spring Boot documentation for more details.
There might also be connector-specific configuration required. Please see the README files within the individual connectors for further details.
Once the connector is configured, it can be started. For example:
systemctl start jira-connector
Check the status after about 10-20 seconds to make sure the service is good:
systemctl status jira-connector
Also check the logs if there are problems:
less /var/log/vmware/connectors/jira/jira-connector.log
The connector can be updated using yum. For example, to update the Jira connector from 1.0.0 to 1.0.1:
yum upgrade jira-connector-1.0.1.noarch.rpm
Updating will not touch your overriding application.properties in /etc. It is probably a good idea to take a glance at /opt/vmware/connectors/jira/application.properties after updating to verify that there aren't any new things in the config that you should override. If there are any new settings you wish to configure, make sure you do so in the application.properties in /etc so that future updates/uninstalls don't throw away your config.
yum remove jira-connector
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.
Workspace One Connectors are available under the BSD 2 license