blob: 086190007981abdc41ea79ea018e5871c234c626 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
---
layout: page
title: "Help: otr"
---
{% comment %}
Please submit changes to
- https://github.com/irssi/irssi/blob/master/docs/help/in/otr.in
{% endcomment %}
[Help index](/documentation/help)
<div class="highlight irssisyntax"><pre style="\-\-cmdlen:3ch"><code><span class="synB">OTR</span> <span class="syn10">[<span class="syn">OPTION</span>]</span></code></pre></div>
Command to control the OTR module. Without an option, /OTR INFO is printed.
This help contains three sections which are <strong>options, quickstart and files.</strong>
To add the OTR status bar (highly recommended):
<strong>/statusbar window add otr</strong>
<strong>Options:</strong>
AUTH <secret>
Start or respond to an authentication process.
AUTHQ <question> <secret>
Start a SMP authentication process.
Example: <strong>/otr authq "My question is" "this is the secret"</strong>
AUTHABORT
Abort an ongoing authentication process.
CONTEXTS
List known contexts which basically list the known fingerprints and their
state.
DEBUG
Turn on debugging.
DISTRUST <fingerprint>
Distrust a specific fingerprint. This command can be done inside a private
window for which the current fingerprint of the other person will be used
or else set fp to a human readable OTR fingerprint available with the above
contexts command.
Examples: <strong>/otr distrust 487FFADA 5073FEDD C5AB5C14 5BB6C1FF 6D40D48A</strong>
FINISH
End the OTR session. This MUST be done inside a private conversation
window.
FORGET <fingerprint>
Forget a specific fingerprint (deleted from the known fingerprints). The
behavior is the same as the distrust command explained above.
GENKEY <name>
Generate OTR keys for a given account name. This is done automatically
if someone tries to establish a secure session.
This process is done in a background worker and can take an arbitrary
amount of time. The completion is checked when another irssi event is
catched.
HELP
Print this help.
INFO
Display the OTR fingerprint(s) of all your account(s).
INIT
Initialize an OTR conversation within a private conversation window.
TRUST <fingerprint>
Trust a specific fingerprint. The behavior is the same as the forget and
distrust commands explained above.
VERSION
Print the version of the OTR module.
<strong>Quickstart:</strong>
Start a private conversation with the person you want to initiate a secure session. Once in the private message window:
<strong>/otr init</strong>
Key generation should start if no key is found for your account name. Once the process is done, either type a message which should automatically start the session or redo the init command.
Time to authenticate the person. Either use a shared secret exchange through phone or GPG-signed email or use the socialist millionaire problem mechanism (SMP) which is basically to ask a question for which the answer can only be known by the other person.
<strong>/otr auth <shared-secret>%n OR %9/otr authq "A question" <shared-secret></strong>
Or to respond to an authentication:
<strong>/otr auth <secret></strong>
<strong>Files:</strong>
This otr modules creates a directory in <strong>$HOME/.irssi/otr</strong> and creates three files:
* <strong>otr.key</strong>
Contains your OTR private key(s). NEVER shared this directory with someone
else unless you know what you are doing.
* <strong>otr.fp</strong>
The known fingerprints with their _trust_ status.
* %9otr.instag
Instance tag of the libotr. This should NEVER be copied to an other
computer. If unsure, just ignore this file.
For more information on OTR, see https://otr.cypherpunks.ca/
|
