benchling_sdk.apps.helpers.webhook_helpers module

class GetJwksFunction

Bases: Protocol

Function for custom resolution of JWKs for an app definition.

__init__(*args, **kwargs)

class JwkUrlProvider

Bases: Protocol

Function for custom URL for resolving JWKs by app definition id.

Should generally never be used except in the event of specialized testing with internal Benchling.

__init__(*args, **kwargs)

class LegacyGetJwksFunction

Bases: Protocol

Function for custom resolution of JWKs for an app.

__init__(*args, **kwargs)

class LegacyJwkUrlProvider

Bases: Protocol

Function for custom URL for resolving JWKs by app.

Should generally never be used except in the event of specialized testing with internal Benchling.

__init__(*args, **kwargs)

exception WebhookVerificationError

Bases: Exception

Webhook Verification Error.

Indicates a webhook from Benchling could not be verified.

Some reasons this could happen include: - An app developer misconfiguration (e.g., wrong app) - A webhook was received too late - The webhook did not originate from Benchling (possible attack vector)

jwks_by_app(app_id: str, httpx_client: Optional[httpx.Client] = None, jwk_url_provider: Optional[LegacyJwkUrlProvider] = None) → jwcrypto.jwk.JWKSet

Get JWKs by App (Deprecated).

Please migrate to jwks_by_app_definition, which uses an app’s global app_definition_id.

Retrieves a set of JWKs assigned to an app used to verify webhooks.

JWKs generally should not be resolved on their own. We recommend using webhook verification functions such as verify_app_installation().

This method is provided for specialized cases such as customizing the httpx client.

jwks_by_app_definition(app_definition_id: str, httpx_client: Optional[httpx.Client] = None, jwk_url_provider: Optional[JwkUrlProvider] = None) → jwcrypto.jwk.JWKSet

Get JWKs for a Benchling App from its global app_definition_id.

Retrieves a set of JWKs assigned to an app definition used to verify webhooks.

JWKs generally should not be resolved on their own. We recommend using webhook verification functions such as verify().

This method is provided for specialized cases such as customizing the httpx client.

verify(app_definition_id: str, data: str, headers: dict, jwk_function: Optional[GetJwksFunction] = None) → None

Verify a webhook for a Benchling App from its global app_definition_id.

Verifies that a webhook was a valid webhook from Benchling. Raises WebhookVerificationError if the webhook could not be verified. Resolves JWKs from Benchling with default settings. Pass jwk_function for customization.

verify_app_installation(app_id: str, data: str, headers: dict, jwk_function: Optional[LegacyGetJwksFunction] = None) → None

Verify a webhook for an app installation (Deprecated).

Please migrate to verify, which uses an app’s global app_definition_id.

Verifies that a webhook was a valid webhook from Benchling. Raises WebhookVerificationError if the webhook could not be verified. Resolves JWKs from Benchling with default settings. Pass jwk_function for customization.