This page shows how to install and configure the Screens players on your devices.
Important:
AEM Screens player does not make use of the Cross-Site Request Forgery (CSRF) token. Therefore, in order to configure and AEM server to be ready to use for AEM Screens, skip the referrer filter by allowing empty referrers.
The Health Check framework allows the user to check if two necessary configurations are set up before running an AEM Screens project.
It allows the user to verify the following two configuration checks to run an AEM Screens project, that is, to check the state of the following two filters:
Follow the steps below to check if these two vital configurations are enabled for AEM Screens:
Navigate to Adobe Experience Manager Web Console Sling Health Check.
Click on Execute selected health checks to run the validation for two properties listed above.
If both the filters are enabled, then the Screens Configuration Health Service shows the Result as OK with both the configurations as enabled.
If one or both the filters are disabled, then an alert is displayed for the user, as shown in the figure below.
The following alert showcases if both the filters are disabled:
The following key points below helps to configure and AEM server to be ready to use for AEM Screens.
Navigate to Adobe Experience Manager Web Console Configuration via AEM instance --> hammer icon --> Operations --> Web Console.
Adobe Experience Manager Web Console Configuration opens. Search for sling referrer.
For searching the sling referrer property, press Command+F for Mac and Control+F for Windows.
Check the Allow Empty option, as shown in the figure below.
Click Save to enable the Apache Sling Referrer Filter Allow Empty.
Navigate to Adobe Experience Manager Web Console Configuration via AEM instance --> hammer icon --> Operations --> Web Console.
Adobe Experience Manager Web Console Configuration opens. Search for Apache Felix Jetty Based HTTP Service.
For searching this property, press Command+F for Mac and Control+F for Windows.
Check the ENABLE HTTP option, as shown in the figure below.
Click Save to enable the http service.
AEM Screens requires TOUCH UI and will not work with CLASSIC UI of Adobe Experience Manager (AEM).
Alternatively, you can also perform the same setting using yourAuthorInstance -> tools (hammer icon) -> Operations -> Web Console and search for WCM Authoring UI Mode Service.
You can always enable Classic UI for specific users using user preferences.
Running AEM in production uses the NOSAMPLECONTENT runmode. Remove the X-Frame-Options=SAMEORIGIN header (in the additional response header section) from
https://localhost:4502/system/console/configMgr/org.apache.sling.engine.impl.SlingMainServlet
.
This is required for the AEM Screens Player to play online channels.
With latest changes to DeviceServiceImpl, you do not have to remove the password restrictions.
You can configure DeviceServiceImpl from the link below to enable password restriction while creating the password for the screens device users:
https://localhost:4502/system/console/configMgr/com.adobe.cq.screens.device.impl.DeviceService
Follow the steps below to configure DeviceServiceImpl:
Navigate to Adobe Experience Manager Web Console Configuration via AEM instance --> hammer icon --> Operations --> Web Console.
Adobe Experience Manager Web Console Configuration opens. Search for deviceservice. For searching the property, press Command+F for macOS and Control+F for Microsoft Windows.
To learn how to configure dispatcher for an AEM Screens project, refer to Configuring Dispatcher for an AEM Screens project.
Set the Java encoding to Unicode. For example, Dfile.encoding=Cp1252 will not work.
Recommendation:
It is recommended to use HTTPS for AEM Screens Server in production use.