Secrets Manager

The Secrets Manager provides secure storage for sensitive values your project needs: API keys, tokens, database credentials, and configuration secrets that should not be hardcoded in your application.

Why Secrets Manager Matters

Hardcoding credentials in application code creates security vulnerabilities and operational friction. Every key rotation requires a code change, secrets leak into version control, and access becomes impossible to audit. The Secrets Manager centralizes credential storage with proper security controls, separating sensitive configuration from your codebase.

With Secrets Manager, you can:

Store credentials encrypted at rest with project-level isolation
Reference secrets in workflows and pipelines without exposing values in code
Rotate credentials without redeploying your application
Restrict access to users with appropriate permissions

Secret Structure

Each secret consists of a name and one or more key-value pairs. This structure allows grouping related credentials under a single identifier. For example, a secret named database-config might contain keys for host, port, username, and password.

Secret Values are hidden by default. Once saved, you cannot view them in plain text again, you can only delete or replace them.

Using Secrets Manager

To create a secret using the Platform:

Navigate to Connect > Secrets Manager in the sidebar
Click + Add Secret
Enter a name and one or more key-value pairs
Click Save

Secrets are accessed through the async platform.secrets API:

import asyncio
from interactiveai import Interactive

interactiveai = Interactive()

async def main():
    # List all secrets
    secrets = await interactiveai.platform.secrets.list()
    for s in secrets:
        print(f"{s.name} (keys: {s.keys})")

    # Get a specific secret by name
    secret = await interactiveai.platform.secrets.get("payment-service")
    payment_api_key = secret.data["api_key"]

    # Create a new secret
    await interactiveai.platform.secrets.create("my-secret", {"api_key": "sk-..."})

    # Update an existing secret
    await interactiveai.platform.secrets.update("my-secret", {"api_key": "sk-new-..."})

    # Delete a secret
    await interactiveai.platform.secrets.delete("my-secret")

asyncio.run(main())

All platform.secrets methods are async. Use await when calling them, or wrap them in asyncio.run() for synchronous scripts.

PreviousLLMs NextInteractive Agent

Last updated 4 months ago

Was this helpful?

import asyncio
from interactiveai import Interactive

interactiveai = Interactive()

async def main():
    # List all secrets
    secrets = await interactiveai.platform.secrets.list()
    for s in secrets:
        print(f"{s.name} (keys: {s.keys})")

    # Get a specific secret by name
    secret = await interactiveai.platform.secrets.get("payment-service")
    payment_api_key = secret.data["api_key"]

    # Create a new secret
    await interactiveai.platform.secrets.create("my-secret", {"api_key": "sk-..."})

    # Update an existing secret
    await interactiveai.platform.secrets.update("my-secret", {"api_key": "sk-new-..."})

    # Delete a secret
    await interactiveai.platform.secrets.delete("my-secret")

asyncio.run(main())