Email notifications about login data
You can configure the login credentials 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 identities 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 identities. 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 identity.
To send initial login data by email
-
Enable the TargetSystem | GoogleApps | Accounts | InitialRandomPassword configuration parameter in the Designer.
-
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.
-
In the Designer, set the TargetSystem | GoogleApps | Accounts | InitialRandomPassword | SendTo | MailTemplateAccountName configuration parameter.
By default, the message sent uses the mail template Identity - new user account created. The message contains the name of the user account.
-
In the Designer, set the TargetSystem | GoogleApps | Accounts | InitialRandomPassword | SendTo | MailTemplatePassword configuration parameter.
By default, the message sent uses the mail template Identity - initial password for new user account. 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 assignments (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 assignments (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 identities.
In the case of indirect assignment, identities and entitlements are organized in hierarchical roles. The number of entitlements assigned to an identity is calculated from the position in the hierarchy and the direction of inheritance. If the identity has a Google Workspace user account, the entitlements are assigned to this user account.
Entitlements can also be assigned to identities through IT Shop requests. To enable the assignment of entitlements using IT Shop requests, identities 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 identities.
You can use system roles to group entitlements together and assign them to identities 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:
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, identities 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.
-
The assignment of identities, 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.
To configure assignments to roles of a role class
-
In the Manager, select role classes in the Organizations > Basic configuration data > Role classes category.
- OR -
In the Manager, select role classes in the Business roles > Basic configuration data > Role classes category.
-
Select the Configure role assignments task and configure the permitted assignments.
-
To generally allow an assignment, enable the Assignments allowed column.
-
To allow direct assignment, enable the Direct assignments permitted column.
- Save the changes.
-
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 identity 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 identities 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