Platform.sh User Documentation

Multi-Factor Authentication (MFA)

Try for 30 days
Flexible, version-controlled infrastructure provisioning and development-to-production workflows
Activate your trial

Multi-Factor Authentication (MFA) enhances security by protecting both your organization and every user account that interacts with it through SSH or the Platform.sh API.

When MFA is enforced within an organization, every project contributor must enable MFA on their user account so they can run Git commands, SSH into an environment, or trigger actions through the Platform.sh API.

Enable MFA on your user account Anchor to this heading

To access an organization that enforces MFA or any of its projects, you must enable MFA on your user account. Failure to do so results in forbidden access to the organization from the Console or API, and an error message when trying to SSH into its environments.

To enable MFA on your user account, follow these steps:

  1. In the Console, open the user menu (your name or profile picture).
  2. Click My profile
  3. Click Authentication settings.
  4. Follow the instructions for the chosen authentication app.
  5. Click Verify & save.
  6. Refresh your SSH credentials by running platform login -f in the CLI.

Enforce MFA within your organization Anchor to this heading

Tier availability

This feature is available for Elite and Enterprise customers. Compare the tiers on our pricing page, or contact our sales team for more information.

TO enable MFA within your organization, follow these steps:

  1. In the Console, open the organization dropdown menu on the leftmost navigation.
  2. In the exanded navigation on the right hand side, click Security. This will take you to the User security settings view.
  3. In the MFA required area, set the Enable toggle on.

Send email reminders Anchor to this heading

You can send email reminders to users who haven’t enabled MFA on their user account yet. To do so, follow these steps:

  1. In the Console, open the organization dropdown menu on the leftmost navigation.
  2. In the exanded navigation on the right hand side, click Security. This will take you to the User security settings view.
  3. In the User security settings area, find the user you want to send a reminder to.
  4. Click More next to that user.
  5. Select Remind.
    An email is sent to the user with instructions on how to enable MFA on their user account.

Is this page helpful?