Table of contents

Github

• Create a new OAuth Application

• Settings:
  • Name: any value (i.e.: Elements Connect)
  • Homepage URL: your Jira base URL
  • Authorization callback URL: https://JIRABASEURL/nfeed/admin/models/datasources/oauth/_callback 
  • Click on "Register application"
• You are redirected to your application home page on Github
• Note the Client ID and the Client Secret, they will be needed during the configuration of the datasource in Elements Connect.

That's it from the Github side.

Elements Connect

Now, you'll create a new datasource in Elements Connect.
You must be a Jira admin.

• Login into Elements Connect administration
• Go to Datasources
• Add a new URL datasource

• Settings:
  • Name: Github (or any value that makes sense to you)
  • URL: https://api.github.com
  • Authentication: OAuth2
  • Content type: JSON
• Click on the "Configure" button below "Authentication"

• Settings:
  • ClientID: the Client ID obtained from Github at the previous step
  • Client secret: the Client secret obtained from Github at the previous step
  • Authorise URL: https://github.com/login/oauth/authorize 
  • Token URL: https://github.com/login/oauth/access_token 
  • Scopes: depends on your needs, check the documentation on Github about scopes
• Click on "Get new credential"
• You're redirected to Github authorization screen
• Click on the green "Authorize XXX" button
• You're redirected to the Elements Connect datasource configuration page
• The "The authorisation process was successful." informs you that the configuration is successful 
• Click on "Close"
• You can save the datasource

That's it!

You can now connect your fields to Github REST API.
See how to list GitHub repositories in an Elements Custom field.