Creating and Using Your cURL API Authorization Key

To use Ripple’s cURL API, you must authenticate your identity using an Authorization Key. This key is an encrypted version of your username and password, ensuring secure API access while protecting sensitive credentials.

✅ You must be a Site Admin or Site Manager.
✅ You must have access to the study where data is being imported or exported.

Why is an Authorization Key Required?

The Authorization Key verifies that you have the correct permissions to perform API actions.
It prevents plain-text exposure of your username and password in API commands.

How to Create Your Authorization Key

Follow these steps to generate your Authorization Key:

Step 1: Encode Your Credentials

• Go to Base64 Encode.
• Ensure the site is set to "Encode" mode.
• In the top input box, enter your Ripple credentials using this format:
  RippleUsername:Passwor
• Click the "Encode" button. 

Step 2: Copy Your Authorization Key

• After encoding, a Base64 string will appear in the output box.
• Copy this string and store it securely.
• Step 3: Use the Authorization Key in Your cURL Command
• Replace YOUR_AUTH_KEY in the cURL command with your Base64-encoded Authorization Key.
• Example: Exporting Data Using an Authorization Key
• "https://your-ripple-instance.com/v1/export""Authorization: Basic YOUR_AUTH_KEY""export-Type=registry""file=@/Users/yourname/Desktop/export.csv"

• Security Best Practices for Authorization Keys

  • Do not share your Authorization Key with others.
  • Store your key securely and avoid saving it in unencrypted files.
  • Make sure to regenerate your Authorization Key when you change your Ripple username or password.