Create an OAuth 2.0 client
Navigate to your TARTLE Developer Settings page on the 'OAuth App' tab. You can then click on 'New App' to begin the process of creating a new DataVault OAuth 2.0 client.
We currently only support one OAuth 2.0 client per buyer account. There is, however, no limit to the number of packets you can associate to this client, enabling you to create any number of data products with the tokens they provide.
In the client creation modal form, you'll need to provide the following information:
- Application Name: This is what your users will see in the OAuth 2.0 consent screen, make it recognizable.
- Application Description: A short description of what your application does, this will be displayed in a list of installed apps for users that use your client and how some of them will evaluate its usefulness if they are thinking about revoking access, so make it count.
- Redirect URI: The URI to redirect to after the user has authenticated.
Example of good values for the form fields
Application Name: Acme Receipts Sync
Application Description: Sync your receipts from Acme to TARTLE, we will create a data packet of
your receipts so you can receive bids from our trusted partners. You can then sell this data to
the partners you choose. Unleash the value of your data.
Redirect URI: https://acme-receipts.com/auth/callback
Once you've filled out the form, click on 'Save' to create your client. You will be shown a modal with your client_id
and client_secret
. Read the
instructions carefully.
You will need to save your client_secret
in a secure place as it will not be
displayed again. If you lose it, you will need to delete your current
application and create a new one. All currently authorized users will need to
re-authorize your new application.
Please don't save your client_secret
to a GitHub or any other respository. Best practice is to save it in a secure environment like AWS Secrets Manager
for use in your application and a password manager for reference.