External Services & Secret Management

What's the Process to Integrate External Service?

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

Python

Step 1: Install AuthSec SDK

pip install authsec-sdk

Import Dependencies

from authsec_sdk import ServiceAccessSDK

Use a Protected Session

async def list_my_repos(arguments: dict, session) -> list:
    """List user's GitHub repositories."""

    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}"
    }]

TypeScript

Step 1: Install AuthSec SDK

npm install @authsec/sdk

Use a Protected Session

import { ServiceAccessSDK } from "@authsec/sdk";

export async function listMyRepos(args: Record<string, unknown>, session: unknown) {
  const services = new ServiceAccessSDK(session);
  const githubToken = await services.getServiceToken("github");

  const response = await fetch("https://api.github.com/user/repos", {
    headers: { Authorization: `Bearer ${githubToken}` },
  });

  const repos = await response.json();
  return repos.slice(0, 10).map((repo: any) => repo.full_name);
}