help: caution users about using Ignore SSL Errors
[empathy.git] / help / C / account-jabber.page
1 <page xmlns="http://projectmallard.org/1.0/"
2       xmlns:e="http://projectmallard.org/experimental/"
3       type="topic" style="screen"
4       id="account-jabber">
5
6   <info>
7     <desc>Advanced options for Jabber and Google Talk accounts.</desc>
8     <revision pkgversion="2.28" version="0.1" date="2009-08-27" status="review">
9       <!--
10       <e:review by="shaunm@gnome.org" date="2009-08-31" status="done"/>
11       -->
12     </revision>
13     <revision pkgversion="3.12" date="2015-02-03" status="review"/>
14     <credit type="author">
15       <name>Shaun McCance</name>
16       <email>shaunm@gnome.org</email>
17     </credit>
18     <license>
19       <p>Creative Commons Share Alike 3.0</p>
20     </license>
21 <!--
22     <copyright>
23       <year>2009</year>
24       <name>GNOME Documentation Project</name>
25     </copyright>
26     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
27 -->
28   </info>
29
30   <title>Jabber account details</title>
31
32   <p>Most Jabber accounts will require only a login ID and a password
33   to connect.  For some accounts or on certain types of networks, you
34   may need to enter additional information in the <gui>Advanced</gui>
35   section.  Normally, you will not need to use the advanced options
36   below.  For general instructions on adding an account, see
37   <link xref="add-account"/>.</p>
38
39   <note>
40     <p>Google Talk is a type of Jabber account.  These instructions
41     hold for Google Talk accounts as well.</p>
42   </note>
43
44   <terms>
45     <item>
46       <title><gui>Encryption required (TLS/SSL)</gui></title>
47       <title><gui>Ignore SSL certificate errors</gui></title>
48       <p>Whenever possible, communication between <app>Empathy</app> and
49       the Jabber server is encrypted.  If encrypted communication is not
50       possible, messages may be sent unencrypted.  Select <gui>Encryption
51       required</gui> to prevent <app>Empathy</app> from communicating with
52       the Jabber server when encryption is not possible.</p>
53       <p>Some Jabber servers may encrypt data using invalid certificates,
54       or using certificates signed by unknown authorities.  You can select
55       <gui>Ignore SSL certificate errors</gui> to allow encrypted communication
56       with invalid certificates, but this allows an attacker to intercept your
57       communication with the server (including your password). You might want to
58       use this option for testing purposes, or if your server is broken and you
59       do not care about the security of your communication.</p>
60     </item>
61     <item>
62       <title><gui>Resource</gui></title>
63       <title><gui>Priority</gui></title>
64       <p>If you have multiple applications (for instance, on separate computers)
65       connected to your account at the same time, you can set a resource to
66       uniquely identify each one.  By default, <app>Empathy</app> will use
67       <input>Telepathy</input> as the resource.</p>
68       <p>You can set the priority to specify which application should receive
69       incoming messages from your contacts.  New messages will be sent to the
70       application with the highest priority.</p>
71     </item>
72     <item>
73       <title><gui>Override server settings</gui></title>
74       <p><app>Empathy</app> will use default settings to connect to the
75       Jabber server based on your login ID.  For some Jabber servers, you
76       will need to enter custom server settings manually.  These settings
77       should be provided for you by your Jabber provider.</p>
78     </item>
79   </terms>
80
81 </page>