Contact UsTry it for free
© 2025 Direct Cursus Technology L.L.C.

Updating an MFA policy

Written by
Updated at November 29, 2025

Note

This feature is at the Preview stage.

To update an MFA policy:

  1. Log in to Yandex Identity Hub.

  2. In the left-hand panel, select Security settings.

  3. Navigate to the MFA policies tab.

  4. In the MFA policy list, click in the policy row and select Edit. In the window that opens, do the following:

    1. In the Name field, enter a new name for the policy. Follow these naming requirements:

      • It must be from 1 to 63 characters long.
      • It may contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.

    2. Optionally, enter a policy description in the Description field.

    3. If required, use Policy active to activate or deactivate the policy.

    4. In the Factor types field, select additional authentication factors required for users from the policy's target groups to verify their identity:

      • Any. This option allows users to select one of the following additional authentication factor standards:

        • WebAuthn (FIDO2). The acceptable additional authentication factors may include hardware keys such as Rutoken or YubiKey, Passkeys authenticators, platform authenticators such as Windows Hello, etc.

          Warning

          Browser extensions with password input control may cause errors when entering additional factors. We recommend disabling such extensions in case of errors.

        • TOTP. This standard enables using one-time codes generated by dedicated authenticator apps as an additional authentication factor.

      • Phishing-resistant. This option enforces the WebAuthn authentication factors as the most secure ones.

    5. In the Creation deadline field, specify the period in days during which the user must add a second authentication factor after registration.

    6. In the Lifetime field, set the credential validity period, in days.

      Upon expiry of the specified timeout, the user will need to authenticate with the additional factor again.

    7. Click Save.

If you do not have the Yandex Cloud CLI installed yet, install and initialize it.

By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.

  1. View the MFA policy list using this command:

    yc organization-manager mfa-enforcement list \
  --organization-id <organization_ID>

    Where organization_id is the organization ID.

  2. View the description of an MFA policy:

    yc organization-manager mfa-enforcement get \
  --id <policy_ID>

  3. View the description of the update MFA policy CLI command:

    yc organization-manager mfa-enforcement update --help

  4. To update an MFA policy, run this command:

    yc organization-manager mfa-enforcement update \
  --id <policy_ID> \
  --acr-id <authentication_factor_type> \
  --ttl <lifetime> \
  --status <policy_status> \
  --apply-at <time_of_applying_changes> \
  --enroll-window <registration_period> \
  --new-name <new_name> \
  --description <new_description> \
  --organization-id <organization_ID>

    Where:

    • --id: MFA policy ID.
    • --acr-id: Authentication factor type.
    • --ttl: Credential validity period in days.
    • --status: Policy status, active (status-active) or inactive (status-inactive).
    • --apply-at: Time after which the policy will become active.
    • --enroll-window: Period in days after registration during which the user must add a second authentication factor.
    • --new-name: New policy name.
    • --description: New description.
    • --organization-id: Organization ID.

Note

For an MFA policy to apply to specific user accounts, add the users in question or the groups they are members of to the policy's target groups.

See also

Previous
Applying an MFA policy to users
Next
Activating or deactivating an MFA policy