Feature request: Secrets Events

[koolray]

Use case

When setting up secrets rotation you can rotate the secret via a specific lambda, therefore I think having a secrets event would be useful here.

Solution/User Experience

Setting up a secrets event, similar to the way the other events are handled parsing the json object into a dataclass.

Alternative solutions

I'd be happy to help codify this if someone where to help outline the basic requirements.

Acknowledgment

• This feature request meets Powertools for AWS Lambda (Python) Tenets
• Should this be considered in other Powertools for AWS Lambda languages? i.e. Java, TypeScript, and .NET

[boring-cyborg]

Thanks for opening your first issue here! We'll come back to you as soon as we can.
In the meantime, check out the #python channel on our Powertools for AWS Lambda Discord: Invite link

[leandrodamascena]

Hi @koolray! Thanks for opening this issue!

Yeah, this is interesting to add support to this event. If I remember correctly, the payload that AWS Secrets send to Lambda is something like: {"token":"xx", "secretid": "yy", "Step": "zz"}. I need to confirm it.

Do you have bandwidth to add this support? It would be amazing to have your contribution here.

Thanks

[koolray]

Hey @leandrodamascena, this is the format I've found in the aws docs:

{
    "Step" : "request.type",
    "SecretId" : "string",
    "ClientRequestToken" : "string"
}

I have the bandwidth and would be happy to help! Once I create a PR I'll probably need some guidance as to the style and tests that is used in this repo (as I've never contributed before). I will do my best to mimic that of the other classes, but would still appreciate some help.

If this suits you, let me know

[leandrodamascena]

Hey @leandrodamascena, this is the format I've found in the aws docs:

{
    "Step" : "request.type",
    "SecretId" : "string",
    "ClientRequestToken" : "string"
}

I created a secret and rotated it and got this exact event, so it's the payload to Lambda.

I have the bandwidth and would be happy to help! Once I create a PR I'll probably need some guidance as to the style and tests that is used in this repo (as I've never contributed before). I will do my best to mimic that of the other classes, but would still appreciate some help.

This is amazing to hear. For sure we can guide you in this first contribution.

We use Poetry as the package manager and we have a Makefile to make things easier. So basically you need to clone the repository and type make dev to create your development environment. After that, you can do the following steps:

1 - You need to create a new file called secrets_event.py - Use this class as an example: https://github.com/aws-powertools/powertools-lambda-python/blob/develop/aws_lambda_powertools/utilities/data_classes/vpc_lattice.py

2 - You need to export this new class here - https://github.com/aws-powertools/powertools-lambda-python/blob/develop/aws_lambda_powertools/utilities/data_classes/__init__.py

3 - You need to create a file with a fake payload here - https://github.com/aws-powertools/powertools-lambda-python/tree/develop/tests/events

4 - You need to write a new test for this new class - Use this test as an example - https://github.com/aws-powertools/powertools-lambda-python/blob/develop/tests/unit/data_classes/test_vpc_lattice_event.py

5 - You need to add this new class to the documentation - https://github.com/aws-powertools/powertools-lambda-python/blob/develop/docs/utilities/data_classes.md

6 - Run the tests by typing make test and after that use make pr to make sure that everything is right.

7 - If everything is right, just open the PullRequest and have a cold drink 🍹

Let me know if you get stuck at any of these steps and we can work together to merge your contribution.

[koolray]

Thank you @leandrodamascena! This is great, I will make a start and put a draft PR on the weekend.

Then, whenever you or anyone else has time we can discuss potential changes to keep everything in line with existing code.

Thank you very much