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
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.
- Select the object that have been wrongly marked as outstanding.
-
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
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
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