Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
ClientTlsMode
✓ from spiffetls import ClientTlsMode
✗ from spiffetls import Identity
ServerTlsMode
✓ from spiffetls import ServerTlsMode
create_ssl_context
✓ from spiffetls import create_ssl_context
Initialize SPIFFE identity from environment and create mTLS connection config.
import os
from spiffetls import Identity, MTLSConnection
from spiffetls import config
def test_connection():
# Create identity from environment or default path
identity = Identity(
spiffe_id="spiffe://example.org/workload",
socket_path=os.environ.get("SPIFFE_ENDPOINT_SOCKET", "/run/spire/agent.sock")
)
# Create TLS config
tls_config = config.TLSClientConfig(
spiffe_id_matcher=lambda id: id.trust_domain == "example.org",
identity=identity
)
conn = MTLSConnection(tls_config)
# Use conn to establish TLS connections
print("Configuration ready")
test_connection()
Upgrade
Version history
0.3.2latest on PyPI · released May 11, 2026
Audit
Dependencies
py-spifferequiredCore SPIFFE workload API and identity representation
cryptographyrequiredTLS certificate handling
grpciorequiredgRPC transport for workload API (used internally by py-spiffe)