We're experiencing difficulty. Our engineers are on it. Please check status.mailgun.com for real-time updates.

Google Authentication

Mailgun provides the ability to authenticate a user via Google OAuth so long as the user that was created on Mailgun has an account registered with Google.

Enabling Google Authentication within Mailgun

Follow the steps below to enable Google Authentication for your user on Mailgun:

  1. Navigate towards the top-right of the page next to your username, click the down-arrow, and then select the Account option. Alternatively, you can use this direct link
  2. On the resulting page, you will see various groups, or sections, of settings. In the Authentication section, locate the Google Auth field. 
  3. Click the light grey Setup button, and Mailgun will redirect you to the Google Auth flow.
  4. Google will ask you to confirm the email address you want to use to log in (be sure to choose the email address that you have set up for your Mailgun account).
  5. Google will redirect you to the Mailgun app.

Logging into the Mailgun App using Google Authentication

If you've followed the steps to enable Google auth and the user you're using to log in is authenticated, then providing an email address on the login page and clicking next will automatically log you into the Mailgun app:

Screen_Shot_2019-10-01_at_3.59.12_PM.png

 

Disabling Google Authentication within Mailgun

Follow the steps below to disable Google Authentication for your user on Mailgun:

  1. Navigate towards the top-right of the page next to your username, click the down-arrow, and then select the Account option. Alternatively, you can use this direct link
  2. On the resulting page, you will see various groups, or sections, of settings. In the Authentication section, locate the Google Auth field. 
  3. Click the light grey Disable button to remove the Google Auth flow.

Screen_Shot_2019-10-01_at_3.26.59_PM.png

Enforcing Google Authentication on an account

If you so choose, an admin user can enforce Google Authentication for all users on an account. In order to do so, you must ensure that the admin user that is logged in already has Google Authentication enabled for their user. Once this is done, within Account -> the Account settings section you will find the Force user auth scheme option. After clicking the light grey Require Google button, you will be presented with 2 options:

  • Clear all user sessions - This option will clear any logged-in sessions and will require users to enable Google Auth immediately
  • Allow user sessions to stay logged in - This option will allow users to continue in their current session and set up Google Auth once their session expires and they have to re-login. 

Upon the next sign-in, all users will be directed to set up Google Authentication in order to continue to sign in.

 

**It's important to note that creating or disabling a user within Google Workspace will not create or remove a user from the Mailgun system. You will still need to manage users within the Mailgun app.