Identity Manager 8.1.5 - Administration Guide for Connecting to G Suite

If G Suite is synchronized with the One Identity Manager database shortly after provisioning new user accounts, these user accounts might be marked as outstanding in One Identity Manager (or deleted, depending on the configuration of the synchronization). This error only occurs if a scope has been defined in the synchronization project for the target system.

Probable reason

Adding new user account in G Suite takes about 24 hours. If synchronization with the One Identity Manager database is started within these 24 hours, the error described can occur.

Solution

To prevent this error

Avoid declaring a scope for this target system.

If a scope is required

Configure the user account synchronization so that objects that do not exist in One Identity Manager are marked as outstanding.
If the error occurs, run a target system comparison.

For more information, see Post-processing outstanding objects.
1. Select the object that have been wrongly marked as outstanding.
2. Apply the Reset method.
  
  This removes the Outstanding mark. the next time synchronization is run, the error should not occur.

For more detailed information about defining a scope and specifying handling methods for synchronization steps, see the One Identity Manager Target System Synchronization Reference Guide.

Configuration parameters for managing G Suite

The following configuration parameters are additionally available in One Identity Manager after the module has been installed.

Table 49: Configuration parameters for synchronizing G Suite
Configuration parameter	Meaning if Set
TargetSystem \| GoogleApps	Preprocessor relevant configuration parameter for controlling the database model components for the administration of the target system G Suite. If the parameter is set, the target system components are available. Changes to this parameter require the database to be recompiled.
TargetSystem \| GoogleApps \| Accounts	Parameter for configuring G Suite user account data.
TargetSystem \| GoogleApps \| Accounts \| InitialRandomPassword	This configuration parameter specifies whether a random generated password is issued when a new user account is added. The password must contain at least those character sets that are defined in the password policy.
TargetSystem \| GoogleApps \| Accounts \| InitialRandomPassword \| SendTo	Specifies to which employee the email with the random generated password should be sent (manager cost center/department/location/role, employee’s manager or XUserInserted). If no recipient can be found, the email is sent to the address stored in the configuration parameter TargetSystem \| GoogleApps \| DefaultAddress.
TargetSystem \| GoogleApps \| Accounts \| InitialRandomPassword \| SendTo \| MailTemplateAccountName	This configuration parameter contains the name of the mail template sent to provide users with the login data for their user accounts. The Employee - new user account created mail template is used.
TargetSystem \| GoogleApps \| Accounts \| InitialRandomPassword \| SendTo \| MailTemplatePassword	This configuration parameter contains the name of the mail template sent to provide users with information about their initial password. The Employee - initial password for new user account mail template is used.
TargetSystem \| GoogleApps \| Accounts \| MailTemplateDefaultValues	This configuration parameter contains the mail template used to send notifications if default IT operating data mapping values are used for automatically creating a user account. The Employee - new user account with default properties created mail template is used.
TargetSystem \| GoogleApps \| Accounts \| PrivilegedAccount	This configuration parameter allows configuration of settings for privileged user accounts.
TargetSystem \| GoogleApps \| Accounts \| TransferJPegPhoto	This configuration parameter specifies whether changes to the employee's picture are published in existing G Suite user accounts. The picture is not part of default synchronization. It is only published when employee data is changed.
TargetSystem \| GoogleApps \| DefaultAddress	The configuration parameter contains the recipient's default email address for sending notifications about actions in the target system.
TargetSystem \| GoogleApps \| MaxFullsyncDuration	This configuration parameter contains the maximum runtime for synchronization. No recalculation of group memberships by the DBQueue Processor can take place during this time. If the maximum runtime is exceeded, group membership are recalculated.
TargetSystem \| GoogleApps \| PersonAutoDefault	This configuration parameter specifies the mode for automatic employee assignment for user accounts added to the database outside synchronization.
TargetSystem \| GoogleApps \| PersonAutoDisabledAccounts	This configuration parameter specifies whether employees are automatically assigned to disabled user accounts. User accounts do not obtain an account definition.
TargetSystem \| GoogleApps \| PersonAutoFullsync	This configuration parameter specifies the mode for automatic employee assignment for user accounts added to or updated in the database through synchronization.
TargetSystem \| GoogleApps \| PersonExcludeList	List of all user accounts for which automatic employee assignment should not take place. Names are listed in a pipe (\|) delimited list that is handled as a regular search pattern.

Default project templates for G Suite

A default project template ensures that all required information is added in One Identity Manager. This includes mappings, workflows, and the synchronization base object. If you do not use a default project template you must declare the synchronization base object in One Identity Manager yourself.

Use a default project template for initially setting up the synchronization project. For custom implementations, you can extend the synchronization project with the Synchronization Editor.

The template uses mappings for the following schema types.

Table 50: Mapping G Suite schema types to tables in the One Identity Manager schema
Schema Type in G Suite	Table in the One Identity Manager Schema
AdminPrivilege	GAPPrivilege
AdminRole	GAPAdminRole
AdminRoleAssignment	GAPOrgAdminRole
Customer	GAPCustomer
Domain	GAPDomain
DomainAlias	GAPDomainAlias
Group	GAPGroup
OrgUnit	GAPOrgUnit
ProductAndSku	GAPPaSku
User	GAPUser
UserAddress	GAPUserAddress
UserEmail	GAPUserEmail
UserExternalId	GAPUserExternalId
UserIm	GAPUserIM
UserOrganization	GAPUserOrganization
UserPhone	GAPUserPhone
UserRelation	GAPUserRelation
UserWebsite	GAPUserWebSite

API scopes for the service account

The service account's client ID must be authorized for various API scopes in the Google Admin console:

For read and write access:

https://www.googleapis.com/auth/admin.directory.customer, https://www.googleapis.com/auth/admin.directory.device.chromeos, https://www.googleapis.com/auth/admin.directory.device.mobile, https://www.googleapis.com/auth/admin.directory.device.mobile.action, https://www.googleapis.com/auth/admin.directory.domain, https://www.googleapis.com/auth/admin.directory.group, https://www.googleapis.com/auth/admin.directory.group.member, https://www.googleapis.com/auth/admin.directory.notifications, https://www.googleapis.com/auth/admin.directory.orgunit, https://www.googleapis.com/auth/admin.directory.resource.calendar, https://www.googleapis.com/auth/admin.directory.rolemanagement, https://www.googleapis.com/auth/admin.directory.user, https://www.googleapis.com/auth/admin.directory.user.alias, https://www.googleapis.com/auth/admin.directory.user.security, https://www.googleapis.com/auth/admin.directory.userschema, https://www.googleapis.com/auth/apps.groups.settings, https://www.googleapis.com/auth/admin.datatransfer, https://www.googleapis.com/auth/apps.licensing

For read-only access:

https://www.googleapis.com/auth/admin.directory.customer.readonly, https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly, https://www.googleapis.com/auth/admin.directory.device.mobile.readonly, https://www.googleapis.com/auth/admin.directory.domain.readonly, https://www.googleapis.com/auth/admin.directory.group.readonly, https://www.googleapis.com/auth/admin.directory.group.member.readonly, https://www.googleapis.com/auth/admin.directory.orgunit.readonly, https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly, https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly, https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/admin.directory.user.alias.readonly, https://www.googleapis.com/auth/admin.directory.userschema.readonly, https://www.googleapis.com/auth/apps.groups.settings, https://www.googleapis.com/auth/admin.datatransfer.readonly, https://www.googleapis.com/auth/apps.licensing

Configuration parameter	Meaning if Set
TargetSystem \| GoogleApps	Preprocessor relevant configuration parameter for controlling the database model components for the administration of the target system G Suite. If the parameter is set, the target system components are available. Changes to this parameter require the database to be recompiled.
TargetSystem \| GoogleApps \| Accounts	Parameter for configuring G Suite user account data.
TargetSystem \| GoogleApps \| Accounts \| InitialRandomPassword	This configuration parameter specifies whether a random generated password is issued when a new user account is added. The password must contain at least those character sets that are defined in the password policy.
TargetSystem \| GoogleApps \| Accounts \| InitialRandomPassword \| SendTo	Specifies to which employee the email with the random generated password should be sent (manager cost center/department/location/role, employee’s manager or XUserInserted). If no recipient can be found, the email is sent to the address stored in the configuration parameter TargetSystem \| GoogleApps \| DefaultAddress.
TargetSystem \| GoogleApps \| Accounts \| InitialRandomPassword \| SendTo \| MailTemplateAccountName	This configuration parameter contains the name of the mail template sent to provide users with the login data for their user accounts. The Employee - new user account created mail template is used.
TargetSystem \| GoogleApps \| Accounts \| InitialRandomPassword \| SendTo \| MailTemplatePassword	This configuration parameter contains the name of the mail template sent to provide users with information about their initial password. The Employee - initial password for new user account mail template is used.
TargetSystem \| GoogleApps \| Accounts \| MailTemplateDefaultValues	This configuration parameter contains the mail template used to send notifications if default IT operating data mapping values are used for automatically creating a user account. The Employee - new user account with default properties created mail template is used.
TargetSystem \| GoogleApps \| Accounts \| PrivilegedAccount	This configuration parameter allows configuration of settings for privileged user accounts.
TargetSystem \| GoogleApps \| Accounts \| TransferJPegPhoto	This configuration parameter specifies whether changes to the employee's picture are published in existing G Suite user accounts. The picture is not part of default synchronization. It is only published when employee data is changed.
TargetSystem \| GoogleApps \| DefaultAddress	The configuration parameter contains the recipient's default email address for sending notifications about actions in the target system.
TargetSystem \| GoogleApps \| MaxFullsyncDuration	This configuration parameter contains the maximum runtime for synchronization. No recalculation of group memberships by the DBQueue Processor can take place during this time. If the maximum runtime is exceeded, group membership are recalculated.
TargetSystem \| GoogleApps \| PersonAutoDefault	This configuration parameter specifies the mode for automatic employee assignment for user accounts added to the database outside synchronization.
TargetSystem \| GoogleApps \| PersonAutoDisabledAccounts	This configuration parameter specifies whether employees are automatically assigned to disabled user accounts. User accounts do not obtain an account definition.
TargetSystem \| GoogleApps \| PersonAutoFullsync	This configuration parameter specifies the mode for automatic employee assignment for user accounts added to or updated in the database through synchronization.
TargetSystem \| GoogleApps \| PersonExcludeList	List of all user accounts for which automatic employee assignment should not take place. Names are listed in a pipe (\|) delimited list that is handled as a regular search pattern.

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem