Skip to content

Commit

Permalink
Update guide to version 329
Browse files Browse the repository at this point in the history
  • Loading branch information
GitHub Workflow committed Nov 20, 2024
1 parent 31a6e5b commit 10108ae
Show file tree
Hide file tree
Showing 6 changed files with 96 additions and 5 deletions.
4 changes: 2 additions & 2 deletions guide/latest/authentication.html
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Cockpit Guide">
<link rel="up" href="guide.html" title="Part I. Deployment Guide">
<link rel="prev" href="startup.html" title="Start up">
<link rel="prev" href="multi-host.html" title="Managing multiple hosts at the same time">
<link rel="next" href="sso.html" title="Single Sign On">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="startup.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="p" href="multi-host.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="guide.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Cockpit Guide</th>
Expand Down
10 changes: 10 additions & 0 deletions guide/latest/cockpit.conf.5.html
Original file line number Diff line number Diff line change
Expand Up @@ -252,6 +252,16 @@ <h2><span class="refentrytitle">cockpit.conf</span></h2>
<p>When not specified, there is no idle timeout by default.</p>
</td>
</tr>
<tr>
<td><p><span class="term"><code class="option">WarnBeforeConnecting</code></span></p></td>
<td>
<p>Whether to warn before connecting to remote hosts from the Shell. Defaults to true.</p>
<div class="informalexample"><pre class="programlisting">
[Session]
WarnBeforeConnecting=false
</pre></div>
</td>
</tr>
</tbody>
</table></div>
</div>
Expand Down
3 changes: 3 additions & 0 deletions guide/latest/guide.html
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,9 @@
<dt><span class="section"><a href="startup.html#startup-shutdown">Process exit</a></span></dt>
<dt><span class="section"><a href="startup.html#startup-boot">Boot start up</a></span></dt>
</dl></dd>
<dt><span class="chapter"><a href="multi-host.html">
Managing multiple hosts at the same time
</a></span></dt>
<dt><span class="chapter"><a href="authentication.html">Cockpit Authentication</a></span></dt>
<dd><dl>
<dt><span class="section"><a href="authentication.html#initial-auth">Directly logging into the primary server</a></span></dt>
Expand Down
5 changes: 4 additions & 1 deletion guide/latest/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
<div class="titlepage">
<div>
<div><table class="navigation" id="top" width="100%" cellpadding="2" cellspacing="0"><tr><th valign="middle"><p class="title">Cockpit Guide</p></th></tr></table></div>
<div><p class="releaseinfo">Documentation for Cockpit 328
<div><p class="releaseinfo">Documentation for Cockpit 329
--
latest version available at:
<a class="ulink" href="https://cockpit-project.org/guide/latest" target="_top">https://cockpit-project.org/guide/latest/</a></p></div>
Expand Down Expand Up @@ -60,6 +60,9 @@
<dt><span class="section"><a href="startup.html#startup-shutdown">Process exit</a></span></dt>
<dt><span class="section"><a href="startup.html#startup-boot">Boot start up</a></span></dt>
</dl></dd>
<dt><span class="chapter"><a href="multi-host.html">
Managing multiple hosts at the same time
</a></span></dt>
<dt><span class="chapter"><a href="authentication.html">Cockpit Authentication</a></span></dt>
<dd><dl>
<dt><span class="section"><a href="authentication.html#initial-auth">Directly logging into the primary server</a></span></dt>
Expand Down
75 changes: 75 additions & 0 deletions guide/latest/multi-host.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
---
layout: guide
---
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Managing multiple hosts at the same time</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Cockpit Guide">
<link rel="up" href="guide.html" title="Part I. Deployment Guide">
<link rel="prev" href="startup.html" title="Start up">
<link rel="next" href="authentication.html" title="Cockpit Authentication">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="startup.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="guide.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Cockpit Guide</th>
<td><a accesskey="n" href="authentication.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="chapter">
<div class="titlepage"><div><div><h2 class="title">
<a name="multi-host"></a>
Managing multiple hosts at the same time
</h2></div></div></div>
<p>
Cockpit allows you to access multiple hosts in a single session,
by establishing SSH connections to other hosts. This is quite
similar to logging into these other hosts using the
<span class="command"><strong>ssh</strong></span> command on the command line, with one very
important difference:
</p>
<p>
Code from the local host and all the remote hosts run at the same
time, in the same browser context. They are not isolated from
each other in the browser. All code effectively has the same
privileges as the primary session on the local host.
</p>
<p>
Thus, <span class="emphasis"><em>you should only only connect to remote hosts that
you trust</em></span>. You must be sure that none of the hosts that
you connect to will cause Cockpit to load malicious JavaScript
code into your browser.
</p>
<p>
Therefore, Cockpit will warn you before connecting to more than
one host. It is also possible to disable multiple hosts entirely,
and some operating systems do this already by default.
</p>
<p>
You can prevent loading of JavaScript, HTML, etc from more than
one host by adding this to <code class="filename">cockpit.conf</code>:
</p>
<pre class="programlisting">
[WebService]
AllowMultiHost=false
</pre>
<p>
When you allow multiple hosts in a single Cockpit session by
setting <code class="code">AllowMultiHost</code> to true, then the user will be
warned once per session, before connecting to the second host. If
that is still too much, you can switch the warning off completely
by adding the following to <code class="filename">cockpit.conf</code>:
</p>
<pre class="programlisting">
[Session]
WarnBeforeConnecting=false
</pre>
</div>
<div class="footer"><hr></div>
</body>
</html>
4 changes: 2 additions & 2 deletions guide/latest/startup.html
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
<link rel="home" href="index.html" title="Cockpit Guide">
<link rel="up" href="guide.html" title="Part I. Deployment Guide">
<link rel="prev" href="listen.html" title="TCP Port and Address">
<link rel="next" href="authentication.html" title="Cockpit Authentication">
<link rel="next" href="multi-host.html" title="Managing multiple hosts at the same time">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Expand All @@ -19,7 +19,7 @@
<td><a accesskey="u" href="guide.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Cockpit Guide</th>
<td><a accesskey="n" href="authentication.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
<td><a accesskey="n" href="multi-host.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="chapter">
<div class="titlepage"><div><div><h2 class="title">
Expand Down

0 comments on commit 10108ae

Please sign in to comment.