G Suite Driver 4.2.2.3

Date: 06/20/2023

Updated: 06/20/2023

Driver Documentation: G Suite Driver Documentation 4.2.0.0

IMPORTANT NOTE: If updating from version 4.2.0.0, no changes are needed to APIs, scopes, or any OAuth area. The only change that is needed is the new ctgmailshim.jar. Otherwise, this version of the G-Suite driver requires changes to the attached G-Suite domain’s list of enabled APIs and authorized API scopes. If updating an existing driver to this version, it is vital that the connected domain(s) be updated or the driver will fail to operate. The changes necessary are detailed in the G-Suite Driver 4.1.3.x OAuth Update guide. For new installations, follow the instructions in the driver documentation.

Please note that some dependencies have been moved to an optional dependencies archive. These dependencies are provided by IDM, however, some versions of IDM may not have the libraries at a sufficient level for the driver to run. If necessary, update the dependencies from the optional dependencies archive. Do not update them if they are already present at the same or higher version level as those in the archive.

G-Suite Driver 4.2.2.3
Created by Michael Weaver
Date: 06/20/2023
Updated: 06/20/2023
Download: G-Suite Driver 4.2.2.3 Release
Release Notes
Concensus Technologies G Suite Driver 4.2.2.3 Patch
Build 4.2.2.3

Release Notes Updates:

This is a patch update for the 4.2.x.x releases. This will take the driver build version to 4.2.2.3. You must have the CT G Suite Driver 4.2.0.0 or newer to apply this patch.
This patch contains the following changes:

1. Handles Google API service change in photo modification which was causing errors when attempting to remove a photo when the user did not have one. (GADRIVER-398)

2. Updated deprecated data type initialization code to align with newer JVM versions (GADRIVER-404)

3. Improved Google API client error handling and reconnection behavior (GADRIVER-405)

Copy all jar files from this patch to your IDM server's DirXML class path location.

PATCHES THIS PATCH SUPERSEDES

All Prior Versions including:
4.2.0.0
4.2.0.1
4.2.0.2
4.2.1.0
4.2.2.0
4.2.2.1
4.2.2.2

ABSTRACT

Patch for the Concensus Technologies Identity Manager G Suite Driver. This will take the G-Suite Driver build version to 4.2.2.3. You must have G-Suite Driver 4.2.x.x or later to
upgrade successfully to this patch level.

DETAILS

IMPORTANT: This update MAY require changes to the G Suite enabled APIs and authorized scopes. Please see this guide on how to do the update, if necessary:
G Suite Driver 4.2 OAuth Update

If already at a version 4.2.x.x build, the OAuth and G Suite API update is not required.

Overview: This is a patch for the Google Apps Driver.

This patch requires the CT G Suite driver version 4.2.0.0 or higher to work.

System Requirements: Novell Identity Manager 4.8or higher.
Files provided with this update (with MD5 sum):
ed448347fc0104034aa14c8189bf37de *commons-logging-1.1.1.jar
c5aa55c0b0d350f05f670a19a4f09259 *ctgmailshim.jar
dd039e50118adb2f8542d34341351b3e *DirectoryScopes.txt
517c607196bebc0adf5cdb26fec27cd2 *gdata-appsforyourdomain-1.0.jar
3f2292058cda93293052c162512b27ed *gdata-appsforyourdomain-meta-1.0.jar
2b5ae2c5542606c442b6c4d729d0b658 *gdata-base-1.0.jar
cd00dc4999d7813f16401582dd93a948 *gdata-client-1.0.jar
bfe3dff20944012d465faa4a28e123d6 *gdata-client-meta-1.0.jar
d07fc71e005171d359440f4a7222f7ad *gdata-contacts-3.0.jar
39197de58161b57bb0b862a4b31fe83f *gdata-contacts-meta-3.0.jar
c51dc9b54e15af5a7de9684cb4516bb1 *gdata-core-1.0.jar
3724eb4fd83f192bd7a6738082aaa4b8 *google-api-client-java6.jar
90f1abbbeace9963044767bf1a7adaf3 *google-api-client.jar
fc39b8362ecb614040385209bffa84e8 *google-api-services-admin-directory.jar
aa60435557b8374fae9fcc148251eb92 *google-api-services-gmail.jar
abfeed1ad975c3e6f08b819c31e323c3 *google-api-services-groupssettings.jar
b3fab879762996affd762315da019a0c *google-api-services-oauth2.jar
1d582258e6a198882a3b9bc21017ef2e *google-http-client-gson.jar
89ad7e003c21f760bec82afef1e214af *google-http-client-jackson2.jar
feb4d41ef809977d6da6915b76e94099 *google-http-client.jar
518e414cccc81ab8ffb117059b13b4d0 *google-oauth-client-java6.jar
88a3cd45e727d0c457e9e11e3c506334 *google-oauth-client-jetty.jar
1dc684593fa1e1af1d812f494081b306 *google-oauth-client.jar
df6097815738cb31fc56391553210843 *gson.jar
eae9048a7177a69881323c08c5122aa4 *guava.jar
1d5a772e400b04bb67a7ef4a0e0996d8 *jsr305-1.3.9.jar
33ec8d237cbaceeffb2c2a7f52afd79a *xercesImpl.jar

General Instructions for all hosting platforms:

Update all jar files, listed above, included in this patch to your IDM server.

Specific host details are below.

Linux:
The connector binary and accessory jar files are located in the eDirectory DirXML class library path. This path
is dependent on your install location. On Linux hosts, it is typically /opt/novell/eDirectory/lib/dirxml/classes

1. Stop all drivers

2. Stop eDirectory

3. Remove old or renamed libraries as detailed above

4. Copy provided libraries as detailed above.

5. Restart eDirectory - rcndsd restart (all drivers will restart)

Windows:
The connector binary and accessory jar files are located in the eDirectory DirXML class library path. This path
is dependent on your install location. On Windows hosts, it is typically [Install_Location]\NDS\lib or c:\netiq\eDirectory

1. Stop all drivers

2. Stop eDirectory

3. Remove old or renamed libraries as detailed above

4. Copy provided libraries as detailed above.

5. Restart the eDirectory instance- (all drivers will restart)

Remote Loader:
Remote loader driver paths are dependent on how the remote loader is installed. Locate the existing gmailshim.jar on the
remote loader host to identify the correct path.

1. Stop the remote loader instance.

2. Remove old or renamed libraries as detailed above

3. Copy provided libraries as detailed above.

4. Restart remote loader instance

TECHNICAL SUPPORT INFORMATION

Fixes made in the Concensus IDM 4.2.2.3 G-Suite Driver:

1. Handles Google API service change in photo modification which was causing errors when attempting to remove a photo when the user did not have one. (GADRIVER-398)

2. Updated deprecated data type initialization code to align with newer JVM versions (GADRIVER-404)

3. Improved Google API client error handling and reconnection behavior (GADRIVER-405)

KNOWN ISSUES

Due to apparent propogation delays within the G-Suite API services, it is not possible to set GmailSettings attribute values during user creation. Please set them at least five seconds after user creation to avoid errors from the Gmail API service.

At this time, setting values for GmailSettingsEnableIMAP and GmailSettingsEnablePOP does not appear to work. The driver can query, however modifications do not cause a change on the user object.

Prior Versions of Depdendent Libraries

This list is the known prior depdendent library filenames which need to be removed for the update:
google-api-client-1.20.0.jar
google-api-client-java6-1.20.0.jar
google-api-services-admin-directory_v1-rev53-1.20.0.jar
google-api-services-groupssettings-v1-rev54-1.20.0.jar
google-api-services-oauth2-v2-rev87-1.19.1.jar
google-http-client-1.20.0.jar
google-http-client-gson-1.20.0.jar
google-http-client-jackson2-1.20.0.jar
google-oauth-client-1.20.0.jar
google-oauth-client-java6-1.20.0.jar
google-oauth-client-jetty-1.20.0.jar
gson-2.3.1.jar
guava-11.0.2.jar

google-api-client-1.22.0.jar
google-api-client-java6-1.22.0.jar
google-api-services-admin-directory_v1-rev68-1.22.0.jar
google-api-services-groupssettings-v1-rev60-1.22.0.jar
google-api-services-oauth2-v1-rev117-1.22.0.jar
google-http-client-1.22.0.jar
google-http-client-gson-1.22.0.jar
google-http-client-jackson2-1.22.0.jar
google-oauth-client-1.22.0.jar
google-oauth-client-java6-1.22.0.jar
google-oauth-client-jetty-1.22.0.jar

google-api-client-1.25.0.jar
google-api-client-java6-1.25.0.jar
google-api-services-admin-directory_v1-rev105-1.25.0.jar
google-api-services-gmail-v1-rev105-1.25.0.jar
google-api-services-groupssettings-v1-rev77-1.25.0.jar
google-api-services-oauth2-v1-rev153-1.25.0.jar
google-http-client-1.25.0.jar
google-http-client-gson-1.25.0.jar
google-http-client-jackson2-1.25.0.jar
google-oauth-client-1.25.0.jar
google-oauth-client-java6-1.25.0.jar
google-oauth-client-jetty-1.25.0.jar
gson-2.3.1.jar
guava-27.1-android.jar