Module:Certauth - Revision history

Russell: Format Changes

2020-06-20T15:36:50Z

Format Changes

Russell: Module Info for certauth added

2020-04-22T15:09:26Z

Module Info for certauth added

Russell: Initial Page

2020-04-14T20:29:45Z

Initial Page

New page

Information about this module will appear shortly

[[Category:Modules]]

@@ Line 1: / Line 1: @@
 This module allows you to authenticate to the bouncer using your own certificate rather than using password authentication
 The public key of your SSL certificate needs to be uploaded to the server in order for this module to work. This can be done using the webadmin.
-== Certificates ==
+= Certificates =
-=== Generating a Certificate ===
+== Generating a Certificate ==
 We recommend using OpenSSL to generate certificates which is available on Windows and Linux.
@@ Line 12: / Line 11: @@
      openssl req -nodes -newkey rsa:4096 -keyout YourNickname.pem -x509 -days 365 -out user.pem -subj "/CN=YourNickname"
-=== Using the Certificate ===
+== Using the Certificate ==
 To obtain the SHA-1 fingerprint of the certificate you have generated enter the following command:
@@ Line 20: / Line 19: @@
 The SHA-1 fingerprint returned must then be entered into the 'certauth' tab on the bouncer's webadmin or be added by command.
-== Usage ==
+= Usage =
-=== Arguments ===
+== Arguments ==
 This module takes no arguments
-=== Commands ===
+== Commands ==
 This module will only work correctly if an SSL certificate has been uploaded via the webadmin and comes with 2 commands. They are as follows:
@@ Line 40: / Line 39: @@
      /msg *certauth list
-== Notes ==
+= Notes =
 For certificate authentication to work, you must connect to the bouncers SSL port (+1339) and you must still send your username and network name (optional).

← Older revision		Revision as of 15:09, 22 April 2020
Line 1:		Line 1:
−	~~Information about~~ this module will ~~appear shortly~~	+	= certauth =
		+	This module allows you to authenticate to the bouncer using your own certificate rather than using password authentication
		+
		+	The public key of your SSL certificate needs to be uploaded to the server in order for this module to work. This can be done using the webadmin.
		+
		+	== Certificates ==
		+
		+	=== Generating a Certificate ===
		+	We recommend using OpenSSL to generate certificates which is available on Windows and Linux.
		+
		+	This command below will generate 4096-bit certificate which will expire in 365 days. The contents of the ''YourNickname.pem'' this generates is the certificate you will need to add to the bouncer.
		+	openssl req -nodes -newkey rsa:4096 -keyout YourNickname.pem -x509 -days 365 -out user.pem -subj "/CN=YourNickname"
		+
		+	=== Using the Certificate ===
		+
		+	To obtain the SHA-1 fingerprint of the certificate you have generated enter the following command:
		+
		+	openssl x509 -sha1 -noout -fingerprint -in user.pem \| sed -e 's/^.*=//;s/://g;y/ABCDEF/abcdef/'
		+
		+	The SHA-1 fingerprint returned must then be entered into the 'certauth' tab on the bouncer's webadmin or be added by command.
		+
		+	== Usage ==
		+
		+	=== Arguments ===
		+	This module takes no arguments
		+
		+	=== Commands ===
		+	This module will only work correctly if an SSL certificate has been uploaded via the webadmin and comes with 2 commands. They are as follows:
		+
		+	Adds a given SHA-1 fingerprint or if you have connected with a certificate, adds the fingerprint for certificate you are currently using
		+	/msg *certauth add [SHA-1 fingerprint]
		+
		+	Deletes the public key with a given number (from list)
		+	/msg *certauth delete <number>
		+
		+	Show the public key of the certificate you are currently using
		+	/msg *certauth info
		+
		+	List the public keys that have been added to your account
		+	/msg *certauth list
		+
		+	== Notes ==
		+
		+	For certificate authentication to work, you must connect to the bouncers SSL port (+1339) and you must still send your username and network name (optional).
		+
		+	E.g ''"YourUsername/NetworkName:"'' or ''"YourUsername:"''. No password needs to be specified.
		+

	[[Category:Modules]]		[[Category:Modules]]