Difference between revisions of "Retain Google Apps"

From GWAVA Technologies Training
Jump to: navigation, search
(→‎Change to Google Apps API Requiring Retain 3.5.1)
 
(33 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
 
+
==Change to Google Apps API Requiring Retain 3.5.1==
−
The Google Apps module allows Retain to archive Gmail data items from Gmail. To configure Retain for Gmail archiving, Retain needs Gmail to be configured to allow Retain access, and the appropriate information entered into Retain.
+
−
 
+
 
The Google Apps API has changed since the time that the Google Apps module was developed.  Thus, Retain 3.5 and earlier used the old API.  Retain 3.5.1 and later is using the new API.  As of April 20, 2015, the old API is being discontinued by Google, thus requiring an upgrade to Retain 3.5.1 or later.
 
The Google Apps API has changed since the time that the Google Apps module was developed.  Thus, Retain 3.5 and earlier used the old API.  Retain 3.5.1 and later is using the new API.  As of April 20, 2015, the old API is being discontinued by Google, thus requiring an upgrade to Retain 3.5.1 or later.
  
−
Here are some configuration resources for the Google Apps module:
+
 
−
* KB article with all of the instructions:  [http://support.gwava.com/kb/?View=entry&EntryID=2516 Retain 3.5.1 and the Changes to the Google Apps API]
+
−
* Training video:  [http://training.gwava.com/videos/Google_Apps_Module_Configuration_Retain351.mp4 "Retain 3.5.1 for Google Apps - Module Configuration" given by Steve Dorrough]
+
  
  
 
=====Back to [[Retain Module Configuration]]=====
 
=====Back to [[Retain Module Configuration]]=====
 +
 +
==Configuring Google Apps (GSuite) for Retain 4.x==
 +
 +
 +
You will need access to the following interfaces to setup Retain for archiving with Google Apps:
 +
 +
'''API Admin Access/IAM & Admin/Developer Console/API Manager'''
 +
 +
'''Admin Console/Google Apps Console Administration'''
 +
 +
 +
1. '''Log into Google Apps Developer Console/API Manager''':
 +
*https://console.developers.google.com/
 +
 +
 +
2. '''Create  a project'''
 +
*Click Project | New Project
 +
*Give the Project a name (Retain)
 +
 +
Give it a moment to create the project. It might take a minute.
 +
 +
Note: After the project is created it will automatically be used, and you can edit the settings. If you need to change projects, or select the project, click projects at the top and select the name of your project.
 +
 +
 +
 +
3. '''Configure Credentials, OATH, and Client ID'''
 +
*Click Menu Button (Top Left) and select API Manager
 +
*Click Credentials
 +
**Click Oath Consent Screen Tab
 +
***Enter in Email address (It is recommended to use the same account that is logged into the developer console) Copy this address. This will be used in the Retain connection to Google Apps.
 +
***Enter in Product Name: Retain
 +
***Leave everything else blank and click SAVE
 +
*Click on Credentials Tab
 +
**Select OAuth client ID
 +
***Select Web Application
 +
*Enter in Retain as the name.
 +
*In the Authorized Java Script Origins enter in: http://retainIP or hostname (Do not enter in any other URI i.e. /RetainServer)
 +
*Click Create
 +
*Copy the Client Secret
 +
*Copy the Client ID (24 digit number) (This will be used in the Authorize Domain section)
 +
 +
 +
4. '''Create a Service Account'''
 +
*Click on Menu at top left and select IAM & Admin. Select Service Accounts
 +
*Click Create Service Account
 +
**Enter in name of service account (Retain-service).
 +
**Select Role: Owner (optional)
 +
**Check the Enable G Suit Domain-wide Delegation
 +
**Click Create
 +
**Copy the Service Account ID (Must have @ symbol). (Copy this Service Account. This will be used in the Configure Retain Connection for Google Apps)
 +
 +
 +
5. '''Create P12 and Key'''
 +
*Click on Service Accounts in IAM & Admin
 +
*Click the more icon next to the Retain Service Account ID (3 vertical dots)
 +
*Select P12 and click Create. Download this file and keep it safe. (This file will need to be uploaded in the Google Apps Module in the Configure Retain connection for Google Apps)
 +
 +
 +
6. '''Enable APIs'''
 +
*Log in the developer Console | API Manager.
 +
*Click Library.
 +
*Enable the 3 APIs: calendar, gmail and Admin SDK. Simply click on them and then click Enable at the top for each.
 +
*Do not enable other APIs as that may cause issues with the Retain project.
 +
 +
 +
7. '''Authorize Domain'''
 +
*Log into the Go to the Admin Console/Google Apps: https://admin.google.com/AdminHome?hl=en
 +
*Click Security
 +
*Select Advanced Settings
 +
*Click on Manage API Client Access
 +
*Paste the 24 Digit number in Client Name
 +
*From the Retain Google Apps Module, copy the URLS into the scopes field:
 +
 +
https://mail.google.com/,https://www.googleapis.com/auth/admin.directory.group ,https://www.googleapis.com/auth/admin.directory.user ,https://www.googleapis.com/auth/gmail.readonly
 +
 +
*Click Authorize
 +
 +
==Configure Retain to Connect to Google Apps (GSuite)==
 +
 +
1. Click on configure for the Google Apps (Gsuite) Module.
 +
 +
2. Click on Settings Tab
 +
*Fill in the '''Email address of OAuth Service Account''': ''Step 4 from Configuring Google Apps (GSuite) for Retain 4.x''
 +
*'''Upload the p12 Key File''' ''Step 5 from Configuring Google Apps(Gsuite) for Retain 4.x''
 +
*Enter in the '''e-mail address''' that created the project in Google Apps: ''Step 3 from Configuring Google Apps (GSuite) for Retain 4.x''
 +
 +
3. Test connection
 +
 +
4. Save Changes

Latest revision as of 17:24, 8 May 2017

Contents

[edit] Change to Google Apps API Requiring Retain 3.5.1

The Google Apps API has changed since the time that the Google Apps module was developed. Thus, Retain 3.5 and earlier used the old API. Retain 3.5.1 and later is using the new API. As of April 20, 2015, the old API is being discontinued by Google, thus requiring an upgrade to Retain 3.5.1 or later.



[edit] Back to Retain Module Configuration

[edit] Configuring Google Apps (GSuite) for Retain 4.x

You will need access to the following interfaces to setup Retain for archiving with Google Apps:

API Admin Access/IAM & Admin/Developer Console/API Manager

Admin Console/Google Apps Console Administration


1. Log into Google Apps Developer Console/API Manager:


2. Create a project

  • Click Project | New Project
  • Give the Project a name (Retain)

Give it a moment to create the project. It might take a minute.

Note: After the project is created it will automatically be used, and you can edit the settings. If you need to change projects, or select the project, click projects at the top and select the name of your project.


3. Configure Credentials, OATH, and Client ID

  • Click Menu Button (Top Left) and select API Manager
  • Click Credentials
    • Click Oath Consent Screen Tab
      • Enter in Email address (It is recommended to use the same account that is logged into the developer console) Copy this address. This will be used in the Retain connection to Google Apps.
      • Enter in Product Name: Retain
      • Leave everything else blank and click SAVE
  • Click on Credentials Tab
    • Select OAuth client ID
      • Select Web Application
  • Enter in Retain as the name.
  • In the Authorized Java Script Origins enter in: http://retainIP or hostname (Do not enter in any other URI i.e. /RetainServer)
  • Click Create
  • Copy the Client Secret
  • Copy the Client ID (24 digit number) (This will be used in the Authorize Domain section)


4. Create a Service Account

  • Click on Menu at top left and select IAM & Admin. Select Service Accounts
  • Click Create Service Account
    • Enter in name of service account (Retain-service).
    • Select Role: Owner (optional)
    • Check the Enable G Suit Domain-wide Delegation
    • Click Create
    • Copy the Service Account ID (Must have @ symbol). (Copy this Service Account. This will be used in the Configure Retain Connection for Google Apps)


5. Create P12 and Key

  • Click on Service Accounts in IAM & Admin
  • Click the more icon next to the Retain Service Account ID (3 vertical dots)
  • Select P12 and click Create. Download this file and keep it safe. (This file will need to be uploaded in the Google Apps Module in the Configure Retain connection for Google Apps)


6. Enable APIs

  • Log in the developer Console | API Manager.
  • Click Library.
  • Enable the 3 APIs: calendar, gmail and Admin SDK. Simply click on them and then click Enable at the top for each.
  • Do not enable other APIs as that may cause issues with the Retain project.


7. Authorize Domain

  • Log into the Go to the Admin Console/Google Apps: https://admin.google.com/AdminHome?hl=en
  • Click Security
  • Select Advanced Settings
  • Click on Manage API Client Access
  • Paste the 24 Digit number in Client Name
  • From the Retain Google Apps Module, copy the URLS into the scopes field:

https://mail.google.com/,https://www.googleapis.com/auth/admin.directory.group ,https://www.googleapis.com/auth/admin.directory.user ,https://www.googleapis.com/auth/gmail.readonly

  • Click Authorize

[edit] Configure Retain to Connect to Google Apps (GSuite)

1. Click on configure for the Google Apps (Gsuite) Module.

2. Click on Settings Tab

  • Fill in the Email address of OAuth Service Account: Step 4 from Configuring Google Apps (GSuite) for Retain 4.x
  • Upload the p12 Key File Step 5 from Configuring Google Apps(Gsuite) for Retain 4.x
  • Enter in the e-mail address that created the project in Google Apps: Step 3 from Configuring Google Apps (GSuite) for Retain 4.x

3. Test connection

4. Save Changes

Retrieved from "https://traininggwava.microfocus.net/index.php?title=Retain_Google_Apps&oldid=314330"
Personal tools
Namespaces

Variants
Actions
Home
Exchange
GroupWise
JAVA
Linux
MTK
Retain
GW Monitoring and Reporting (Redline)
GW Disaster Recovery (Reload)
GW Forensics (Reveal)
GWAVA
Secure Messaging Gateway
GW Mailbox Management (Vertigo)
Windows
Other
User Experience
Toolbox
Languages
Toolbox