D365 Retail

Field notes on Dynamics 365 Commerce & Retail

All articles
Retail ServerIntegration

Dynamics 365 for Operations and TLS 1.2: Diagnosing a Broken Retail Server Integration

16 January 20181 min readHitesh Manglani

On an early Dynamics 365 for Operations project, we needed to integrate the Azure-hosted Retail Server with an on-premise web API (see MPOS Technical Architecture for how the overall Retail topology fits together).

The integration worked in Dev but broke the moment we promoted it to the UAT sandbox, with:

Unable to read data from the transport connection: An existing connection was forcibly closed by the remote host.

It took some investigation to trace the cause: Dynamics 365 for Operations enforces TLS 1.2, while the destination server only supported TLS 1.0 and 1.1.

What helped diagnose it

The last link is the most useful of the three — it includes a small console application that tries every combination of TLS protocol between source and destination, and tells you exactly which ones are supported. That's what actually pinned down the mismatch.

More on this topic

Stuck on a D365 Commerce issue?

If you need hands-on help with MPOS, CRT extensions, or a Retail deployment, get in touch — I still build these things.

Talk to me