summaryrefslogtreecommitdiff
path: root/docs/help/in/otr.in
blob: c31bd8e8b15f51c78b7aa6cb33607d2562ba28a6 (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

OTR %|[OPTION]

Command to control the OTR module. Without an option, this help is printed.

This help contains three sections which are %9options, quickstart and files.%n

To add the OTR status bar (highly recommended):

%9/statusbar window add otr%n

%9Options:%n

AUTH <secret>
    Start or respond to an authentication process.

AUTHQ <question> <secret>
    Start a SMP authentication process.

    Example: %9/otr authq "My question is" "this is the secret"%n

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: %9/otr distrust 487FFADA 5073FEDD C5AB5C14 5BB6C1FF 6D40D48A%n

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.

%9Quickstart:%n

Start a private conversation with the person you want to initiate a secure
session. Once in the private message window:

%9/otr init%n

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.

%9/otr auth <shared-secret>%n OR %9/otr authq "A question" <shared-secret>%n

Or to respond to an authentication:

%9/otr auth <secret>%n

%9Files:%n

This otr modules creates a directory in %9$HOME/.irssi/otr%n and creates three
files:

* %9otr.key%n
    Contains your OTR private key(s). NEVER shared this directory with someone
    else unless you know what you are doing.

* %9otr.fp%n
    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/