Symplectic Elements

Server Infrastructure

For the Elements hosts, there exists two environments:

  • Quality Assurance (QA)

  • Production

This pattern has been inherited from the Office of Information Technology, and currently, the following hosts are are available only from within the Princeton University network:

  • oaworkflow-dev.princeton.edu (cisdr301w.princeton.edu)

  • oaworkflow.princeton.edu (cisdr201w.princeton.edu)

Both of these hosts utilize the Windows Server 2012 R2 operating system.

Within the documentation for the Elements installation, the oaworkflow-dev environment is referred consistently to as the qa environment, and is used as both a development and staging environment. oaworkflow alone serves as the production environment.

The Elements REST API

First, please ensure that you have access to the Princeton University VPN by using the GlobalProtect client. This can be obtained by following the documentation on https://workcontinuity.princeton.edu/remoteaccess.

Then, please request access to the Elements API password from a member of the Research Data and Scholarship Services (RDSS) team. It is recommended that one set this to a BASH environment variable using the following:

$ export ELEMENTS_SECRET=$(echo -n "rest:$ELEMENTS_PASSWORD" | base64)

One may then proceed by transmitting GET requests using then base64-encoded string as an authorization token:

Production Environment

# This is the latest release of the API
$ curl -H "Authorization: Basic $ELEMENTS_SECRET" https://oaworkflow.princeton.edu:8091/secure-api/v5.5/users

# This is the legacy API
$ curl -H "Authorization: Basic $ELEMENTS_SECRET" https://oaworkflow.princeton.edu:8091/elements-api/v4.9/users

Quality Assurance (QA) Environment

# This is the latest release of the API
$ curl -H "Authorization: Basic $ELEMENTS_SECRET" https://oaworkflow-dev.princeton.edu:8091/secure-api/v5.5/users

# This is the legacy API
$ curl -H "Authorization: Basic $ELEMENTS_SECRET" https://oaworkflow-dev.princeton.edu:8091/elements-api/v4.9/users

Symplectic Documentation

For reference, please find the following documentation for the Symplectic Elements REST API at the following:

Should one be required to authenticate with a user name and password for accessing this documentation, please contact a member of the DRDS team for support.

Troubleshooting

Network or Server Access

Should one encounter issues related to the ability to access a given service over a TCP port for one of the two servers managed by the Office of Information Technology (OIT), please be aware that there is a specific form which is used to submit firewall rule update requests:

Otherwise, should there be any general questions regarding the ability to request server access, please submit the enquiry using: