Chat now with support
Chat with Support

Identity Manager 8.0 - Administration Guide for Connecting to G Suite

Managing G Suite Setting Up G Suite Synchronization Base Data for Managing G Suite Troubleshooting Appendix: Configuration Parameter for Managing G Suite Appendix: Default Project Templates for G Suite Appendix: Editing System Objects

Updating Schemas

Updating Schemas

All the schema data (schema types and schema properties) of the target system schema and the One Identity Manager schema are available when you are editing a synchronization project. Only a part of this data is really needed for configuring synchronization. If a synchronization project is finished, the schema is compressed to remove unnecessary data from the synchronization project. This can speed up loading the synchronization project. Deleted schema data can be added to the synchronization configuration again at a later point.

If the target system schema or the One Identity Manager schema has changed, these changes must also be added to the synchronization configuration. Then the changes can be added to the schema property mapping.

To include schema data that have been deleted through compressing and schema modifications in the synchronization project, update each schema in the synchronization project. This may be necessary if:

  • A schema was changed by:
    • Changes to a target system schema
    • Customizations to the One Identity Manager schema
    • A One Identity Manager update migration
  • A schema in the synchronization project was shrunk by:
    • Activating the synchronization project
    • Synchronization projectClosed initial save
    • Compressing a schema

To update a system connection schema

  1. Select the category Configuration | Target system.

    - OR -

    Select the category

    Configuration | One Identity Manager connection.

  2. Select the view General and click Update schema.
  3. Confirm the security prompt with Yes.

    This reloads the schema data.

To edit a mapping

  1. Open the synchronization project in the Synchronization EditorClosed.

  2. Select the category Mappings.
  3. Select a mapping in the navigation view.

    Opens the MappingClosed Editor. For more detailed information about editing mappings, see One Identity Manager Target SystemClosed SynchronizationClosed Reference Guide.

NOTE: The synchronization is deactivated if the schema of an activated synchronization project is updated. Reactivate the synchronization project to synchronize.

Target System Connection Advanced Settings

Target System Connection Advanced Settings

You can make various additional changes to the target system connection settings, for example, defining the number of retries or timeouts. When you set up synchronization for the first time, these system connection properties are set to default values. You can modify the default values to help analysis of synchronization problems, for example.

There are two ways to change the default values.

  1. Specify a specialized variable set and change the values of the affected variables.

    The default values remain untouched in the default variable set. The variables can be reset to the default values at any time. - Recommended action

    For more information, see Editing Connection Parameters in Variable Sets.

  2. Edit the target system connection with the system connection wizard and change the effected values.

    The system connection wizard supplies additional explanations of the settings. However the default values get overwritten and you cannot reset them.

    For more information, see Editing Target System Connection Properties.

NOTE: If the project wizard is started directly from the Synchronization EditorClosed when you set up initial synchronization, you can edit the advanced settings when you set up the synchronization project. In this case, the default values are immediately overwritten by your settings.
Table 10: Target System Connection Advanced Settings

Property

Description

Use the local cache

Specifies whether the G Suite connector's local cache is used.

Local cache is used to prevent the API contingent from being exceeded through synchronization. Accesses to G Suite are minimized during full synchronization. The option is ignored during provisioning.

This option is set by default and can be disabled for troubleshooting.

For more detailed information, see the .One Identity Manager Target SystemClosed SynchronizationClosed Reference Guide

Polling count

Specifies how many attempts are made to load a new value into the target system during provisioning or synchronization before an error occurs.

The result of saving certain user account properties (such as phone numbers or Instant Messenger settings) appears after a delay in G Suite and cannot be used for other operations straightaway.

Batch retry count

Specifies the number of retries allowed for failed batch operations in the target system, for example, when synchronizing group memberships.

Batch timeout

Timeout between retries of failed batch operations.

Products and SKUs XML

Product IDs and Stock keeping unit IDs as XML file.

The list of available products and SKUs is defined by Google and therefore fixed in the G Suite connector. If Google changes this list, you can enter an XML file here, which overwrites the list in the G Suite connector.

Example:

<products>

<product name="G Suite" id="Google-Apps">

<sku id="Google-Apps-Unlimited" name="G Suite Business"/>

<sku id="Google-Apps-For-Business" name="G Suite Basic" />

<sku id="Google-Apps-Lite" name="G Suite Lite"/>

<sku id="Google-Apps-For-Postini" name="Google Apps Message Security"/>

</product>

<product name="Google Drive storage" id="Google-Drive-storage">

<sku id="Google-Drive-storage-20GB" name="Google Drive storage 20 GB"/>

<sku id="Google-Drive-storage-50GB" name="Google Drive storage 50 GB"/>

<...>

<sku id="Google-Drive-storage-16TB" name="Google Drive storage 16 TB"/>

</product>

<...>

</products>

Editing Connection Parameters in Variable Sets

Editing Connection Parameters in Variable Sets

The connection parameters for advanced settings were saved as variables when synchronization was set up. You can change the values in these variables to suit you requirements and assign the variable set to a start up configuration and a base object. This means that you always have the option to user default values from the default variable set.

NOTE: To guarantee data consistency in the connected target system, ensure that the start up configuration for synchronization and the base object for provisioning use the same variable set. This especially applies if a synchronization project for synchronization use different customers.

To modify advanced settings in a specialized variable set

  1. Open the synchronization project in the Synchronization EditorClosed.

  2. Select the category Configuration | Target systems.
  3. Open the Connection parameters view.
  4. Select one of the following parameters and click Convert.
    Table 11: Variables for Advanced System Connection Settings

    Parameter

    Description

    Polling count

    Specifies how many attempts are made to load a new value into the target system during provisioning or synchronization before an error occurs.

    Batch retry count

    Specifies the number of retries allowed for failed batch operations in the target system, for example, when synchronizing group memberships.

    Batch timeout

    Timeout between retries of failed batch operations.

    Cache

    Specifies whether the local G Suite cache is used.

    For more information, see Target System Connection Advanced Settings.

  5. Select the category Configuration | Variables.

    All specialized variable sets are shown in the lower part of the document view.

  6. Select a specialized variable set or click on in the variable set view's toolbar .
    • To rename a variable set, mark the variable and click in the variable set view's toolbar. Enter a name for the variable set.
  7. Select the previously added variable and enter a new value.

  8. Select the category Configuration | Start up configurations.
  9. Select a start up configuration and click Edit....
  10. Select the General tab.
  11. Select the specialized variable set in the Variable setClosed menu.
  12. Select the category Configuration | Base objects.
  13. Select the base object and click .

    - OR -

    Click to add a new base object.

  14. Select the specialized variable set in the Variable set menu.
  15. Save the changes.

For detailed information about using variables and variables sets or about restoring default values and adding base objects, see the One Identity Manager Target SystemClosed SynchronizationClosed Reference Guide.

Editing Target System Connection Properties

Editing Target System Connection Properties

You can also change the target system connection's advanced properties with the system connection wizard. In the process, the values you set here are transferred to the default variable set. The original default values cannot, therefore, be restored again.

To edit advanced settings with the system connection wizard

  1. Open the synchronization project in the Synchronization EditorClosed.

  2. Select the category Configuration | Target systems.
  3. Click Edit connection....

    This starts the system connection wizard.

  4. Enable Show advanced settings on the system connection wizard's start page.
  5. Customize the properties as required on the Advanced settings page.

    For more information, see Target System Connection Advanced Settings.

  6. Save the changes.
Related Documents