Embedded Interfaces

Purpose

The Embedded Interfaces page in the Admin Console enables you to manage settings for embedded interfaces.

Access

To access the Embedded Interfaces page, go to the Admin Console. Then, in the left navigation menu, under Integration, click Embedded Interfaces.

Settings

The Embedded Interfaces page allows you to manage:

• Origins for embedding interfaces and displaying portals on external websites.
• Themes for embedding interfaces on external websites.

Origins

The Origins section allows you to add and remove from the list of hosts that are allowed to make cross-origin resource sharing requests to your Appian site. By default, the list is empty. The prevention of unauthorized cross-origin requests is an important part of web application security, so only trusted hosts should be added to this list.

You need to add a host to the allowed origins list when:

• You are embedding an Appian interface on a website that uses a different host than Appian.
• You are using an iframe to display a portal page on a website that uses a different host than Appian.

To add a website to the Origins list:

1. Go to the Embedded Interfaces section in the Admin Console.
2. In the Origins list, click New Allowed Origin.
3. Enter the host as it is typed in the browser address bar.
   • If the port is different from the protocol default, include the port without the protocol. For example: server.example.com or server.example.com:8080.

4. Click SAVE CHANGES.

   Note:  If you are planning to display a portal in an external website, be sure to republish the portal after updating the Origins list.

Adding or removing a host results in an audit log message with:

• The username of the user who made the change.
• The previous list of allowed hosts.
• The new list of allowed hosts.

Themes

The Themes section allows you to configure any number of themes with custom font and color styling. A theme can be optionally applied to the interfaces that are embedded in an external web page. This allows custom styling of embedded interfaces in order to make them more consistent with the host web page.

Themes can only be applied to embedded interfaces. Learn more about site branding, portal branding, and Tempo branding.

All modifications to themes result in an audit log message with:

• The username of the user who made the change.
• The previous values.
• The new values.

Feedback