---
id: python-tss-sdk
version: "2.0.1"
license: unclear
license_treatment: permissive
maintenance: aging
---

# python-tss-sdk — The Delinea Secret Server Python SDK

License: permissive · Maintenance: aging · Downloads: 450.3K/mo

## What it is and what it does

This SDK is a REST client that connects to Delinea Secret Server or Platform to fetch secrets programmatically. It abstracts away HTTP details and provides classes for authentication (password-based, domain-based, or token-based) and secret retrieval, returning secrets as JSON objects or dataclass instances. The library depends only on requests and supports Python 3.8 through 3.11.

You use it by instantiating an authorizer with your credentials, creating a client, and calling get_secret() with a secret ID or path. It handles OAuth2 token exchange internally and can work with self-signed certificates via the REQUESTS_CA_BUNDLE environment variable. The SDK has not been updated in 284 days, so verify compatibility with your Secret Server version.

Use it for:

- Retrieve database credentials at application startup to connect to production databases securely.
- Fetch API keys or tokens within a CI/CD pipeline for deployment automation.
- Access domain credentials for Windows authentication in hybrid environments.
- Integrate as a centralized credential store for microservices running on Kubernetes.
- Query secret paths programmatically in compliance and audit workflows.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for retrieving secrets from Delinea Secret Server and Platform via REST APIs, supporting multiple authentication methods.

Yes, if you use Delinea Secret Server or Platform and need a Python client to retrieve secrets. The library is straightforward, has low install friction, and carries no known vulnerabilities. However, maintenance is aging (284 days since last release), so verify compatibility with your Secret Server version and check for any API changes.

## Install

pip install python-tss-sdk
uv add python-tss-sdk
poetry add python-tss-sdk

## Installing python-tss-sdk

Before you install: Low install friction with a single pure-Python wheel dependency on requests. Maintenance status is aging—last release was 284 days ago—so updates may lag behind upstream changes.

License in practice: Licensed under Apache Software License (permissive), allowing use in most commercial and open-source projects without significant legal constraints.

Quickstart:

pip install python-tss-sdk

from python_tss_sdk import SecretServerCloud, PasswordGrantAuthorizer

authorizer = PasswordGrantAuthorizer("https://hostname/SecretServer", username, password)
secret_server = SecretServerCloud(tenant="mytenant", authorizer=authorizer)
secret = secret_server.get_secret(secret_id)

Requires Python 3.8 or higher. Valid Secret Server or Platform credentials and network access to the server instance are required.

Verify before relying:

- Whether the SDK handles token refresh automatically or requires manual re-authentication after expiry.
- Performance characteristics when retrieving large numbers of secrets or working with large payloads.
- Compatibility with recent Secret Server or Platform API versions beyond the last release date.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 450.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

secret server python client, delinea secrets sdk, retrieve secrets from secret server, secret management python, tss api client, password vault integration, credential retrieval sdk, secrets-management, credential-retrieval, delinea-integration

[View on SkillFed](https://skillfed.io/packages/python-tss-sdk) · [View on PyPI](https://pypi.org/project/python-tss-sdk/)