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:
- 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. - On the resulting page, you will see various groups, or sections, of settings. In the
Authentication
section, locate theGoogle Auth
field. - Click the light grey
Setup
button, and Mailgun will redirect you to the Google Auth flow. - 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).
- 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:
Disabling Google Authentication within Mailgun
Follow the steps below to disable Google Authentication for your user on Mailgun:
- 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. - On the resulting page, you will see various groups, or sections, of settings. In the
Authentication
section, locate theGoogle Auth
field. - Click the light grey
Disable
button to remove the Google Auth flow.
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.