Overview
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.
Important Note:
If an account user's email address is using Sinch ID, then Google Authentication is not an available option.
Enabling Google Authentication within Mailgun
We'll show you how to do this below:
- First, log in to the Mailgun Control Panel (if you have not already done so).
- Then, at the top-right corner of the page, click the Profile drop-down menu to expand its list of options.
- Next, click the Account option. Alternatively, you can use this direct link.
- On the resulting page and in the Authentication section, click the Setup button for the Google Auth setting.
- After being redirected to the Google Auth flow, Google will ask you to confirm the email address you want to use to log in. Choose the email address that you have set up for your Mailgun account.
- Once finished, Google will redirect you back to the Mailgun Control Panel.
Logging into Mailgun 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:
Disabling Google Authentication within Mailgun
We'll show you how to do this below:
- First, log in to the Mailgun Control Panel (if you have not already done so).
- Then, at the top-right corner of the page, click the Profile drop-down menu to expand its list of options.
- Next, click the Account option. Alternatively, you can use this direct link.
- On the resulting page and in the Authentication section, click the Disable button for the Google Auth setting.
Enforcing Google Authentication for all account users
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. We'll show you how to do this below:
- First, log in to the Mailgun Control Panel (if you have not already done so).
- Then, at the top-right corner of the page, click the Profile drop-down menu to expand its list of options.
- Next, click the Account option. Alternatively, you can use this direct link.
- On the resulting page and in the Account settings section, click the Require Google button for the Force User Auth Scheme setting.
After clicking 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 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.
**Note: 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.
**Note: Google authentication does not support "plus addressing", i.e. user+extra@domain.com.
Need Support?
Our Support Team here at Sinch Mailgun is happy to help! Reach out to us in the Support page of your Mailgun Control Panel, and we'll be with you shortly!