From 1686a1023cce7c9bd2abd69f63b77e1bd6351dc7 Mon Sep 17 00:00:00 2001 From: Radek Simko Date: Sat, 6 Feb 2016 11:41:52 +0000 Subject: [PATCH] provider/aws: Add docs for AWS Account Password Policy resource --- .../iam_account_password_policy.html.markdown | 51 +++++++++++++++++++ website/source/layouts/aws.erb | 4 ++ 2 files changed, 55 insertions(+) create mode 100644 website/source/docs/providers/aws/r/iam_account_password_policy.html.markdown diff --git a/website/source/docs/providers/aws/r/iam_account_password_policy.html.markdown b/website/source/docs/providers/aws/r/iam_account_password_policy.html.markdown new file mode 100644 index 0000000000..072f2c48cc --- /dev/null +++ b/website/source/docs/providers/aws/r/iam_account_password_policy.html.markdown @@ -0,0 +1,51 @@ +--- +layout: "aws" +page_title: "AWS: aws_iam_account_password_policy" +sidebar_current: "docs-aws-resource-iam-account-password-policy" +description: |- + Manages Password Policy for the AWS Account. +--- + +# aws\_iam\_account_password_policy + +-> **Note:** There is only a single policy allowed per AWS account. An existing policy will be lost when using this resource as an effect of this limitation. + +Manages Password Policy for the AWS Account. +See more about [Account Password Policy](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_account-policy.html) +in the official AWS docs. + +## Example Usage + +``` +resource "aws_iam_account_password_policy" "strict" { + minimum_password_length = 8 + require_lowercase_characters = true + require_numbers = true + require_uppercase_characters = true + require_symbols = true + allow_users_to_change_password = true +} +``` + +## Argument Reference + +The following arguments are supported: + +* `allow_users_to_change_password` - (Optional) Whether to allow users to change their own password +* `hard_expiry` - (Optional) Whether users are prevented from setting a new password after their password has expired + (i.e. require administrator reset) +* `max_password_age` - (Optional) The number of days that an user password is valid. +* `minimum_password_length` - (Optional) Minimum length to require for user passwords. +* `password_reuse_prevention` - (Optional) The number of previous passwords that users are prevented from reusing. +* `require_lowercase_characters` - (Optional) Whether to require lowercase characters for user passwords. +* `require_numbers` - (Optional) Whether to require numbers for user passwords. +* `require_symbols` - (Optional) Whether to require symbols for user passwords. +* `require_uppercase_characters` - (Optional) Whether to require uppercase characters for user passwords. + +## Attributes Reference + +The following attributes are exported: + +* `expire_passwords` - Indicates whether passwords in the account expire. + Returns `true` if `max_password_age` contains a value greater than `0`. + Returns `false` if it is `0` or _not present_. diff --git a/website/source/layouts/aws.erb b/website/source/layouts/aws.erb index 4dbbd1d169..9643b18ffd 100644 --- a/website/source/layouts/aws.erb +++ b/website/source/layouts/aws.erb @@ -283,6 +283,10 @@ aws_iam_access_key + > + aws_iam_account_password_policy + + > aws_iam_group