User:B42/OTR: Difference between revisions

From base48
imported>B42
(save)
 
imported>B42
No edit summary
Line 1: Line 1:
summary
This module allows you to encrypt private conversations using the [https://otr.cypherpunks.ca/ OTR protocol]. Several popular [https://otr.cypherpunks.ca/software.php IRC clients] support OTR (usually requiring a plugin).
link to otr site
 
For more information about OTR, see:
* https://otr.cypherpunks.ca/
* https://otr.im/


== Installing ==
== Installing ==
Line 7: Line 10:


== Usage ==
== Usage ==
sending commands to *otr
To request OTR-encrypted conversation with someone, send them the message ''?OTR?'' in a private conversation. If the request succeeds the module informs you about it and requests that you authenticate the other side if you haven't previously done so.
initiating otr session
 
network module
The module is controlled by sending commands to the ''*otr'' nick. The commands are listed below.
 
Please note that otr is a network module meaning that if your account has multiple IRC networks then each has its own instance of the module and its own ''*otr'' nick.


=== Commands ===
=== Commands ===
==== help ====
Prints the table of available commands together with their short description.
==== info ====
==== info ====
Shows the table of known fingerprints.
Example:
<pre>
</pre>
==== trust <nick|fingerprint> ====
==== distrust <nick|fingerprint> ====
==== finish <nick> ====
==== auth <nick> <secret> ====
==== authq <nick> <[question]> <secret> ====
==== authabort <nick> ====
==== genkey [--overwrite] ====


== Security considerations ==
== Security considerations ==
* use it on client if possible
* ssl
* logging
* admin/sole user


== Bugs ==
== Bugs ==
broken clients - finish & ?OTR?
broken clients - finish & ?OTR?

Revision as of 11:14, 10 April 2014

This module allows you to encrypt private conversations using the OTR protocol. Several popular IRC clients support OTR (usually requiring a plugin).

For more information about OTR, see:

Installing

The module source is available at https://github.com/mmilata/znc-otr. You can download a tarball directly if you don't want to use git. Once you have the source code, follow the instructions for compiling and loading ZNC modules.

Usage

To request OTR-encrypted conversation with someone, send them the message ?OTR? in a private conversation. If the request succeeds the module informs you about it and requests that you authenticate the other side if you haven't previously done so.

The module is controlled by sending commands to the *otr nick. The commands are listed below.

Please note that otr is a network module meaning that if your account has multiple IRC networks then each has its own instance of the module and its own *otr nick.

Commands

help

Prints the table of available commands together with their short description.

info

Shows the table of known fingerprints.

Example:


trust <nick|fingerprint>

distrust <nick|fingerprint>

finish <nick>

auth <nick> <secret>

authq <nick> <[question]> <secret>

authabort <nick>

genkey [--overwrite]

Security considerations

  • use it on client if possible
  • ssl
  • logging
  • admin/sole user

Bugs

broken clients - finish & ?OTR?