How to configure Edit Client, Sync, and Navigator for Microsoft Office for Single Sign-On (SSO) when using an SSO authentication page running JavaScript ES6 or higher

How To

Summary

If IBM Content Navigator is configured for Single Sign-On (SSO) with an Identity Provider authentication page that uses JavaScript ES6 or higher, Microsoft Edge WebView2 must be installed on any Windows client that uses the Edit Service or the Sync Service, or Navigator for Microsoft Office (NMO).

For instance, IBM Cloud Pak for Business Automation ships with an authentication page that uses, at a minimum, JavaScript ES6; therefore, this technote applies to all containerized versions of Content Navigator.

Objective

Edit Service and Sync Service and Navigator for Microsoft Office users on Windows desktops can successfully authenticate when Content Navigator is configured for single sign-on and the SSO Identity Provider authentication page uses JavaScript ES6 or higher.

Environment

This procedure requires a minimum level of 3.0.10. IF001 version of Edit Service Client and Sync Service Client, or 3.0.11 for Navigator for Microsoft Office.

Steps

Steps to enable the feature for IBM Content Navigator Windows Edit Service client:

Go to the download page (https://developer.microsoft.com/en-us/microsoft-edge/webview2/) to download and install the appropriate version of Microsoft Edge WebView2 for your workstation.
If it is running, exit the Edit Client.
If the Edit Client version is 3.0.10 or 3.0.11, complete the following steps; otherwise, go to Step 4:
1. Go to the Edit Client installation folder.
  The default installation folder is C:\Program Files (x86)\IBM\IBM Content Navigator Edit\EditClient
2. Open for edit the file IBM Content Navigator Edit.exe.config
3. Change the setting for useEdgeCoreForSSOAuthentication from False to True.
  
  <setting name="useEdgeCoreForSSOAuthentication" serializeAs="String">
  <value>True</value>
  </setting>
4. Save the changes.
Start the Edit Client and verify the tool works as expected.

Steps to enable the feature for IBM Content Navigator Windows Sync Service client

Go to the download page (https://developer.microsoft.com/en-us/microsoft-edge/webview2/) to download and install the appropriate version of Microsoft Edge WebView2 for your workstation.
If it is running, exit the Sync Client.
If the Sync Client version is 3.0.10 or 3.0.11, complete the following steps; otherwise, go to Step 4:
1. Go to the Sync Client installation folder.
  The default installation folder is C:\Program Files (x86)\IBM\IBM Content Navigator Sync\SyncClient
2. Open for edit the file IBM Content Navigator Sync.exe.config.
3. Change the settings for useEdgeCoreForSSOAuthentication from False to True.
  
  <setting name="useEdgeCoreForSSOAuthentication" serializeAs="String">
  <value>True</value>
  </setting>
4. Save the changes.
Start the Sync Client and verify the tool is working as expected.

Steps to enable the feature for IBM Content Navigator for Microsoft Office

Go to the download page (https://developer.microsoft.com/en-us/microsoft-edge/webview2/) to download and install the appropriate version of Microsoft Edge WebView2 for your workstation.
Start Navigator for Microsoft Office. If it is already running, restart it.
NMO automatically detects that WebView2 is installed. You can also enable it by editing the Configuration.ini file:
1. Edit the file C:\ProgramData\IBM\Content Navigator for Microsoft Office\Configuration.ini
2. Add the setting: "UseWebView2=true"

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB18","label":"Miscellaneous LOB"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEUEX","label":"IBM Content Navigator"},"ARM Category":[{"code":"a8m0z0000001gt1AAA","label":"ICN->Core->Edit"},{"code":"a8m0z0000001gsnAAA","label":"ICN->Core->NMO"}],"ARM Case Number":"","Platform":[{"code":"PF033","label":"Windows"}],"Version":"3.0.10;and future releases"}]

Was this topic helpful?

Document Information

More support for:
IBM Content Navigator

Component:
ICN->Core->Edit, ICN->Core->NMO

Software version:
3.0.10 and future releases

Operating system(s):
Windows

Document number:
6473619

Modified date:
21 June 2022

UID

ibm16473619

IBM Support

Tips