Modifying the assembly lines

Use this task to add new mappings to the assembly lines for custom attributes.

About this task

The Google Workspace Adapter uses Security Directory Integrator to process requests before you submit them to Google Workspace.

The Google Workspace assembly lines contain mapping instructions from the IBM Security Verify Governance Identity ManagerIBM Security Verify Governance request to Google Workspace. Modify the assembly lines to add new mappings for custom attributes.

Procedure

  1. Start the Security Directory Integrator Configuration Editor.
  2. Open the googleAppsAdd.xml file. Complete these steps.
    1. Click File > Open Security Directory Integrator Configuration File....
    2. Browse to the GoogleAppsProfile directory.
    3. Select the googleAppsAdd.xml file.
  3. Optional: If previously edited, assign this configuration file to an existing project. Otherwise, proceed to the next screen to create a project and name it googleAppsAdd.
  4. After the file is imported, expand the project to display the AssemblyLines tree in the Navigator pane.
  5. Right click googleAppsAdd assemblyline and select Open. The Add assemblyline configuration is displayed in the main panel.
  6. Click Show Mapping in the main panel. The mapping table for the assembly line is displayed in the main panel.
  7. Under the Data Flow directory, click Add.
  8. In the right pane, click Add to define a new attribute.
  9. Under the Add Attribute window, enter the custom field name in the Enter new name box.
    Note:

    Use the name exactly as displayed in the API Name on the Google Workspace. For example, CustomAttr.

    If a custom field name includes whitespace, then use underscore(_) to replace the whitespace. For example, if the Google Workspace custom field is mail drop, then enter mail_drop as a custom field.

  10. Click OK.
  11. Locate the newly added field in the mapping table and double-click the corresponding row to display an edit dialog box.
  12. Change the default value of the custom field work.[custom_field_name] to work.[custom_attribute_name].
    For example, change the custom field work.mail_drop to work.ergoogappsmaildrop.
    Prefix the attribute names with ergoogapps to easily identify the attributes that are used with IBM Security Verify Governance Identity ManagerIBM Security Verify Governance.
  13. Move to Schema section in the right-most pane, right click, and select Add.
  14. Under the Input Schema Item window, in the Enter name for new Schema Item box, enter the new [custom_field_name].
    For example, mail_drop.
  15. Select the Native Syntax column for the new schema item and enter java.lang.String.
  16. Click File > Save.
  17. Right click the project in the Navigator pane and select the Export... option to export the new assembly line.
  18. In the first screen of the Export dialog, expand the IBM Security Directory Integrator folder and select Runtime Configuration.
  19. Click Next.
  20. In the file path field, browse to the GoogleAppsProfile directory and select the file with the same name from step 2 to overwrite it.
  21. Click Finish.
  22. Repeat the steps 5 through 21 for the GoogleAppsModify assembly line.
  23. Repeat steps 5 through 21 for the GoogleAppsSearch assembly line and do the following steps instead of steps 10 and 11:
    1. Locate the field in the mapping table and click the Work Attribute cell corresponding to the custom field to rename it.
    2. Enter the attribute name that is specified previously in step 11.
      For example, ergoogappsmaildrop.