Unable to Validate the Client Identity Token Error when Starting Add-In¶
[ This article is work-in-progress ]
Symptoms¶
- When starting SSI Add-In the following error message is shown:
- “Unable to validate the client identity token. Please restart the e-mail client” or
- “Unable to load the identity token. Please restart Microsoft Outlook“
- Customer is reporting that they cannot load the Add-In. It is saying “Looks like your login session has expired. We will refresh it” and then the Add-In is trying to load until it stops
Restarting E-Mail client (MS Outlook) and resetting the MS Exchange password doesn’t help.
Causes¶
This issue is caused by a misconfiguration on the customer’s MS Exchange server\firewall. The identity token, which is used to authenticate a user in Add-In, contains an encoded Exchange MetaData URL, which is used to download Exchange meta-info and perform the validation process. Server-Side Integration is trying to connect to Exchange MetaData URL https://somehost.com:443/autodiscover/metadata/json/1, which is an internal resource in the customer’s network and can not be accessed from the internet.
Resolution¶
To resolve the issue, it is required properly configure Identity Token URL on the MS Exchange server to make it available from external networks.
Please note the items below to run SAP Cloud for Customer Server-Side Integration properly:
-
Make sure the MetaData URL https://somehost.com:443/autodiscover/metadata/json/1 (where somehost.com is an Exchange server external URL) is available from external networks or the firewall is set to allow the connection from IP addresses listed below. If there is any authentication enabled to access this URL, it should be disabled as well.
For example, try accessing the same URL in Office 365 (https://outlook.office365.com/autodiscover/metadata/json/1), a similar response is expected. -
The Exchange server must accept incoming EWS (Exchange Web Services) calls from SAP Cloud for Customer Server-Side Integration. AutoDiscover may have to be set up. More details on AutoDiscover are available here.
SAP Cloud for Customer Server-Side Integration IP addresses to authorize on the Exchange server side are documented below. Incoming EWS calls can be assessed for legitimacy by checking that they originate from within this IP range and contain a valid JWT (JSON Web Token). Details about JWT are available here. -
The Exchange server is configured to generate JWTs properly, so they indicate the URL SAP Cloud for Customer Server-Side Integration utilized to connect to the Exchange server. That URL may be the same as the AutoDiscover URL and is referred to as the MetaData URL in the JWT. If SAP Cloud for Customer Server-Side Integration still doesn’t work, a standard check to conduct is to review Certificates on the Exchange server and ensure their validity.
-
Make sure that EWS is properly configured to be available inside and outside of the organization by executing the following command:
- C:\windows\system32>Get-WebServicesVirtualDirectory |Select name, *url* | fl
-
Exchange MetaData URL should be available from external networks, so if any proxy or firewall is used, make sure they are available from the internet.
Productive landscape (IP Addresses)¶
>>> Click to see SSI IP addresses <<<
IP addresses of SAP Cloud for Customer Server-Side Integration
Location |
SU |
Resource |
Main location |
List of PIPs in IP range |
DR location |
List of PIPs in IP range |
Website (public DNS) |
|
---|---|---|---|---|---|---|---|---|
WDC |
Wdcprod01 |
web, worker |
40.89.246.90, |
Wdcprod-AKS |
20.81.29.60, |
sapcfc-sap-wdcprod01-sync.c4c.invisiblesolutions.com |
||
WDC |
Wdctest01 |
web, worker |
52.186.90.126, |
Wdctest-AKS |
20.84.212.112, |
sapcfc-sap-wdctest01-sync.c4c.invisiblesolutions.com |
||
WDC mod |
20.121.86.250; |
52.228.162.70; |
||||||
FRA FRA mod |
Fraprod01-05 Fratest01 Fratest21 Fraprod21 |
web, worker |
20.79.94.108, 20.79.101.104, 20.52.203.122, 20.79.89.96; |
Fratest-AKS Fraprod02 Fratest21 Fraprod21 |
20.50.236.104, 20.54.192.120, 51.105.215.150, 20.113.195.212; 20.113.195.213; 20.113.195.214; 20.113.195.215 |
sapcfc-sap-fraprod[01..05]-sync.c4c.invisiblesolutions.com sapcfc-sap-fratest01-sync.c4c.invisiblesolutions.com sapcfc-sap-fratest21-sync.c4c.invisiblesolutions.com sapcfc-sap-fraprod21-sync.c4c.invisiblesolutions.com |
||
PER
PER mod |
Perprod01 Pertest01 |
web, worker |
40.115.90.12, 20.53.187.192, 20.70.88.90; |
PerProd-AKS Pertest-AKS |
20.193.1.176, 13.70.173.238, 20.248.144.52; |
sapcfc-sap-perprod01-sync.c4c.invisiblesolutions.com sapcfc-sap-pertest01-sync.c4c.invisiblesolutions.com |
Related resources¶
Getting Internal Server Error 500 when creating New-CsPartnerApplication for Exchange 2013
Server to Server communication is broken – how to fix it?