Skip to main content

External Services & Secret Management SDK

SDK for integrating external services and managing secrets with AuthSec.

What's the Process to Integrate External Service?​

Learn how to create and manage secrets programmatically using the AuthSec SDK.

Step 1: Install AuthSec SDK​

pip install git+https://github.com/authsec-ai/sdk-authsec.git

Import Dependencies​

from authsec_sdk import protected_by_AuthSec, ServiceAccessSDK

Create Protected Function​

@protected_by_AuthSec("list_my_repos", scopes=["read"])
async def list_my_repos(arguments: dict, session) -> list:
    """List user's GitHub repositories."""

    # Create services SDK
    services_sdk = ServiceAccessSDK(session)

    # Fetch GitHub token from Vault (secure!)
    github_token = await services_sdk.get_service_token("your_token")

    # Call GitHub API
    async with aiohttp.ClientSession() as http:
        async with http.get(
            'https://api.github.com/user/repos',
            headers={'Authorization': f'Bearer {github_token}'}
        ) as response:
            repos = await response.json()

    # Format response
    repo_list = "\n".join([
        f"- {repo['full_name']} ({repo['stargazers_count']} ⭐)"
        for repo in repos[:10]
    ])

    return [{
        "type": "text",
        "text": f"Your GitHub Repositories:\n{repo_list}"
    }]