SDK Client#

This documentation auto-generates details about the OAuth authentication and convenience methods provided by the SDK for users.

Note

The required configuration values (eg IDs) can be found at OAuth.

class libs.sdk.src.destiny_sdk.client.OAuthMiddleware(env: Literal['development', 'staging', 'production'] | None = None, auth_url: str = 'https://auth.evidence-repository.org', realm: str = 'destiny', client_id: str | None = None, client_secret: SecretStr | None = None, scopes: list[str] | None = None, callback_port: int = 8400, azure_client_id: str | None = None, azure_application_id: str | None = None, azure_login_url: HttpUrl | str | None = None, azure_client_secret: SecretStr | None = None, *, use_managed_identity: bool = False)[source]#

Auth middleware that routes to either Keycloak or Azure OAuth backends.

The backend is selected by which kwargs are provided:

Keycloak (default): the routing target unless any Azure kwarg is given. env (recommended) or client_id is required.
Azure AD: pass any azure_* kwarg or use_managed_identity=True. Managed identity is supported. The interactive (public-client) and confidential-client (azure_client_secret) flows are deprecated and will be removed in a future release; migrate those callers to Keycloak.

# Interactive login for user accounts
auth = OAuthMiddleware(env="production")

# Client credentials flow for service accounts
auth = OAuthMiddleware(
    client_id="your-client-id",
    client_secret="your-client-secret"
)

class libs.sdk.src.destiny_sdk.client.OAuthClient(base_url: HttpUrl | str | None = None, auth: Auth | None = None, timeout: int = 10, *, env: Literal['development', 'staging', 'production'] | None = None)[source]#

Client for interaction with the Destiny API using OAuth2.

This will apply the provided authentication, usually OAuthMiddleware, to all requests. Some API endpoints are supported directly through methods on this class, while others can be accessed through the underlying httpx client.

Example usage:

from destiny_sdk.client import OAuthClient

# Either use env for defaults or provide explicit auth and base_url
client = OAuthClient(env="production")
client = OAuthClient(
    base_url="https://destiny-repository.example.com",
    auth=OAuthMiddleware(...),
)

# Supported method
response = client.search(query="example")

# Unsupported method, use underlying httpx client
response = client.get_client().get("/system/healthcheck/")

get_client() → Client[source]#

Get the underlying httpx client.

This can be used to make custom requests not covered by the SDK methods.

Returns:: The underlying httpx client with authentication attached.
Return type:: httpx.Client

lookup(identifiers: list[str | IdentifierLookup], timeout: int | None = None) → list[Reference][source]#

Lookup references by identifiers.