All Collections
Connectors
Gmail
Google Admin - Security Group Connection
Google Admin - Security Group Connection
Updated over a week ago

By establishing a Google Security Group connection with SigParser, your IT administrator can connect mailboxes in your organization automatically.

The mailbox owners do not need to create SigParser accounts or manually connect their mailboxes. You can add or remove mailboxes from your Google Cloud Console.

Recommended for connecting 10+ mailboxes.

To Start

  • You must have access to the following:

    • A SigParser account. Either create an account or have access to your organization’s SigParser account with the permissions needed to add users and connect mailboxes.

    • Admin access for your organization’s Google Cloud Console

    • Admin access to your organization’s Admin Center

    • A list of the email addresses you wish to connect and scan in SigParser

    • Use the instructions page in SigParser to copy/paste the necessary values.

    • If you need additional support, you can schedule a help session HERE. Have the above items configured prior to your scheduled call.

Watch the following video for additional information:


Go to SigParser

  • In your SigParser account, go to Mailboxes > +Add > Connect Mailboxes with admin > Create New Connection > Google Cloud - Security Group


Create a Google Cloud Project

    • Project name: SigParserMailboxes

    • Organization: Select your organization from the list

    • Location: Select the parent organization or folder

  • Select Create


Enable Google API Services

    • Select the SigParserMailboxes project from the drop-down menu in the top left of the page.

  • Search and enable the following APIs for the SigParserMailboxes project:

    • Gmail API

    • Google Calendar API

    • Contacts API

    • Admin SDK API

    • Google People API


Create a Google Service Account & Download JSON File

  • Go to this Google Service Account page to create a service account

  • Enter the details:

    • Service account name: SigParserServiceAccount

    • Service account description: A service account for SigParser to access data

  • Select Done (you can skip the optional steps)

  • Select the three dots on the right side of the new SigParserServiceAccount

  • Select Manage keys

  • Select Add Key > Create new key

  • Choose JSON (this will download the JSON file to your computer)

  • Select Create


Add ClientID and Scopes to Google Admin Portal

  • At the top of the screen, select Add New

  • Open the Service Account JSON file on your computer and copy the client_id value from the file

    • (the client_id value will look like a number such as 5156156156156156)

  • Paste the client_id into the Client ID textbox

  • Copy and paste the following text into the OAuth scopes textbox

https://www.googleapis.com/auth/gmail.readonly, 
https://www.googleapis.com/auth/contacts, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/calendar.events.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/admin.directory.group.member.readonly, https://www.googleapis.com/auth/admin.directory.group.readonly, https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/directory.readonly
  • Select Authorize


Copy & Paste Google JSON File Contents

  • Copy and paste all of the JSON file contents into the text box on the SigParser instructions page


Create a Google Cloud Group

  • Enter the following details:

    • Group name: SigParserMailboxes

    • Group email: sigparser

    • Group description: Mailboxes scanned by SigParser

  • Add Owner of the new group

    • Select Add Member

    • Member email: enter Google Admin email address

    • Group role: Owner

  • Add the mailboxes you want to be scanned by SigParser

    • Click Add Member button

    • Member email: email of mailbox to scanned

    • Group role: Member

  • When you have added all of your Group Members, select Save.

  • On the SigParser instructions page, select if you want group owner's mailbox to be scanned by SigParser


Enter Google Admin Email Address

  • Enter the email address of a Google Admin account for your organization (to establish connection) in the textbox on the SigParser instructions page.


Enter SigParser Group Email Address

  • Enter the email address for your SigParser Group (e.g., sigparser@yourdomain) in the textbox on the SigParser instructions page.


Name Connection

  • Add a Connection Name (e.g. SigParser Google Connection) in the textbox on the SigParser instructions page.


Create & Activate Connection

  • Select Create & Active Connection on the SigParser instructions page

  • The mailboxes will automatically start processing 90 days of history within a few hours

  • To manage your connection moving forward, go to Mailboxes and select the connection under the column “Connection.”


Connect More Mailboxes

To connect more mailboxes with this connection:

  • Select the SigParser Mailboxes group

  • Select Add Members

  • Add the mailboxes you want to connect to SigParser

  • In SigParser, go to Mailboxes > under the "Connection" column, select the Google Admin Connection

  • Select the Resync button at the top of this page

  • You should see the mailboxes added at the bottom of this page.


If you have any questions, send us an email at support@sigparser.com. You can also book a demo session HERE.

Did this answer your question?