Technical Restrictions

There are several technical restrictions that may prevent AppNavi from working properly in a system. These limitations are mostly technological or due to security settings. This article describes the most common stumbling blocks.

Browser compatibility

Confirm that the browser and version are supported for the AppNavi Portal, Avatar, and intended integration method, as unsupported browsers may cause some features to be unavailable or not work as expected. Review
Browser Compatibility to verify supported browser versions before deployment.

Content Security Policy

The Content Security Policy is a problem that often occurs during the integration of AppNavi, but can usually be solved by settings on the web server or the web application itself. This CSP article gives a good guide to the problem.

iFrames

Embedding AppNavi in iFrames is not a problem. However, there are several security mechanisms that prohibit embedding content into an iFrame. These security mechanisms usually take effect when it is a foreign domain. You can find more information on how to use iFrames in this article working with iframes.

Shadow Roots (Shadow DOM)

An important aspect of web components is encapsulation , being able to keep the markup structure, style, and behavior hidden and separate from other code on the page so that different parts do not clash, and the code can be kept nice and clean. The Shadow DOM API is a key part of this, providing a way to attach a hidden separated DOM to an element. This article covers the basics of using the Shadow DOM. In the Shadow Dom, a distinction is made between open and closed modules. Recording and playback of content is only possible in open DOM nodes.

Firewall and network access

Verify that the required AppNavi endpoints are accessible and not blocked by firewalls or network policies, as restrictions may prevent AppNavi resources or data connections from working correctly, and follow the firewall configuration guide to allow the necessary endpoints.

Troubleshooting

If AppNavi does not load or some features do not work as expected, use the following resources to investigate:

• Browser Compatibility — verify browser support and feature limitations.
• Content Security Policy (CSP) Configuration Guide — identify and resolve CSP-related errors.
• Working with iFrames & Frames — understand cross-origin restrictions and iFrame integration scenarios.
• Dealing with firewall configurations — check network and firewall requirements.
• Avatar Diagnostic — investigate Avatar-related issues.