Implementation

Implementing Onecub Connect into your service is easily and quickly doable.
If you encounter any trouble during your implementation, contact us at contact@onecub.fr, we will be pleased to help you.

Note
For security purpose, we strongly encourage you to use OAuth 2.0 client libraries when interacting with Onecub Connect's OAuth 2.0 authorization server.

Before you start

In order to offer Onecub Connect to your users, you will first need to sign in.
To do so, just send an email to contact@onecub.fr with the following information:

  • your company name
  • your company icon (minimum 100x100 px and ideally with transparent background)
  • your home page URL
  • your privacy policy URL
  • your scope
  • are you only interested in accessing future data or do you need access to history data also?
  • a redirectURI (HTTPS) that will be used to redirect users at the end of the Onecub Connect process
  • a sentence that describes your use-case: what do you propose to your users thanks to their data ? (100 characters maximum)

If you have any doubt on how to proceed or any question feel free to send an email to contact@onecub.fr with your questions.
We will contact you as soon as possible.

If everything is fine, you will receive your Client ID and Client Secret.

Important
Do not store your Secret in a publicly-accessible location and do not lose it!

Main steps

There are 2 major steps in the Onecub Connect implementation:

  • implement the OAuth 2.0 protocol to interact with the Onecub Connect authorization server
  • call the Onecub Connect API to retrieve your users data