Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -196,7 +196,7 @@ These come from the project's architecture decision records.
| Event Handler: AppSync Events | [references/event-handler-appsync-events.md](references/event-handler-appsync-events.md) |
| Event Handler: Bedrock Agents | [references/event-handler-bedrock-agents.md](references/event-handler-bedrock-agents.md) |
| Parameters and secrets | [references/parameters.md](references/parameters.md) |
| Auth (alpha): JWT verification, OAuth2 client | [references/auth-jwt-oauth2.md](references/auth-jwt-oauth2.md) |
| Auth: JWT verification, OAuth2 client, SigV4 request signing | [references/auth-jwt-oauth2.md](references/auth-jwt-oauth2.md) |
| Batch processing | [references/batch-processing.md](references/batch-processing.md) |
| Kafka consumer | [references/kafka.md](references/kafka.md) |
| Typing | [references/typing.md](references/typing.md) |
Expand Down

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ dev: dev-quality-code
uv run --locked pre-commit install

dev-quality-code:
uv sync --locked --extra all --extra redis --extra datamasking --extra valkey
uv sync --locked --extra all --extra redis --extra datamasking --extra valkey --extra auth-sigv4a

format-check:
uv run --locked ruff format aws_lambda_powertools tests examples --check
Expand Down
16 changes: 15 additions & 1 deletion aws_lambda_powertools/utilities/auth/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,19 @@
from aws_lambda_powertools.utilities.auth.jwt import AuthErrorContext as AuthErrorContext
from aws_lambda_powertools.utilities.auth.jwt import JWTVerifier as JWTVerifier
from aws_lambda_powertools.utilities.auth.oauth2 import OAuth2Client as OAuth2Client
from aws_lambda_powertools.utilities.auth.signer import SignedRequest as SignedRequest
from aws_lambda_powertools.utilities.auth.signer import SigV4aSigner as SigV4aSigner
from aws_lambda_powertools.utilities.auth.signer import SigV4Signer as SigV4Signer

__all__ = ["AuthErrorContext", "AuthFailureReason", "JWTVerifier", "OAuth2Client"]
__all__ = [
"AuthErrorContext",
"AuthFailureReason",
"JWTVerifier",
"OAuth2Client",
"SigV4Signer",
"SigV4aSigner",
"SignedRequest",
]


def __getattr__(name: str) -> object:
Expand All @@ -20,6 +31,9 @@ def __getattr__(name: str) -> object:
"AuthFailureReason": "exceptions",
"JWTVerifier": "jwt",
"OAuth2Client": "oauth2",
"SigV4Signer": "signer",
"SigV4aSigner": "signer",
"SignedRequest": "signer",
}
if name in modules:
value = getattr(importlib.import_module(f"{__name__}.{modules[name]}"), name)
Expand Down
1 change: 1 addition & 0 deletions aws_lambda_powertools/utilities/auth/exceptions.py
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ class AuthFailureReason(str, Enum):
JWKS_UNAVAILABLE = "jwks_unavailable"
TOKEN_EXCHANGE_FAILED = "token_exchange_failed" # nosec B105
DOWNSTREAM_REQUEST_FAILED = "downstream_request_failed"
SIGNER_MISCONFIGURED = "signer_misconfigured"


class AuthError(Exception):
Expand Down
26 changes: 26 additions & 0 deletions aws_lambda_powertools/utilities/auth/signer/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
"""AWS Signature Version 4 and 4A request signing."""

from __future__ import annotations

import importlib
from typing import TYPE_CHECKING

if TYPE_CHECKING:
from aws_lambda_powertools.utilities.auth.signer.sigv4 import SignedRequest as SignedRequest
from aws_lambda_powertools.utilities.auth.signer.sigv4 import SigV4Signer as SigV4Signer
from aws_lambda_powertools.utilities.auth.signer.sigv4a import SigV4aSigner as SigV4aSigner

__all__ = ["SigV4Signer", "SigV4aSigner", "SignedRequest"]


def __getattr__(name: str) -> object:
modules = {"SigV4Signer": "sigv4", "SignedRequest": "sigv4", "SigV4aSigner": "sigv4a"}
if name in modules:
value = getattr(importlib.import_module(f"{__name__}.{modules[name]}"), name)
globals()[name] = value
return value
raise AttributeError(f"module {__name__!r} has no attribute {name!r}")


def __dir__() -> list[str]:
return sorted(set(globals()) | set(__all__))
20 changes: 20 additions & 0 deletions aws_lambda_powertools/utilities/auth/signer/exceptions.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
"""Errors raised by the request signer. Messages never include credential material."""

from aws_lambda_powertools.utilities.auth.exceptions import AuthError, AuthFailureReason

__all__ = ["AuthError", "AuthFailureReason", "SignerConfigError"]


class SignerConfigError(AuthError):
"""The signer cannot sign: no region, no credentials, or a missing optional dependency.
Raised at construction, before any request is signed, so a misconfigured function
fails on the first cold start instead of sending unsigned requests.
"""

message = "Request signer is not configured"
reason = AuthFailureReason.SIGNER_MISCONFIGURED

def __init__(self, detail: str) -> None:
self.message = f"{SignerConfigError.message}: {detail}"
super().__init__()
Loading
Loading