import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * Provides a resource to manage AWS Secrets Manager secret rotation. To manage a secret, see the `aws.secretsmanager.Secret` resource. To manage a secret value, see the `aws.secretsmanager.SecretVersion` resource. * * ## Example Usage * * ### Basic * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const example = new aws.secretsmanager.SecretRotation("example", { * rotationRules: { * automaticallyAfterDays: 30, * }, * secretId: exampleAwsSecretsmanagerSecret.id, * rotationLambdaArn: exampleAwsLambdaFunction.arn, * }); * ``` * * ### Managed External Secret Rotation * * For managed external secrets that are rotated by AWS partner integrations: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const example = new aws.secretsmanager.Secret("example", { * name: "example-salesforce-client-secret", * type: "SalesforceClientSecret", * }); * const exampleSecretRotation = new aws.secretsmanager.SecretRotation("example", { * rotationRules: { * automaticallyAfterDays: Number(rotationDays), * }, * externalSecretRotationMetadatas: [ * { * key: "adminSecretArn", * value: example.arn, * }, * { * key: "apiVersion", * value: "v65.0", * }, * ], * secretId: example.id, * externalSecretRotationRoleArn: exampleAwsIamRole.arn, * }); * ``` * * For more information about managed external secrets and partner-specific metadata requirements, see the [AWS documentation](https://docs.aws.amazon.com/secretsmanager/latest/userguide/managed-external-secrets.html) and [partner-specific guides](https://docs.aws.amazon.com/secretsmanager/latest/userguide/mes-partners.html). * * ### Disable Rotation for a Managed Secret * * When a secret is managed by AWS, such as an RDS master user password secret created via `manageMasterUserPassword`, rotation is enabled automatically. Set `rotationEnabled` to `false` (and omit `rotationRules`) to turn that rotation off: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const example = new aws.rds.Instance("example", {manageMasterUserPassword: true}); * const exampleSecretRotation = new aws.secretsmanager.SecretRotation("example", { * secretId: example.masterUserSecrets[0].secretArn, * rotationEnabled: false, * }); * ``` * * > **NOTE:** For Amazon Aurora and other clustered engines, rotation is finalized once a cluster instance is available, and AWS re-enables rotation if it is cancelled before then. Ensure this resource depends on the cluster instance (for example, with `dependsOn = [aws_rds_cluster_instance.example]`) so the cancellation is applied after the instance is available. * * When `rotationEnabled` is `false`, `rotationRules` must be omitted. If you toggle rotation on and off through a variable (for example, in a module), gate the block with a `dynamic` block so it is only present when rotation is enabled: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * function singleOrNone(elements: pulumi.Input[]): pulumi.Input | undefined { * if (elements.length > 1) { * throw new Error("singleOrNone expected input list to have a single element"); * } * return elements[0]; * } * * const config = new pulumi.Config(); * const rotationEnabled = config.getBoolean("rotationEnabled") || true; * const example = new aws.secretsmanager.SecretRotation("example", { * rotationRules: singleOrNone(rotationEnabled ? [{ * automaticallyAfterDays: 30, * }] : []), * secretId: exampleAwsDbInstance.masterUserSecret[0].secretArn, * rotationEnabled: rotationEnabled, * }); * ``` * * ### Rotation Configuration * * To enable automatic secret rotation, the Secrets Manager service requires usage of a Lambda function. The [Rotate Secrets section in the Secrets Manager User Guide](https://docs.aws.amazon.com/secretsmanager/latest/userguide/rotating-secrets.html) provides additional information about deploying a prebuilt Lambda functions for supported credential rotation (e.g., RDS) or deploying a custom Lambda function. * * > **NOTE:** Configuring rotation causes the secret to rotate once as soon as you enable rotation. Before you do this, you must ensure that all of your applications that use the credentials stored in the secret are updated to retrieve the secret from AWS Secrets Manager. The old credentials might no longer be usable after the initial rotation and any applications that you fail to update will break as soon as the old credentials are no longer valid. * * > **NOTE:** If you cancel a rotation that is in progress (by removing the `rotation` configuration), it can leave the VersionStage labels in an unexpected state. Depending on what step of the rotation was in progress, you might need to remove the staging label AWSPENDING from the partially created version, specified by the SecretVersionId response value. You should also evaluate the partially rotated new version to see if it should be deleted, which you can do by removing all staging labels from the new version's VersionStage field. * * ## Import * * ### Identity Schema * * #### Required * * - `secretId` (String) ARN of the Secrets Manager secret. * * Using `pulumi import`, import `aws.secretsmanager.SecretRotation` using the secret ARN. For example: * * ```sh * $ pulumi import aws:secretsmanager/secretRotation:SecretRotation example arn:aws:secretsmanager:us-east-1:123456789012:secret:example-123456 * ``` */ export declare class SecretRotation extends pulumi.CustomResource { /** * Get an existing SecretRotation resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: SecretRotationState, opts?: pulumi.CustomResourceOptions): SecretRotation; /** * Returns true if the given object is an instance of SecretRotation. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is SecretRotation; /** * Configuration block for metadata required by the external secret partner. Required for managed external secrets. See details below. */ readonly externalSecretRotationMetadatas: pulumi.Output; /** * ARN of the IAM role that allows Secrets Manager to rotate the secret held by a third-party partner. Required for managed external secrets. */ readonly externalSecretRotationRoleArn: pulumi.Output; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ readonly region: pulumi.Output; /** * Whether to rotate the secret immediately or wait until the next scheduled rotation window. The rotation schedule is defined in `rotationRules`. For secrets that use a Lambda rotation function to rotate, if you don't immediately rotate the secret, Secrets Manager tests the rotation configuration by running the testSecret step (https://docs.aws.amazon.com/secretsmanager/latest/userguide/rotate-secrets_how.html) of the Lambda rotation function. The test creates an AWSPENDING version of the secret and then removes it. Defaults to `true`. */ readonly rotateImmediately: pulumi.Output; /** * Whether automatic rotation is enabled for the secret. Set to `false` to disable rotation on a secret whose rotation is otherwise managed by AWS (for example, an RDS master user password secret). When `false`, `rotationRules` must be omitted. Defaults to enabled when `rotationRules` is configured. Destroying this resource does not re-enable the automatic rotation that AWS configured. */ readonly rotationEnabled: pulumi.Output; /** * ARN of the Lambda function that can rotate the secret. Must be supplied if the secret is not managed by AWS. */ readonly rotationLambdaArn: pulumi.Output; /** * Structure that defines the rotation configuration for this secret. Required unless `rotationEnabled` is `false`. Defined below. */ readonly rotationRules: pulumi.Output; /** * Secret to which you want to add a new version. You can specify either the ARN or the friendly name of the secret. The secret must already exist. */ readonly secretId: pulumi.Output; /** * Create a SecretRotation resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: SecretRotationArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering SecretRotation resources. */ export interface SecretRotationState { /** * Configuration block for metadata required by the external secret partner. Required for managed external secrets. See details below. */ externalSecretRotationMetadatas?: pulumi.Input[] | undefined>; /** * ARN of the IAM role that allows Secrets Manager to rotate the secret held by a third-party partner. Required for managed external secrets. */ externalSecretRotationRoleArn?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Whether to rotate the secret immediately or wait until the next scheduled rotation window. The rotation schedule is defined in `rotationRules`. For secrets that use a Lambda rotation function to rotate, if you don't immediately rotate the secret, Secrets Manager tests the rotation configuration by running the testSecret step (https://docs.aws.amazon.com/secretsmanager/latest/userguide/rotate-secrets_how.html) of the Lambda rotation function. The test creates an AWSPENDING version of the secret and then removes it. Defaults to `true`. */ rotateImmediately?: pulumi.Input; /** * Whether automatic rotation is enabled for the secret. Set to `false` to disable rotation on a secret whose rotation is otherwise managed by AWS (for example, an RDS master user password secret). When `false`, `rotationRules` must be omitted. Defaults to enabled when `rotationRules` is configured. Destroying this resource does not re-enable the automatic rotation that AWS configured. */ rotationEnabled?: pulumi.Input; /** * ARN of the Lambda function that can rotate the secret. Must be supplied if the secret is not managed by AWS. */ rotationLambdaArn?: pulumi.Input; /** * Structure that defines the rotation configuration for this secret. Required unless `rotationEnabled` is `false`. Defined below. */ rotationRules?: pulumi.Input; /** * Secret to which you want to add a new version. You can specify either the ARN or the friendly name of the secret. The secret must already exist. */ secretId?: pulumi.Input; } /** * The set of arguments for constructing a SecretRotation resource. */ export interface SecretRotationArgs { /** * Configuration block for metadata required by the external secret partner. Required for managed external secrets. See details below. */ externalSecretRotationMetadatas?: pulumi.Input[] | undefined>; /** * ARN of the IAM role that allows Secrets Manager to rotate the secret held by a third-party partner. Required for managed external secrets. */ externalSecretRotationRoleArn?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * Whether to rotate the secret immediately or wait until the next scheduled rotation window. The rotation schedule is defined in `rotationRules`. For secrets that use a Lambda rotation function to rotate, if you don't immediately rotate the secret, Secrets Manager tests the rotation configuration by running the testSecret step (https://docs.aws.amazon.com/secretsmanager/latest/userguide/rotate-secrets_how.html) of the Lambda rotation function. The test creates an AWSPENDING version of the secret and then removes it. Defaults to `true`. */ rotateImmediately?: pulumi.Input; /** * Whether automatic rotation is enabled for the secret. Set to `false` to disable rotation on a secret whose rotation is otherwise managed by AWS (for example, an RDS master user password secret). When `false`, `rotationRules` must be omitted. Defaults to enabled when `rotationRules` is configured. Destroying this resource does not re-enable the automatic rotation that AWS configured. */ rotationEnabled?: pulumi.Input; /** * ARN of the Lambda function that can rotate the secret. Must be supplied if the secret is not managed by AWS. */ rotationLambdaArn?: pulumi.Input; /** * Structure that defines the rotation configuration for this secret. Required unless `rotationEnabled` is `false`. Defined below. */ rotationRules?: pulumi.Input; /** * Secret to which you want to add a new version. You can specify either the ARN or the friendly name of the secret. The secret must already exist. */ secretId: pulumi.Input; } //# sourceMappingURL=secretRotation.d.ts.map