Google Authentication

Mailgun provides the ability to authenticate a user via Google OAuth so long as the user 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. Within the Mailgun application, click the Settings drop-down in the left hand nav to open the Details menu.

2. Within the Authentication section, you'll see a Google Auth sub-section; click on Setup Google Login:

3. Mailgun will redirect you to the Google Auth flow
4. Google will ask you to confirm the email address you want to use to login (be sure to choose the email address that you have setup 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 login is authenticated, then providing an email address on the login page and clicking next will automatically log you in to the Mailgun app:

Disabling Google Authentication within Mailgun

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

1. Within the Mailgun application, click the Settings drop-down in the left hand nav to open the Details menu.

2. Within the Authentication section, you'll see a Google Auth sub-section; click on Setup Google Login:

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, under Settings > Details > Account Details you will find the "Force auth scheme" section in which you can select the "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 setup Google Auth once their session expires and they have to re login. 

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

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