How to use Boto3 to store a new secret in a specific location in AWS Secret Manager

Problem Statement: Use boto3 library in Python to store a new secret in a specific location in AWS Secret Manager

Approach/Algorithm to solve this problem

  • Step 1: Import boto3 and botocore exceptions to handle exceptions.

  • Step 2: secret_stored_location and secret_key_pair are the required parameters. Make sure secret_key_pair is written as string, not as dict.

  • Step 3: Create an AWS session using boto3 lib. Make sure region_name is mentioned in the default profile. If it is not mentioned, then explicitly pass the region_name while creating the session.

  • Step 4: Create an AWS client for secretmanager.

  • Step 5: Call put_secret_value and pass the secret_stored_location as SecretId and secret_key_pair as SecretString.

  • Step 6: It returns the metadata of added new secret.

  • Step 7: Handle the generic exception if something went wrong while adding secret.

Example Code

Use the following code to store a new secret in AWS Secret Manager −

import boto3
from botocore.exceptions import ClientError

def store_new_secret_details(secret_stored_location, secret_key_pair):
   session = boto3.session.Session()
   s3_client = session.client('secretmanager')
   response = s3_client.put_secret_value(SecretId=secret_stored_location,SecretString = secret_key_pair)
   return response
   except ClientError as e:
      raise Exception("boto3 client error in store_new_secret_details: " + e.__str__())
   except Exception as e:
      raise Exception("Unexpected error in store_new_secret_details: " + e.__str__())

a = store_new_secret_details('/secrets/aws', '{"user_test2":"test2"}')


{'ARN': 'arn:aws:secretsmanager:us-east-1:***************:secret:/secrets/aws-wr1Aj6', 'Name': '/secrets/aws', 'VersionId': 'f5308bed-7c23-4d47-a32b-8f2a5f044e53', 'VersionStages': ['AWSCURRENT'],   'ResponseMetadata': {'RequestId': 'b32fe48d**************ab', 'HTTPStatusCode': 200, 'HTTPHeaders': {'date': 'Sat, 03 Apr 2021 09:40:48 GMT', 'content-type': 'application/x-amz-json-1.1', 'content-length': '197', 'connection': 'keep-alive', 'x-amzn-requestid': *********************************}, 'RetryAttempts': 0}}