# PasswordPolicies Object

> Source: https://truto.one/docs/api-reference/unified-cloud-infrastructure-api/passwordpolicies/

Schema for the `PasswordPolicies` resource in **Unified Cloud Infrastructure API**.

## Properties

- **`id`** _(string, required)_
  Truto's stable unified identifier for this object. Opaque; use provider_id to address the object in the provider's own console or API.
- **`provider_id`** _(string)_
  The provider's own identifier, verbatim -- a full ARN, resource id, or self-link. Never truncated or normalised. Use it to find the object in the provider's console.
- **`provider`** _(string)_
  Which cloud this object was read from.
  Allowed: `aws`, `azure`, `gcp`
- **`account`** _(string)_
  The account, subscription or project this object belongs to.
- **`region`** _(string)_
  Where the object is located. 'global' marks resources with no region (e.g. IAM, a GCP VPC network). If the provider gives none, the collector's queried region is used instead and flagged in unreadable_fields.
- **`native_type`** _(string)_
  The provider's own type string, unmodified -- for example 'AWS::S3::Bucket', 'aws_iam_role', 'Microsoft.Sql/servers'. Used for display and drill-down.
- **`tags`** _(object)_
  Key-value pairs exactly as the customer set them -- no case folding, key/value normalisation, or merging across providers. An empty object means no tags; unreadable tags appear in unreadable_fields instead.
- **`collected_at`** _(string)_
  When Truto read this object from the provider, in UTC ISO 8601 with offset. Not the request time, and not a provider-supplied timestamp.
- **`updated_at`** _(string)_
  When the object was last modified at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.
- **`created_at`** _(string)_
  When the object was created at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.
- **`unreadable_fields`** _(array<object>)_
  Fields on this object that could not be read, and why. An empty array means everything was read. Use this to tell a real value from a missing one.
  - **`field`** _(string)_
    The property on this resource that could not be read.
  - **`reason`** _(string)_
    Why the field could not be read. available_on_get: Not read on list to keep the list fast; call GET for this resource's id to get it.
    Allowed: `not_supported_by_provider`, `not_configured`, `permission_denied`, `not_collected`, `collection_error`, `partially_collected`, `available_on_get`
  - **`detail`** _(string)_
    Additional detail on the reason, when there is any.
- **`remote_data`** _(object)_
  Raw data returned from the remote API call.
- **`policy_id`** _(string)_
  Provider reference for the policy, where one exists.
- **`scope`** _(string)_
  Whether the policy applies to an account, a tenant, an organisational unit, or a directory.
  Allowed: `account`, `organisation`, `grouping`, `tenant`, `directory`
- **`scope_id`** _(string)_
  The provider reference for the scope this policy applies to.
- **`is_configured`** _(boolean)_
  Whether a policy has actually been set. On AWS, no policy (404 from GetAccountPasswordPolicy) means provider defaults apply -- a weaker posture -- and this is false, never unknown.
- **`minimum_length`** _(integer)_
  Minimum password length.
- **`reuse_prevention`** _(integer)_
  How many previous passwords cannot be reused.
- **`expiry_days`** _(integer)_
  Maximum password age in days. Null with not_configured if the provider supports expiry but none is set; null with not_supported_by_provider if expiry doesn't exist at all.
- **`hard_expiry`** _(boolean)_
  Whether an expired password locks the user out rather than prompting a reset.
- **`lockout_threshold`** _(integer)_
  Failed sign-in attempts before lockout. AWS IAM has no such setting, so this is null with not_supported_by_provider -- never 0, which would misread as 'locks immediately'.
- **`complexity_flags`** _(object)_
  Which character classes are required, as provider-named booleans -- for example require_symbols, require_numbers, require_uppercase, require_lowercase.
  - **`require_symbols`** _(boolean)_
    Whether at least one non-alphanumeric character is required.
  - **`require_numbers`** _(boolean)_
    Whether at least one digit is required.
  - **`require_uppercase`** _(boolean)_
    Whether at least one uppercase letter is required.
  - **`require_lowercase`** _(boolean)_
    Whether at least one lowercase letter is required.
  - **`allow_users_to_change_password`** _(boolean)_
    Whether users may change their own password without an administrator.
- **`banned_password_protection`** _(boolean)_
  Whether the provider blocks known-breached or banned passwords. Null with not_supported_by_provider on AWS IAM, which has no such feature.
- **`field_configurable`** _(object)_
  Per-field map of whether the customer can change that value, distinguishing 'fixed at 8' from 'set to 8'. On AWS the length floor is fixed at 6, reuse prevention capped at 24, and the symbol set fixed.
  - **`minimum_length`** _(boolean)_
    Whether the customer can change the minimum length.
  - **`reuse_prevention`** _(boolean)_
    Whether the customer can change how many previous passwords are remembered.
  - **`expiry_days`** _(boolean)_
    Whether the customer can change the password expiry period.
  - **`hard_expiry`** _(boolean)_
    Whether the customer can change whether an expired password locks the user out.
  - **`lockout_threshold`** _(boolean)_
    Whether the customer can change the failed-sign-in lockout threshold.
  - **`banned_password_protection`** _(boolean)_
    Whether the customer can change banned or breached password protection.
- **`provenance`** _(string)_
  Where this policy came from. 'static' means the values are transcribed from the provider's documentation, not read live -- true of AWS Identity Center, which exposes no policy API.
  Allowed: `live`, `static`, `default`

## Methods

- [GET /unified/cloud-infrastructure/password_policies](/docs/api-reference/unified-cloud-infrastructure-api/passwordpolicies/list) — List Password policies