mirror of
https://github.com/nextcloud/documentation.git
synced 2026-01-03 18:26:42 +07:00
add External Sites page
This commit is contained in:
59
admin_manual/configuration_server/external_sites.rst
Normal file
59
admin_manual/configuration_server/external_sites.rst
Normal file
@@ -0,0 +1,59 @@
|
||||
======================
|
||||
Linking External Sites
|
||||
======================
|
||||
|
||||
You can embed external Web sites inside your ownCloud pages with the External
|
||||
Sites app, as this screenshot shows.
|
||||
|
||||
.. figure:: ../images/external-sites-1.png
|
||||
:scale: 60%
|
||||
|
||||
*Click to enlarge*
|
||||
|
||||
This is useful for quick access to important Web pages such as the
|
||||
ownCloud manuals and informational pages for your company, and for presenting
|
||||
external pages inside your custom ownCloud branding, if you use your own custom
|
||||
themes.
|
||||
|
||||
The External sites app is included in all versions of ownCloud. Go to **Apps >
|
||||
Not Enabled** to enable it. Then go to your ownCloud Admin page to create your
|
||||
links, which are saved automatically. There is a dropdown menu to select an
|
||||
icon, but there is only one default icon so you don't have to select one. Hover
|
||||
your cursor to the right of your links to make the trashcan icon appear when you
|
||||
want to remove them.
|
||||
|
||||
.. figure:: ../images/external-sites-2.png
|
||||
:scale: 80%
|
||||
|
||||
*Click to enlarge*
|
||||
|
||||
The links appear in the ownCloud dropdown menu on the top left after
|
||||
refreshing your page, and have globe icons.
|
||||
|
||||
.. figure:: ../images/external-sites-3.png
|
||||
|
||||
Your links may or may not work correctly due to the various ways that Web
|
||||
browsers and Web sites handle HTTP and HTTPS URLs, and because the External
|
||||
Sites app embeds external links in IFrames. Modern Web browsers try very hard
|
||||
to protect Web surfers from dangerous links, and safety apps like
|
||||
`Privacy Badger <https://www.eff.org/privacybadger>`_ and ad-blockers may block
|
||||
embedded pages. It is strongly recommended to enforce HTTPS on your ownCloud
|
||||
server; do not weaken this, or any of your security tools, just to make
|
||||
embedded Web pages work. After all, you can freely access them outside of
|
||||
ownCloud.
|
||||
|
||||
Most Web sites that offer login functionalities use the ``X-Frame-Options`` or
|
||||
``Content-Security-Policy`` HTTP header which instructs browsers to not
|
||||
allow their pages to be embedded for security reasons (e.g. "Clickjacking"). You
|
||||
can usually verify the reason why embedding the website is not possible by using
|
||||
your browser's console tool. For example, this page has an invalid SSL
|
||||
certificate.
|
||||
|
||||
.. figure:: ../images/external-sites-4.png
|
||||
|
||||
On this page, X-Frame-Options prevents the embedding.
|
||||
|
||||
.. figure:: ../images/external-sites-5.png
|
||||
|
||||
There isn't much you can do about these issues, but if you're curious you can
|
||||
see what is happening.
|
||||
@@ -12,7 +12,7 @@ ownCloud Server Configuration
|
||||
background_jobs_configuration
|
||||
config_sample_php_parameters
|
||||
email_configuration
|
||||
|
||||
external_sites
|
||||
js_css_asset_management_configuration
|
||||
knowledgebase_configuration
|
||||
language_configuration
|
||||
|
||||
BIN
admin_manual/images/external-sites-1.png
Normal file
BIN
admin_manual/images/external-sites-1.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 79 KiB |
BIN
admin_manual/images/external-sites-2.png
Normal file
BIN
admin_manual/images/external-sites-2.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 17 KiB |
BIN
admin_manual/images/external-sites-3.png
Normal file
BIN
admin_manual/images/external-sites-3.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 20 KiB |
BIN
admin_manual/images/external-sites-4.png
Normal file
BIN
admin_manual/images/external-sites-4.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 100 KiB |
BIN
admin_manual/images/external-sites-5.png
Normal file
BIN
admin_manual/images/external-sites-5.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 108 KiB |
Reference in New Issue
Block a user