summary refs log tree commit diff
path: root/catgirl.1
diff options
context:
space:
mode:
authorJune McEnroe <june@causal.agency>2020-02-13 01:39:25 -0500
committerJune McEnroe <june@causal.agency>2020-02-13 01:39:25 -0500
commitfcfbe8a14c2a376d84e8f17be123a57373558071 (patch)
tree51d1329d47aacbffc8a40806d772d6eb81dc46e2 /catgirl.1
parentExplicitly close the TLS connection (diff)
downloadcatgirl-fcfbe8a14c2a376d84e8f17be123a57373558071.tar.gz
catgirl-fcfbe8a14c2a376d84e8f17be123a57373558071.zip
Add -g for generating certificates
Copied from pounce.
Diffstat (limited to 'catgirl.1')
-rw-r--r--catgirl.145
1 files changed, 45 insertions, 0 deletions
diff --git a/catgirl.1 b/catgirl.1
index b7a9559..cd06200 100644
--- a/catgirl.1
+++ b/catgirl.1
@@ -27,6 +27,9 @@
 .Op Fl w Ar pass
 .Op Ar config ...
 .
+.Nm
+.Fl g Ar cert
+.
 .Sh DESCRIPTION
 The
 .Nm
@@ -122,12 +125,22 @@ it is loaded with
 With
 .Fl e ,
 authenticate using SASL EXTERNAL.
+Certificates can be generated with
+.Fl g .
 .
 .It Fl e , Cm sasl-external
 Authenticate using SASL EXTERNAL,
 also known as CertFP.
 The TLS client certificate is loaded with
 .Fl c .
+For more information, see
+.Sx Configuring CertFP .
+.
+.It Fl g Ar path
+Generate a TLS client certificate using
+.Xr openssl 1
+and write it to
+.Ar path .
 .
 .It Fl h Ar host , Cm host = Ar host
 Connect to
@@ -185,6 +198,38 @@ Log in with the server password
 .Ar pass .
 .El
 .
+.Ss Configuring CertFP
+.Bl -enum
+.It
+Generate a new TLS client certificate:
+.Bd -literal -offset indent
+catgirl -g ~/.config/catgirl/example.pem
+.Ed
+.It
+Connect to the server using the certificate:
+.Bd -literal -offset indent
+cert = example.pem
+# or: catgirl -c example.pem
+.Ed
+.It
+Identify with services or use
+.Cm sasl-plain ,
+then add the certificate fingerprint
+to your account:
+.Bd -literal -offset indent
+/msg NickServ CERT ADD
+.Ed
+.It
+Enable SASL EXTERNAL
+to require successful authentication
+when connecting:
+.Bd -literal -offset indent
+cert = example.pem
+sasl-external
+# or: catgirl -e -c example.pem
+.Ed
+.El
+.
 .Sh COMMANDS
 Any unique prefix can be used to abbreviate a command.
 For example,