Chat now with support
Chat with Support

Identity Manager 9.1.2 - Administration Guide for Connecting to Google Workspace

Mapping a Google Workspace environment in One Identity Manager Synchronizing a Google Workspace customer
Setting up initial synchronization of a Google Workspace customer Customizing the synchronization configuration for Google Workspace Running synchronization Tasks following synchronization Troubleshooting Ignoring data error in synchronization Pausing handling of target system specific processes (Offline mode)
Managing Google Workspace user accounts and employees
Account definitions for Google Workspace user accounts Assigning employees automatically to Google Workspace user accounts Manually linking employees to Google Workspace user accounts Supported user account types Specifying deferred deletion for Google Workspace user accounts
Login information for Google Workspace user accounts Managing Google Workspace entitlement assignments Mapping of Google Workspace objects in One Identity Manager
Google Workspace customers Google Workspace user accounts Google Workspace groups Google Workspace products and SKUs Google Workspace organizations Google Workspace domains Google Workspace domain aliases Google Workspace admin roles Google Workspace admin privileges Google Workspace admin role assignments Google Workspace external email addresses Reports about Google Workspace objects
Handling of Google Workspace objects in the Web Portal Basic configuration data for managing a Google Workspace customer Troubleshooting the connection to a Google Workspace customer Configuration parameters for managing a Google Workspace environment Default project template for Google Workspace API scopes for the service account Processing methods of Google Workspace system objects Special features in the assignment of Google Workspace groups

Email notifications about login data

You can configure the login information for new user accounts to be sent by email to a specified person. In this case, two messages are sent with the user name and the initial password. Mail templates are used to generate the messages. The mail text in a mail template is defined in several languages. This means the recipient’s language can be taken into account when the email is generated. Mail templates are supplied in the default installation with which you can configure the notification procedure.

The following prerequisites must be fulfilled in order to use notifications:

  • Ensure that the email notification system is configured in One Identity Manager. For more information, see the One Identity Manager Installation Guide.
  • In the Designer, set the Common | MailNotification | DefaultSender configuration parameter and enter the sender address for sending the email notifications.
  • Ensure that all employees have a default email address. Notifications are sent to this address. For more information, see the One Identity Manager Identity Management Base Module Administration Guide.
  • Ensure that a language can be determined for all employees. Only then can they receive email notifications in their own language. For more information, see the One Identity Manager Identity Management Base Module Administration Guide.

When a randomly generated password is issued for the new user account, the initial login data for a user account is sent by email to a previously specified person.

To send initial login data by email

  1. Enable the TargetSystem | GoogleApps | Accounts | InitialRandomPassword configuration parameter in the Designer.

  2. In the Designer, set the TargetSystem | GoogleApps | Accounts | InitialRandomPassword | SendTo configuration parameter and enter the notification recipient as a value.

    If no recipient can be found, the email is sent to the address stored in the TargetSystem | GoogleApps | DefaultAddress configuration parameter.

  3. In the Designer, set the TargetSystem | GoogleApps | Accounts | InitialRandomPassword | SendTo | MailTemplateAccountName configuration parameter.

    By default, the message sent uses the Employee - new user account created mail template. The message contains the name of the user account.

  4. In the Designer, set the TargetSystem | GoogleApps | Accounts | InitialRandomPassword | SendTo | MailTemplatePassword configuration parameter.

    By default, the message sent uses the Employee - initial password for new user account mail template. The message contains the initial password for the user account.

TIP: To use custom mail templates for emails of this type, change the value of the configuration parameter.

Managing Google Workspace entitlement assignments

In a customer, users can have different entitlements, which are mapped in One Identity Manager as follows:

  • Entitlement for logging in to Google Workspace

    Table: Google Workspace Products and SKUs (GAPPaSku)

  • Administrative entitlements

    Table: Google Workspace Admin role designations (GAPOrgAdminRole)

  • Entitlement for the use of Google Workspace groups

    Table: Google Workspace Groups (GAPGroup)

Entitlement assignments refer to the assignment of the various entitlements to user accounts. These include:

  • Google Workspace user accounts: assignments to products and SKUs (GAPUserInPaSku table)

  • Google Workspace user accounts: assignments to admin role designations (GAPUserInOrgAdminRole table)

  • Google Workspace user accounts: assignments to groups (GAPUserInGroup table)

  • Google Workspace groups: assignments to customers (GAPCustomerInGroup table)

In addition, external users can participate in groups as members, owners, or managers. External users are represented by an external email address and assigned to the groups.

Detailed information about this topic

Assigning Google Workspace entitlements to user accounts in One Identity Manager

In One Identity Manager, Google Workspace entitlements can be assigned directly or indirectly to employees.

In the case of indirect assignment, employees and entitlements are organized in hierarchical roles. The number of entitlements assigned to an employee is calculated from the position in the hierarchy and the direction of inheritance. If the employee has a Google Workspace user account, the entitlements are assigned to this user account.

Entitlements can also be assigned to employees through IT Shop requests. To enable the assignment of entitlements using IT Shop requests, employees are added as customers in a shop. All entitlements assigned to this shop as products can be requested by the customers. After approval is granted, requested entitlements are assigned to the employees.

You can use system roles to group entitlements together and assign them to employees as a package. You can create system roles that contain only Google Workspace entitlements. You can also group any number of company resources into a system role.

To react quickly to special requests, you can also assign the entitlements directly to user accounts.

For more information see the following guides:

Topic

Guide

Basic principles for assigning and inheriting company resources

One Identity Manager Identity Management Base Module Administration Guide

One Identity Manager Business Roles Administration Guide

Assigning company resources through IT Shop requests

One Identity Manager IT Shop Administration Guide

System roles

One Identity Manager System Roles Administration Guide

Detailed information about this topic

Prerequisites for indirect assignment of Google Workspace entitlements to Google Workspace user accounts

In the case of indirect assignment, employees and Google Workspace entitlements are assigned to hierarchical roles, such as departments, cost centers, locations, or business roles. When assigning Google Workspace entitlements indirectly, check the following settings and modify them if necessary.

  1. The assignment of employees, Google Workspace products and SKUs, Google Workspace admin role assignments, and Google Workspace groups is permitted for departments, cost centers, locations, or business roles.

    For more information, see the One Identity Manager Identity Management Base Module Administration Guide.

  2. Settings for assigning Google Workspace entitlements to Google Workspace user accounts.

    • Google Workspace user accounts are labeled with the Products and SKUs can be inherited, Admin roles assignments can be inherited, and Groups can be inherited options.

    • Google Workspace user accounts are linked with an employee through the UID_Person (Person) column.

    • Google Workspace user accounts and entitlements belong to the same customer.

NOTE: There are other configuration settings that play a role when company resources are inherited through departments, cost centers, locations, and business roles. For example, role inheritance might be blocked or inheritance of employees not allowed. For more detailed information about the basic principles for assigning company resources, see the One Identity Manager Identity Management Base Module Administration Guide.

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating