Commit 5e3eaf7c authored by Etienne Allovon's avatar Etienne Allovon

Detail External view url configuration

parent 4b8fd52d
......@@ -32,28 +32,35 @@ Call history by default shows the last 7 days. You can change it by setting the
External Directory
------------------
External directory can be enable through configuration by passing an URL to ``EXTERNAL_VIEW_URL`` environment variable in :file:`/etc/docker/compose/custom.env` file.
To enable External Directory feature you need to:
You need to add to the docker compose file (:file:`/etc/docker/compose/docker-xivocc.yml`) the environment variable to the xucmgt service. Like :
#. add the ``EXTERNAL_VIEW_URL`` environment variable to the docker compose file :file:`/etc/docker/compose/docker-xivocc.yml`:
.. code-block:: yaml
:emphasize-lines: 4
.. code-block:: yaml
:emphasize-lines: 4
xucmgt:
xucmgt:
environment:
- EXTERNAL_VIEW_URL
[...]
environment:
- EXTERNAL_VIEW_URL
[...]
.. note:: When ``EXTERNAL_VIEW_URL`` is set, button will also be displayed in both UC Assistant and CC Agent
#. and then configure it in the :file:`/etc/docker/compose/custom.env` file::
EXTERNAL_VIEW_URL=https://myxivocc/externaldir
.. note:: When ``EXTERNAL_VIEW_URL`` is set, it will be displayed in both UC Assistant and CC Agent
.. warning::
Some limitations/restrictions are nevertheless existing for using this feature:
Take care of the following restrictions:
* The ``EXTERNAL_VIEW_URL`` must be seen as hosted by XiVO CC platform (otherwise it won't open because of CORS restriction).
* You MUST use the same HTTP protocol to access the CC application (UC Assistant or CC Agent) AND to access the external view.
For example, if you access the application over HTTPS, you must access the external view over HTTPS too (to the avoid *Mixed Content* errors).
* The external URL *MUST NOT* have the 'X-Frame-Options' to 'sameorigin', else the feature will not work (e.g. you can't use google.com as directory...).
* To avoid CORS, the external directory must be seen as hosted by XiVO CC platform (you may need to use proxy)
* If you open web application over HTTPS, you can't use an external directory over HTTP (to avoid *Mixed Content* errors)
* The external URL *must NOT* have the 'X-Frame-Options' to 'sameorigin', else the feature will not work. (e.g you can't use google.com as directory...)
.. _screen_popup:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment