User details are missing in signature when synchronized from OKTA

Scenario

You have configured Exclaimer Cloud and are using OKTA to sync user details to Google workspace. Some user details, such as Job Title, are missing from your signatures.

Reason

Exclaimer Cloud for Google workspace uses Google's API to query for data for each account and requires that the field data has the primary: true value set against it. 



By default, OKTA does not set this value for the 'Organizations' attributes.

Resolution

To set the Organization data as primary:

1. Browse to the Google Workspace Admin console -Directory API site (https://developers.google.com/admin-sdk/directory/v1/reference/users/get).
   
   
2. From the right-hand pane, in userKey, enter the email address of the user you wish to query.
   
   
3. From the projection drop-down list select full.
   
   Example:
   
   
   
4. Once the details are filled in, click EXECUTE.
   
   
5. When prompted, sign into a scoped Google Workspace account to authenticate the query:
   
   
6. Copy the required parameter, including all sub-parameters.
   Example:
   
   "organizations": [ { "title": "Title", "customType": "", "department": "IT" }
7. Navigate to https://developers.google.com/admin-sdk/directory/v1/reference/users/update
   
   
8. Set the userKey as the user's email address.
   
   
9. In Request body, specify the parameters you want to set.
   
   Example:
   
   
   { "organizations": [ { "title": "Title", "primary": true, "customType": "", "department": "IT" } ] }
   
   
   WARNING! You must specify all sub-parameters for the Organization; otherwise, they will be overwritten with blank values.
10. Click EXECUTE.
    
    
11. When prompted, sign into a scoped Google Workspace-Suite account to authenticate the query.
    
    
12. When prompted, allow the Google APIs Explorer permission:
    
13. Repeat this process for all affected users.
    
    
14. Once the process is complete, synchronize your user data in Exclaimer Cloud.