Amazonka.IAM.Types.PasswordPolicy

Documentation

data PasswordPolicy

Contains information about the account password policy.

This data type is used as a response element in the GetAccountPasswordPolicy operation.

See: newPasswordPolicy smart constructor.

Constructors

PasswordPolicy'

Fields

• allowUsersToChangePassword :: Maybe Bool

  Specifies whether IAM users are allowed to change their own password. Gives IAM users permissions to iam:ChangePassword for only their user and to the iam:GetAccountPasswordPolicy action. This option does not attach a permissions policy to each user, rather the permissions are applied at the account-level for all users by IAM.

• expirePasswords :: Maybe Bool

  Indicates whether passwords in the account expire. Returns true if MaxPasswordAge contains a value greater than 0. Returns false if MaxPasswordAge is 0 or not present.

• hardExpiry :: Maybe Bool

  Specifies whether IAM users are prevented from setting a new password via the Amazon Web Services Management Console after their password has expired. The IAM user cannot access the console until an administrator resets the password. IAM users with iam:ChangePassword permission and active access keys can reset their own expired console password using the CLI or API.

• maxPasswordAge :: Maybe Natural

  The number of days that an IAM user password is valid.

• minimumPasswordLength :: Maybe Natural

  Minimum length to require for IAM user passwords.

• passwordReusePrevention :: Maybe Natural

  Specifies the number of previous passwords that IAM users are prevented from reusing.

• requireLowercaseCharacters :: Maybe Bool

  Specifies whether IAM user passwords must contain at least one lowercase character (a to z).

• requireNumbers :: Maybe Bool

  Specifies whether IAM user passwords must contain at least one numeric character (0 to 9).

• requireSymbols :: Maybe Bool

  Specifies whether IAM user passwords must contain at least one of the following symbols:

  ! @ # $ % ^ & * ( ) _ + - = [ ] { } | '

• requireUppercaseCharacters :: Maybe Bool

  Specifies whether IAM user passwords must contain at least one uppercase character (A to Z).

Instances

FromXML PasswordPolicy

Defined in Amazonka.IAM.Types.PasswordPolicy

Methods

parseXML :: [Node] -> Either String PasswordPolicy

Generic PasswordPolicy

Defined in Amazonka.IAM.Types.PasswordPolicy

Associated Types

type Rep PasswordPolicy :: Type -> Type

Methods

from :: PasswordPolicy -> Rep PasswordPolicy x

to :: Rep PasswordPolicy x -> PasswordPolicy

Read PasswordPolicy

Defined in Amazonka.IAM.Types.PasswordPolicy

Methods

readsPrec :: Int -> ReadS PasswordPolicy

readList :: ReadS [PasswordPolicy]

readPrec :: ReadPrec PasswordPolicy

readListPrec :: ReadPrec [PasswordPolicy]

Show PasswordPolicy

Defined in Amazonka.IAM.Types.PasswordPolicy

Methods

showsPrec :: Int -> PasswordPolicy -> ShowS

show :: PasswordPolicy -> String

showList :: [PasswordPolicy] -> ShowS

NFData PasswordPolicy

Defined in Amazonka.IAM.Types.PasswordPolicy

Methods

rnf :: PasswordPolicy -> ()

Eq PasswordPolicy

Defined in Amazonka.IAM.Types.PasswordPolicy

Methods

(==) :: PasswordPolicy -> PasswordPolicy -> Bool

(/=) :: PasswordPolicy -> PasswordPolicy -> Bool

Hashable PasswordPolicy

Defined in Amazonka.IAM.Types.PasswordPolicy

Methods

hashWithSalt :: Int -> PasswordPolicy -> Int

hash :: PasswordPolicy -> Int

type Rep PasswordPolicy

Defined in Amazonka.IAM.Types.PasswordPolicy

type Rep PasswordPolicy = D1 ('MetaData "PasswordPolicy" "Amazonka.IAM.Types.PasswordPolicy" "amazonka-iam-2.0-5DxkArXx9sD3CCYYGFyGET" 'False) (C1 ('MetaCons "PasswordPolicy'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "allowUsersToChangePassword") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "expirePasswords") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool))) :*: (S1 ('MetaSel ('Just "hardExpiry") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: (S1 ('MetaSel ('Just "maxPasswordAge") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "minimumPasswordLength") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural))))) :*: ((S1 ('MetaSel ('Just "passwordReusePrevention") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)) :*: S1 ('MetaSel ('Just "requireLowercaseCharacters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool))) :*: (S1 ('MetaSel ('Just "requireNumbers") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: (S1 ('MetaSel ('Just "requireSymbols") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "requireUppercaseCharacters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)))))))

newPasswordPolicy :: PasswordPolicy

Create a value of PasswordPolicy with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:allowUsersToChangePassword:PasswordPolicy', passwordPolicy_allowUsersToChangePassword - Specifies whether IAM users are allowed to change their own password. Gives IAM users permissions to iam:ChangePassword for only their user and to the iam:GetAccountPasswordPolicy action. This option does not attach a permissions policy to each user, rather the permissions are applied at the account-level for all users by IAM.

$sel:expirePasswords:PasswordPolicy', passwordPolicy_expirePasswords - Indicates whether passwords in the account expire. Returns true if MaxPasswordAge contains a value greater than 0. Returns false if MaxPasswordAge is 0 or not present.

$sel:hardExpiry:PasswordPolicy', passwordPolicy_hardExpiry - Specifies whether IAM users are prevented from setting a new password via the Amazon Web Services Management Console after their password has expired. The IAM user cannot access the console until an administrator resets the password. IAM users with iam:ChangePassword permission and active access keys can reset their own expired console password using the CLI or API.

$sel:maxPasswordAge:PasswordPolicy', passwordPolicy_maxPasswordAge - The number of days that an IAM user password is valid.

$sel:minimumPasswordLength:PasswordPolicy', passwordPolicy_minimumPasswordLength - Minimum length to require for IAM user passwords.

$sel:passwordReusePrevention:PasswordPolicy', passwordPolicy_passwordReusePrevention - Specifies the number of previous passwords that IAM users are prevented from reusing.

$sel:requireLowercaseCharacters:PasswordPolicy', passwordPolicy_requireLowercaseCharacters - Specifies whether IAM user passwords must contain at least one lowercase character (a to z).

$sel:requireNumbers:PasswordPolicy', passwordPolicy_requireNumbers - Specifies whether IAM user passwords must contain at least one numeric character (0 to 9).

$sel:requireSymbols:PasswordPolicy', passwordPolicy_requireSymbols - Specifies whether IAM user passwords must contain at least one of the following symbols:

! @ # $ % ^ & * ( ) _ + - = [ ] { } | '

$sel:requireUppercaseCharacters:PasswordPolicy', passwordPolicy_requireUppercaseCharacters - Specifies whether IAM user passwords must contain at least one uppercase character (A to Z).

passwordPolicy_allowUsersToChangePassword :: Lens' PasswordPolicy (Maybe Bool)

Specifies whether IAM users are allowed to change their own password. Gives IAM users permissions to iam:ChangePassword for only their user and to the iam:GetAccountPasswordPolicy action. This option does not attach a permissions policy to each user, rather the permissions are applied at the account-level for all users by IAM.

passwordPolicy_expirePasswords :: Lens' PasswordPolicy (Maybe Bool)

Indicates whether passwords in the account expire. Returns true if MaxPasswordAge contains a value greater than 0. Returns false if MaxPasswordAge is 0 or not present.

passwordPolicy_hardExpiry :: Lens' PasswordPolicy (Maybe Bool)

Specifies whether IAM users are prevented from setting a new password via the Amazon Web Services Management Console after their password has expired. The IAM user cannot access the console until an administrator resets the password. IAM users with iam:ChangePassword permission and active access keys can reset their own expired console password using the CLI or API.

passwordPolicy_maxPasswordAge :: Lens' PasswordPolicy (Maybe Natural)

The number of days that an IAM user password is valid.

passwordPolicy_minimumPasswordLength :: Lens' PasswordPolicy (Maybe Natural)

Minimum length to require for IAM user passwords.

passwordPolicy_passwordReusePrevention :: Lens' PasswordPolicy (Maybe Natural)

Specifies the number of previous passwords that IAM users are prevented from reusing.

passwordPolicy_requireLowercaseCharacters :: Lens' PasswordPolicy (Maybe Bool)

Specifies whether IAM user passwords must contain at least one lowercase character (a to z).

passwordPolicy_requireNumbers :: Lens' PasswordPolicy (Maybe Bool)

Specifies whether IAM user passwords must contain at least one numeric character (0 to 9).

passwordPolicy_requireSymbols :: Lens' PasswordPolicy (Maybe Bool)

Specifies whether IAM user passwords must contain at least one of the following symbols:

! @ # $ % ^ & * ( ) _ + - = [ ] { } | '

passwordPolicy_requireUppercaseCharacters :: Lens' PasswordPolicy (Maybe Bool)

Specifies whether IAM user passwords must contain at least one uppercase character (A to Z).