Interface CfnSecret.IGenerateSecretStringProperty

Namespace

Amazon.CDK.AWS.SecretsManager

Assembly

Amazon.CDK.AWS.SecretsManager.dll

Generates a random password.

public interface CfnSecret.IGenerateSecretStringProperty

Examples

// The code below shows an example of how to instantiate this type.
             // The values are placeholders you should change.
             using Amazon.CDK.AWS.SecretsManager;

             var generateSecretStringProperty = new GenerateSecretStringProperty {
                 ExcludeCharacters = "excludeCharacters",
                 ExcludeLowercase = false,
                 ExcludeNumbers = false,
                 ExcludePunctuation = false,
                 ExcludeUppercase = false,
                 GenerateStringKey = "generateStringKey",
                 IncludeSpace = false,
                 PasswordLength = 123,
                 RequireEachIncludedType = false,
                 SecretStringTemplate = "secretStringTemplate"
             };

Remarks

We recommend that you specify the maximum length and include every character type that the system you are generating a password for can support.

Required permissions: secretsmanager:GetRandomPassword . For more information, see IAM policy actions for Secrets Manager and Authentication and access control in Secrets Manager .

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html

ExampleMetadata: fixture=_generated

Properties

ExcludeCharacters

A string of the characters that you don't want in the password.

string? ExcludeCharacters { get; }

Property Value

string

Remarks

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html#cfn-secretsmanager-secret-generatesecretstring-excludecharacters

ExcludeLowercase

Specifies whether to exclude lowercase letters from the password.

object? ExcludeLowercase { get; }

Property Value

object

Remarks

If you don't include this switch, the password can contain lowercase letters.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html#cfn-secretsmanager-secret-generatesecretstring-excludelowercase

ExcludeNumbers

Specifies whether to exclude numbers from the password.

object? ExcludeNumbers { get; }

Property Value

object

Remarks

If you don't include this switch, the password can contain numbers.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html#cfn-secretsmanager-secret-generatesecretstring-excludenumbers

ExcludePunctuation

Specifies whether to exclude the following punctuation characters from the password: `!

object? ExcludePunctuation { get; }

Property Value

object

Remarks

" # $ % & ' ( ) * + , - . / : ; < = > ? @ [ \ ] ^ _ { | } ~ . If you don't include this switch, the password can contain punctuation.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html#cfn-secretsmanager-secret-generatesecretstring-excludepunctuation

ExcludeUppercase

Specifies whether to exclude uppercase letters from the password.

object? ExcludeUppercase { get; }

Property Value

object

Remarks

If you don't include this switch, the password can contain uppercase letters.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html#cfn-secretsmanager-secret-generatesecretstring-excludeuppercase

GenerateStringKey

The JSON key name for the key/value pair, where the value is the generated password.

string? GenerateStringKey { get; }

Property Value

string

Remarks

This pair is added to the JSON structure specified by the SecretStringTemplate parameter. If you specify this parameter, then you must also specify SecretStringTemplate .

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html#cfn-secretsmanager-secret-generatesecretstring-generatestringkey

IncludeSpace

Specifies whether to include the space character.

object? IncludeSpace { get; }

Property Value

object

Remarks

If you include this switch, the password can contain space characters.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html#cfn-secretsmanager-secret-generatesecretstring-includespace

PasswordLength

The length of the password.

double? PasswordLength { get; }

Property Value

double?

Remarks

If you don't include this parameter, the default length is 32 characters.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html#cfn-secretsmanager-secret-generatesecretstring-passwordlength

RequireEachIncludedType

Specifies whether to include at least one upper and lowercase letter, one number, and one punctuation.

object? RequireEachIncludedType { get; }

Property Value

object

Remarks

If you don't include this switch, the password contains at least one of every character type.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html#cfn-secretsmanager-secret-generatesecretstring-requireeachincludedtype

SecretStringTemplate

A template that the generated string must match.

string? SecretStringTemplate { get; }

Property Value

string

Remarks

When you make a change to this property, a new secret version is created.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-secretsmanager-secret-generatesecretstring.html#cfn-secretsmanager-secret-generatesecretstring-secretstringtemplate