Fortinet Document Library

Version:

Version:

Version:

Version:

Version:

Version:

Version:

Version:


Table of Contents

External Systems Configuration Guide

Google Apps Audit

What is Discovered and Monitored

Protocol Logs Collected Used For
Google Apps Admin SDK Configuration Change, Account Create/Delete/Modify, Account Group Create/Delete/Modify, Document Create/Delete/Modify/Download, Document Permission Change, Logon Success, Logon Failure, Device compromise Security Monitoring

Event Types

In ADMIN > Device Support > Event, search for "Google_Apps" in the Search column to see the event types associated with this device.

Reports

There are many reports defined in Resource > Reports > Device > Application > Document Mgmt. Search for " Google Apps".

Configuration

Create a Google App Credential in Google API Console
  1. Logon to Google API Console (https://console.developers.google.com).
  2. Open the Select a project window and click NEW PROJECT.

  3. Under the New Project window:
    1. Project Name - enter a name.
    2. Click Create.
  4. Open the Select a project window and select the new project that you created in Step 2.
  5. Under Dashboard, click Enable API And Services to find the Admin SDK.
  6. Select Admin SDK and click Enable to activate the Admin SDK for this project.
  7. Create a Service Account for this project:
    1. Under Credentials, click Create Credentials > Service Account.
    2. Enter the server account name.
    3. Click Create.
    4. Choose Role as Project > Viewer.
    5. Click Continue>Done.
  8. Create key for the Service Account:
    1. Go to Navigation Menu> IAM &Admin>Service Accounts.
    2. Go to the Service Account table, choose the service account you create in Step 7.
    3. Click Actions > Create Key.
    4. Choose Key type as JSON.
    5. Click Create
    6. A JSON file containing the Service Account credentials will be stored in your computer.
  9. Enable Google Apps Domain-wide delegation:
    1. Go to Navigation Menu> IAM &Admin>Service Accounts
    2. Go to the Service Account table and choose the service account you created in Step 7.
    3. Click Actions > Edit > SHOW DOMAIN-WIDE DELEGATION.
    4. Check Enable G Suite Domain-wide Delegation.
    5. Enter FortiSIEM in the Product name for the consent screen.
    6. Click Save.
  10. View Client ID:
    1. Go to Navigation Menu> IAM &Admin>Service Accounts.
    2. Go to the Service Account table and choose the service account you created in Step 7.
    3. Click Actions > Edit > SHOW DOMAIN-WIDE DELEGATION.
    4. You can find a Client ID.
  11. Delegate domain-wide authority to the service account created in Step 7.
    1. Go to your Google Apps domain’s Admin console (https://admin.google.com).
    2. Select Security from the list of controls. If you don't see Security listed, select More controls from the gray bar at the bottom of the page, then select Security from the list of controls.
    3. Select Advanced settings from the list of options.
    4. Click Manage domain wide delegation in the Domain wide delegation section.
    5. Click Add new.
    6. In the Client ID field, enter the service account's Client ID you obtained in Step 10d.
    7. In the OAuth scopes(comma-delimited) field, enter the following scope that FortiSEM should be granted access to:

      https://www.googleapis.com/auth/admin.reports.audit.readonly

    8. Click Authorize.
Define Google App Credential in FortiSIEM
  1. Log in to FortiSIEM Supervisor node.
  2. Go to Admin > Setup > Credentials.
  3. In Step 1, Click Add to create a new credential.
  4. For Device Type, select Google Google Apps.
  5. For Access Protocol, select  Google Apps Admin SDK.
  6. Enter the User Name (this is the account name to log in to the Admin console).
  7. For Service Account Key, upload the JSON credential file (see Step 8f in Create a Google App Credential in Google API Console).
  8. Click Save.
Test Connectivity
  1. Log in to the FortiSIEM Supervisor node.
  2. Go to Admin > Setup > Credentials.
  3. In Step 2, Click Add to create a new association.
  4. For Name/IP/IP Range, enter google.com.
  5. For Credentials, enter the name of the credential created in Define Google App Credential in FortiSIEM.
  6. Click Save.
  7. Select the entry just created and click Test Connectivity without Ping. A pop up will appear and show the Test Connectivity results.
  8. Go to Admin > Setup > Pull Events and make sure an entry is created for Google Audit Log Collection.

Sample Events for Google Apps Audit

Logon Success

<134>Jan 21 19:29:21 google.com java: [Google_Apps_login_login_success]:[eventSeverity]=PHL_INFO,[actor.profileId]=117858279951236905887,[id.time]=2016-09-09T06:53:58.000Z,[id.applicationName]=login,[kind]=admin#reports#activity,[id.customerId]=C01lzy8ye,[id.uniqueQualifier]=8830301951515521023,[event.parameters.login_type]=google_password,[event.type]=login,[ipAddress]=45.79.100.103,[actor.email]=api1@accelops.net,[event.name]=login_success,[etag]=""6KGrH_UY2JDZNpgjPKUOF8yJF1A/Nfrg2SFjlC2gR6pJtpP2scVidmc""",Google_Apps_login_login_success,login_success,1,45.79.100.103,
Logon Failure

<134>Jan 21 19:29:21 google.com java: [Google_Apps_login_login_failure]:

[eventSeverity]=PHL_INFO,[actor.profileId]=117858279951236905887,

[id.applicationName]=login,[kind]=admin#reports#activity,[event.parameters.login_

type]=google_password,[ipAddress]=45.79.100.103,[event.name]=login_failure,[id.time]=2016-

09-19T09:27:51.000Z,[id.customerId]=C01lzy8ye,[id.uniqueQualifier]=4795688196368428241,

[event.type]=login,[actor.email]=api1@accelops.net,[etag]=""6KGrH_

UY2JDZNpgjPKUOF8yJF1A/v5zsUPNoEdXLLK79zQpBcuxNbQU"",[event.parameters.login_failure_

type]=login_failure_invalid_password",Google_Apps_login_login_failure,login_

failure,1,45.79.100.103,

Create User

<134>Jan 21 19:29:20 google.com java: [Google_Apps_USER_SETTINGS_CREATE_USER]:

[eventSeverity]=PHL_INFO,[actor.callerType]=USER,[actor.profileId]=117858279951236905887,

[id.applicationName]=admin,[kind]=admin#reports#activity,[ipAddress]=45.79.100.103,

[event.name]=CREATE_USER,[id.time]=2016-09-19T09:22:44.646Z,[id.customerId]=C01lzy8ye,

[id.uniqueQualifier]=-8133102622954793216,[event.type]=USER_SETTINGS,

[event.parameters.USER_EMAIL]=test-user@accelops.org,[actor.email]=api1@accelops.net,

[etag]=""6KGrH_UY2JDZNpgjPKUOF8yJF1A/R5GJyWG9YHSiGRvo3-8ZBM0ZlL0""",Google_Apps_USER_

SETTINGS_CREATE_USER,CREATE_USER,1,45.79.100.103,

Delete user

 <134>Jan 21 19:29:20 google.com java: [Google_Apps_USER_SETTINGS_DELETE_USER]:[eventSeverity]=PHL_INFO,[actor.callerType]=USER,[actor.profileId]=117858279951236905887,[id.applicationName]=admin,[kind]=admin#reports#activity,[ipAddress]=45.79.100.103,[event.name]=DELETE_USER,[id.time]=2016-09-19T09:22:28.582Z,[id.customerId]=C01lzy8ye,[id.uniqueQualifier]=-4630441819990099585,[event.type]=USER_SETTINGS,[event.parameters.USER_EMAIL]=test-user@accelops.org,[actor.email]=api1@accelops.net,[etag]=""6KGrH_UY2JDZNpgjPKUOF8yJF1A/08MaodxPU6Zv7s6vJtuUQW9ugx0""",Google_Apps_USER_SETTINGS_DELETE_USER,DELETE_USER,1,45.79.100.103,   
Move user settings

<134>Jan 21 19:29:20 google.com java: [Google_Apps_USER_SETTINGS_MOVE_USER_TO_ORG_UNIT]:[eventSeverity]=PHL_INFO,[actor.callerType]=USER,[actor.profileId]=117858279951236905887,[event.parameters.ORG_UNIT_NAME]=/test,[id.applicationName]=admin,[kind]=admin#reports#activity,[ipAddress]=45.79.100.103,[event.name]=MOVE_USER_TO_ORG_UNIT,[id.time]=2016-09-19T09:24:25.285Z,[id.customerId]=C01lzy8ye,[id.uniqueQualifier]=-6704816947489240452,[event.type]=USER_SETTINGS,[event.parameters.USER_EMAIL]=test-user@accelops.org,[actor.email]=api1@accelops.net,[event.parameters.NEW_VALUE]=/,[etag]=""6KGrH_UY2JDZNpgjPKUOF8yJF1A/r1v9DiPZbL06fXFFjJlrWf2s3qI""",Google_Apps_USER_SETTINGS_MOVE_USER_TO_ORG_UNIT,MOVE_USER_TO_ORG_UNIT,1,45.79.100.103,,    

Google Apps Audit

What is Discovered and Monitored

Protocol Logs Collected Used For
Google Apps Admin SDK Configuration Change, Account Create/Delete/Modify, Account Group Create/Delete/Modify, Document Create/Delete/Modify/Download, Document Permission Change, Logon Success, Logon Failure, Device compromise Security Monitoring

Event Types

In ADMIN > Device Support > Event, search for "Google_Apps" in the Search column to see the event types associated with this device.

Reports

There are many reports defined in Resource > Reports > Device > Application > Document Mgmt. Search for " Google Apps".

Configuration

Create a Google App Credential in Google API Console
  1. Logon to Google API Console (https://console.developers.google.com).
  2. Open the Select a project window and click NEW PROJECT.

  3. Under the New Project window:
    1. Project Name - enter a name.
    2. Click Create.
  4. Open the Select a project window and select the new project that you created in Step 2.
  5. Under Dashboard, click Enable API And Services to find the Admin SDK.
  6. Select Admin SDK and click Enable to activate the Admin SDK for this project.
  7. Create a Service Account for this project:
    1. Under Credentials, click Create Credentials > Service Account.
    2. Enter the server account name.
    3. Click Create.
    4. Choose Role as Project > Viewer.
    5. Click Continue>Done.
  8. Create key for the Service Account:
    1. Go to Navigation Menu> IAM &Admin>Service Accounts.
    2. Go to the Service Account table, choose the service account you create in Step 7.
    3. Click Actions > Create Key.
    4. Choose Key type as JSON.
    5. Click Create
    6. A JSON file containing the Service Account credentials will be stored in your computer.
  9. Enable Google Apps Domain-wide delegation:
    1. Go to Navigation Menu> IAM &Admin>Service Accounts
    2. Go to the Service Account table and choose the service account you created in Step 7.
    3. Click Actions > Edit > SHOW DOMAIN-WIDE DELEGATION.
    4. Check Enable G Suite Domain-wide Delegation.
    5. Enter FortiSIEM in the Product name for the consent screen.
    6. Click Save.
  10. View Client ID:
    1. Go to Navigation Menu> IAM &Admin>Service Accounts.
    2. Go to the Service Account table and choose the service account you created in Step 7.
    3. Click Actions > Edit > SHOW DOMAIN-WIDE DELEGATION.
    4. You can find a Client ID.
  11. Delegate domain-wide authority to the service account created in Step 7.
    1. Go to your Google Apps domain’s Admin console (https://admin.google.com).
    2. Select Security from the list of controls. If you don't see Security listed, select More controls from the gray bar at the bottom of the page, then select Security from the list of controls.
    3. Select Advanced settings from the list of options.
    4. Click Manage domain wide delegation in the Domain wide delegation section.
    5. Click Add new.
    6. In the Client ID field, enter the service account's Client ID you obtained in Step 10d.
    7. In the OAuth scopes(comma-delimited) field, enter the following scope that FortiSEM should be granted access to:

      https://www.googleapis.com/auth/admin.reports.audit.readonly

    8. Click Authorize.
Define Google App Credential in FortiSIEM
  1. Log in to FortiSIEM Supervisor node.
  2. Go to Admin > Setup > Credentials.
  3. In Step 1, Click Add to create a new credential.
  4. For Device Type, select Google Google Apps.
  5. For Access Protocol, select  Google Apps Admin SDK.
  6. Enter the User Name (this is the account name to log in to the Admin console).
  7. For Service Account Key, upload the JSON credential file (see Step 8f in Create a Google App Credential in Google API Console).
  8. Click Save.
Test Connectivity
  1. Log in to the FortiSIEM Supervisor node.
  2. Go to Admin > Setup > Credentials.
  3. In Step 2, Click Add to create a new association.
  4. For Name/IP/IP Range, enter google.com.
  5. For Credentials, enter the name of the credential created in Define Google App Credential in FortiSIEM.
  6. Click Save.
  7. Select the entry just created and click Test Connectivity without Ping. A pop up will appear and show the Test Connectivity results.
  8. Go to Admin > Setup > Pull Events and make sure an entry is created for Google Audit Log Collection.

Sample Events for Google Apps Audit

Logon Success

<134>Jan 21 19:29:21 google.com java: [Google_Apps_login_login_success]:[eventSeverity]=PHL_INFO,[actor.profileId]=117858279951236905887,[id.time]=2016-09-09T06:53:58.000Z,[id.applicationName]=login,[kind]=admin#reports#activity,[id.customerId]=C01lzy8ye,[id.uniqueQualifier]=8830301951515521023,[event.parameters.login_type]=google_password,[event.type]=login,[ipAddress]=45.79.100.103,[actor.email]=api1@accelops.net,[event.name]=login_success,[etag]=""6KGrH_UY2JDZNpgjPKUOF8yJF1A/Nfrg2SFjlC2gR6pJtpP2scVidmc""",Google_Apps_login_login_success,login_success,1,45.79.100.103,
Logon Failure

<134>Jan 21 19:29:21 google.com java: [Google_Apps_login_login_failure]:

[eventSeverity]=PHL_INFO,[actor.profileId]=117858279951236905887,

[id.applicationName]=login,[kind]=admin#reports#activity,[event.parameters.login_

type]=google_password,[ipAddress]=45.79.100.103,[event.name]=login_failure,[id.time]=2016-

09-19T09:27:51.000Z,[id.customerId]=C01lzy8ye,[id.uniqueQualifier]=4795688196368428241,

[event.type]=login,[actor.email]=api1@accelops.net,[etag]=""6KGrH_

UY2JDZNpgjPKUOF8yJF1A/v5zsUPNoEdXLLK79zQpBcuxNbQU"",[event.parameters.login_failure_

type]=login_failure_invalid_password",Google_Apps_login_login_failure,login_

failure,1,45.79.100.103,

Create User

<134>Jan 21 19:29:20 google.com java: [Google_Apps_USER_SETTINGS_CREATE_USER]:

[eventSeverity]=PHL_INFO,[actor.callerType]=USER,[actor.profileId]=117858279951236905887,

[id.applicationName]=admin,[kind]=admin#reports#activity,[ipAddress]=45.79.100.103,

[event.name]=CREATE_USER,[id.time]=2016-09-19T09:22:44.646Z,[id.customerId]=C01lzy8ye,

[id.uniqueQualifier]=-8133102622954793216,[event.type]=USER_SETTINGS,

[event.parameters.USER_EMAIL]=test-user@accelops.org,[actor.email]=api1@accelops.net,

[etag]=""6KGrH_UY2JDZNpgjPKUOF8yJF1A/R5GJyWG9YHSiGRvo3-8ZBM0ZlL0""",Google_Apps_USER_

SETTINGS_CREATE_USER,CREATE_USER,1,45.79.100.103,

Delete user

 <134>Jan 21 19:29:20 google.com java: [Google_Apps_USER_SETTINGS_DELETE_USER]:[eventSeverity]=PHL_INFO,[actor.callerType]=USER,[actor.profileId]=117858279951236905887,[id.applicationName]=admin,[kind]=admin#reports#activity,[ipAddress]=45.79.100.103,[event.name]=DELETE_USER,[id.time]=2016-09-19T09:22:28.582Z,[id.customerId]=C01lzy8ye,[id.uniqueQualifier]=-4630441819990099585,[event.type]=USER_SETTINGS,[event.parameters.USER_EMAIL]=test-user@accelops.org,[actor.email]=api1@accelops.net,[etag]=""6KGrH_UY2JDZNpgjPKUOF8yJF1A/08MaodxPU6Zv7s6vJtuUQW9ugx0""",Google_Apps_USER_SETTINGS_DELETE_USER,DELETE_USER,1,45.79.100.103,   
Move user settings

<134>Jan 21 19:29:20 google.com java: [Google_Apps_USER_SETTINGS_MOVE_USER_TO_ORG_UNIT]:[eventSeverity]=PHL_INFO,[actor.callerType]=USER,[actor.profileId]=117858279951236905887,[event.parameters.ORG_UNIT_NAME]=/test,[id.applicationName]=admin,[kind]=admin#reports#activity,[ipAddress]=45.79.100.103,[event.name]=MOVE_USER_TO_ORG_UNIT,[id.time]=2016-09-19T09:24:25.285Z,[id.customerId]=C01lzy8ye,[id.uniqueQualifier]=-6704816947489240452,[event.type]=USER_SETTINGS,[event.parameters.USER_EMAIL]=test-user@accelops.org,[actor.email]=api1@accelops.net,[event.parameters.NEW_VALUE]=/,[etag]=""6KGrH_UY2JDZNpgjPKUOF8yJF1A/r1v9DiPZbL06fXFFjJlrWf2s3qI""",Google_Apps_USER_SETTINGS_MOVE_USER_TO_ORG_UNIT,MOVE_USER_TO_ORG_UNIT,1,45.79.100.103,,