Apache CouchDB

Overview

Use Apache CouchDB credentials to make authenticated API calls through Alter Vault without exposing API keys in code.

Property	Value
Provider ID	couchdb
Category	Database
Credential Type	Base64 Credentials

Step 1: Get Credentials

Create a CouchDB user

Create a CouchDB user with access to the databases the integration needs.

Encode the credentials

Base64-encode the credentials: echo -n 'username:password' | base64.

Paste the encoded string

Paste the encoded string into the credential field.

Warning

Never share credentials publicly. Store them securely and only enter them in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Apache CouchDB

Go to Managed Secrets > Add Provider > Apache CouchDB.

Enter credentials

Paste your Base64 Credentials into the credential field.

Save

Click Save. You’ll receive a grant_id to use with the SDK.

Using in Code

response = await alter_app.request(
    HttpMethod.POST,
    "https://YOUR-COUCHDB-HOST/mydb/_find",
    grant_id="YOUR_GRANT_ID",
    json={"selector": {"type": "user"}, "limit": 5},
)

Notes

• CouchDB uses HTTP Basic authentication — the stored value is injected as Authorization: Basic <encoded>.