Preparing a Google Workspace for Jamf Pro SMTP Integration

Technical Articles
Solution
Application
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US

Integrating your Google-hosted email infrastructure with Jamf Pro requires the creation of a unique client ID and client secret in your Google Workspace portal. This article explains the basic steps of creating a new project in your Google Workspace and creating the client ID and client secret to configure the SMTP server settings in Jamf Pro.

Requirements

  • Google Workspace edition that includes Gmail services (i.e., Enterprise, Business, or Education)

  • A new or existing Gmail account associated with your Google Workspace

  1. Log in to https://developers.google.com/identity/oauth2/web/guides/get-google-api-clientid and click Configure a project.
  2. Follow the on-screen instructions to create a new project.
    1. In the Enter a project name field, enter Jamf Pro SMTP.
    2. In the Product name field, enter Jamf Pro.
    3. Select "Web server" from the Where are you calling from pop-up menu.
    4. Enter https://JAMF_PRO_URL.jamfcloud.com/view/settings/system-settings/smtp-server in the Authorized redirect URIs field, replacing https://JAMF_PRO_URL.jamfcloud.com with your Jamf Pro URL.
  3. After you create the project, click DOWNLOAD CLIENT CONFIGURATION.
    The downloaded file is in JSON format and includes both the client ID and client secret, as well as the redirect URI.
    Example:

    { "web":

    { "client_id": "507012189251-l0t60ofka8icptnm5ic3s48s3ffrpvil.apps.googleusercontent.com"

    "project_id": "jamf-pro-smtp-pr-1722035286849"

    "auth_uri": "https://accounts.google.com/o/oauth2/auth"

    "token_uri": "https://oauth2.googleapis.com/token"

    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs"

    "client_secret": "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"

    "redirect_uris": [ "https://example.jamfcloud.com/view/settings/system-settings/smtp-server" ] }}

  4. From the same page where you downloaded the client configuration, click API Console at the bottom-right to access the API library.
  5. Click ENABLE APIS AND SERVICES.
  6. Use the search bar at the top of the page to search for Gmail API.
  7. Select Gmail API from the list of results.
  8. Click Enable.

You can now use the client ID and client secret to configure SMTP server settings in Jamf Pro for Google Authentication. For more information, see SMTP Server Integration in the Jamf Pro Documentation.