Setting up Orcid integration
Aim of this document
This section explains how, as an RSpace admin, you can set up RSpace to enable users to connect their Orcid accounts to their RSpace account
You don't need to do this if your RSpace is hosted by Research Space and has a web address ending in .researchspace.com, as RSpace is supplied with default clientId and clientSecret for this domain.
Even if you have an on-premises RSpace, the App registration on Orcid is entirely optional - we can send you a clientId and clientSecret to use for the 'Steps in RSpace' section. This App registration is only necessary if you prefer to create your own Orcid RSpace app for your users for an on-premises installation.
This procedure is a one-off step - it does not need to be done for every RSpace user!
- An account on Orcid
- Access to RSpace server in order to set in clientId and secret you will acquire from Orcid
- The RSpace server must allow 2-way HTTPS communication with Orcid
Steps in Orcid
- Log into Orcid. Now click on 'Developer Tools' in the dropdown at the top-right of the screen:
- If this is the first time you have gone to the developer section, you will see an invitation to register for the public Orcid API. Click on the 'Register' button and agree to any Terms and Conditions
- Now, you can define the RSpace-Orcid connector, for example:For the redirect URI, add a URL in the form
<RSPACE_URL>/orcid/redirect_uri. For example if your RSpace is hosted at
https://rspace.myuniversity.ac.ukthen the callback URI will be
- Save the App configuration.
- You will now see a screen showing your clientId and clientSecret - make a note of these:
You have now successfully registered the Orcid - RSpace connector App.
Steps in RSpace
- Connect to RSpace server terminal
- Open file
/etc/rspace/deployment.propertiesand add the following properties, using the values you just obtained from Orcid:
orcid.client.id=<MY ORCID CLIENT ID>
orcid.client.secret=<MY ORCID SECRET>
- Save the file and restart RSpace
- You may need to login as sysadmin user and activate the Orcid integration in
Settings-> Configuration->System Settings
Testing the setup
Follow the steps explained for an RSpace end-user: ORCID Integration