"""Secrets Manager rotation, in the four steps it calls in order. setSecret and testSecret are where a real rotation updates and checks the system the secret unlocks, such as a database user or a vendor API key. As written, the secret is a self-contained token, so both are empty. """ import boto3 sm = boto3.client("secretsmanager") def handler(event, _context): arn, token, step = event["SecretId"], event["ClientRequestToken"], event["Step"] meta = sm.describe_secret(SecretId=arn) if not meta.get("RotationEnabled"): raise ValueError("rotation is not enabled for this secret") stages = meta.get("VersionIdsToStages", {}) if token not in stages: raise ValueError("unknown version") if "AWSCURRENT" in stages[token]: return # already finished if step == "createSecret": try: sm.get_secret_value(SecretId=arn, VersionId=token, VersionStage="AWSPENDING") except sm.exceptions.ResourceNotFoundException: value = sm.get_random_password(PasswordLength=48, ExcludePunctuation=True)["RandomPassword"] sm.put_secret_value(SecretId=arn, ClientRequestToken=token, SecretString=value, VersionStages=["AWSPENDING"]) elif step == "setSecret": pass # tell the target system about the new value here elif step == "testSecret": pass # sign in to the target system with the new value here elif step == "finishSecret": current = next((v for v, s in stages.items() if "AWSCURRENT" in s), None) args = {"SecretId": arn, "VersionStage": "AWSCURRENT", "MoveToVersionId": token} if current: args["RemoveFromVersionId"] = current sm.update_secret_version_stage(**args) else: raise ValueError(f"unknown step {step}")