Authentication Server - Revision history

Cadillac at 01:06, 23 August 2021

2021-08-23T01:06:31Z

← Older revision		Revision as of 21:06, 22 August 2021
Line 111:		Line 111:

	{{Sections}}		{{Sections}}

			[[Category:Development]]

Delinquent: /* Understanding the requirements of an Authentication server */ made clickable link unclickable

2020-07-24T14:29:15Z

Understanding the requirements of an Authentication server: made clickable link unclickable

← Older revision		Revision as of 10:29, 24 July 2020
Line 73:		Line 73:
	If you don't have the password in this form in your database, you'll need to generate it. forums.armagetronad.net uses a trick: whenever a user logs on, the server gets the plaintext password, and then the hash for the bmd5 protocol is stored. phpBB2 already stores the plain md5 hash of the password, so the md5 protocol is natively supported with prefix=suffix="".		If you don't have the password in this form in your database, you'll need to generate it. forums.armagetronad.net uses a trick: whenever a user logs on, the server gets the plaintext password, and then the hash for the bmd5 protocol is stored. phpBB2 already stores the plain md5 hash of the password, so the md5 protocol is natively supported with prefix=suffix="".

	To run an authentication server, you need control over a web server with scripting available. If your authority name shall be bla.blubb.net, game servers will query the URI http://bla.blubb.net/armaauth/0.1 with an appended query string; if you make /armaauth/0.1 a directory and put your authentication script there, named index.php or index.py or even index.sh, whatever your server supports, it will be called to process the requests.		To run an authentication server, you need control over a web server with scripting available. If your authority name shall be bla.blubb.net, game servers will query the URI '''<nowiki>http://bla.blubb.net/armaauth/0.1</nowiki>''' with an appended query string; if you make /armaauth/0.1 a directory and put your authentication script there, named index.php or index.py or even index.sh, whatever your server supports, it will be called to process the requests.

	If you can't access /armaauth/0.1, you can put it into a subdirectory. If you put it into /~user/armaauth/0.1, then your authority will be named bla.blubb.net/~user.		If you can't access /armaauth/0.1, you can put it into a subdirectory. If you put it into /~user/armaauth/0.1, then your authority will be named bla.blubb.net/~user.

Delinquent: Fixed the fixed formatting

2020-07-24T14:17:16Z

Fixed the fixed formatting

← Older revision		Revision as of 10:17, 24 July 2020
Line 7:		Line 7:
	''Note: This guide was written specifically for phpbb3 only. Other/older variants of phpbb may not work, and you risk damaging your forum build. The editors of the wiki take no responsibility for the advice contained herein, although you may be able to obtain informal, unofficial assistance at the [http://forums3.armagetronad.net/viewforum.php?f=49 Armagetron support forums] or the [https://www.phpbb.com/support/ phpbb website].''		''Note: This guide was written specifically for phpbb3 only. Other/older variants of phpbb may not work, and you risk damaging your forum build. The editors of the wiki take no responsibility for the advice contained herein, although you may be able to obtain informal, unofficial assistance at the [http://forums3.armagetronad.net/viewforum.php?f=49 Armagetron support forums] or the [https://www.phpbb.com/support/ phpbb website].''

	===You will need:===		=====You will need=====
	* Access to FTP or a file manager		* Access to FTP or a file manager
	* Access to your mysql database		* Access to your mysql database
Line 14:		Line 14:
	For this project, we're going to use the simpler php version of the auth that was edited by fman23, which can be found at [https://github.com/fkmclane/ArmaAuth his launchpad directory]. Go ahead and copy "Config" and "index", and put them somewhere safe.		For this project, we're going to use the simpler php version of the auth that was edited by fman23, which can be found at [https://github.com/fkmclane/ArmaAuth his launchpad directory]. Go ahead and copy "Config" and "index", and put them somewhere safe.

	===Step Two===		=====Step Two=====
	We're going to have to edit that config file to make it play nice with a mysql installation. Find the line that talks about the login information table. Edit the file so that it looks more like the following:		We're going to have to edit that config file to make it play nice with a mysql installation. Find the line that talks about the login information table. Edit the file so that it looks more like the following:

Line 32:		Line 32:


	===Step Three===		=====Step Three=====
	Whilst we still have the config open, we're going to amend all the columns to match our database. For example: Your "user" column may be represented by "user", "php_user", "phpbb"user", etc. Make sure everything matches up. Save and close.		Whilst we still have the config open, we're going to amend all the columns to match our database. For example: Your "user" column may be represented by "user", "php_user", "phpbb"user", etc. Make sure everything matches up. Save and close.

	===Step Four===		=====Step Four=====
	We need to edit the files in your phpbb installation to enable your forum users passwords to be stored in md5. Go to the root of your ftp folder (public_html), and find the following path:		We need to edit the files in your phpbb installation to enable your forum users passwords to be stored in md5. Go to the root of your ftp folder (public_html), and find the following path:

Line 51:		Line 51:
	Save and close.		Save and close.

	===Step Five===		=====Step Five=====
	Go back to the root of your phpbb installation and create the following folder path:		Go back to the root of your phpbb installation and create the following folder path:

Line 58:		Line 58:
	Now, upload the config and index files from earlier into the 0.1 folder, and exit.		Now, upload the config and index files from earlier into the 0.1 folder, and exit.

	===Step Six===		=====Step Six=====
	Now, logout of the forum, login again, and request a password change. Change it to whatever, you can change it back to whatever was your previous password if you want to. For this to work, however, you must change the password at least once, for all users.		Now, logout of the forum, login again, and request a password change. Change it to whatever, you can change it back to whatever was your previous password if you want to. For this to work, however, you must change the password at least once, for all users.

Delinquent: /* Step One */

2020-07-24T14:16:38Z

Step One

← Older revision		Revision as of 10:16, 24 July 2020
Line 11:		Line 11:
	* Access to your mysql database		* Access to your mysql database

	===Step One===		=====Step One=====
	For this project, we're going to use the simpler php version of the auth that was edited by fman23, which can be found at [https://github.com/fkmclane/ArmaAuth his launchpad directory]. Go ahead and copy "Config" and "index", and put them somewhere safe.		For this project, we're going to use the simpler php version of the auth that was edited by fman23, which can be found at [https://github.com/fkmclane/ArmaAuth his launchpad directory]. Go ahead and copy "Config" and "index", and put them somewhere safe.

Delinquent: Fixed formatting

2020-07-24T14:15:16Z

Fixed formatting

← Older revision		Revision as of 10:15, 24 July 2020
Line 7:		Line 7:
	''Note: This guide was written specifically for phpbb3 only. Other/older variants of phpbb may not work, and you risk damaging your forum build. The editors of the wiki take no responsibility for the advice contained herein, although you may be able to obtain informal, unofficial assistance at the [http://forums3.armagetronad.net/viewforum.php?f=49 Armagetron support forums] or the [https://www.phpbb.com/support/ phpbb website].''		''Note: This guide was written specifically for phpbb3 only. Other/older variants of phpbb may not work, and you risk damaging your forum build. The editors of the wiki take no responsibility for the advice contained herein, although you may be able to obtain informal, unofficial assistance at the [http://forums3.armagetronad.net/viewforum.php?f=49 Armagetron support forums] or the [https://www.phpbb.com/support/ phpbb website].''

	~~'''~~You will need:~~'''~~		===You will need:===
	* Access to FTP or a file manager		* Access to FTP or a file manager
	* Access to your mysql database		* Access to your mysql database

	~~'''~~Step One~~'''~~		===Step One===
	For this project, we're going to use the simpler php version of the auth that was edited by fman23, which can be found at [https://github.com/fkmclane/ArmaAuth his launchpad directory]. Go ahead and copy "Config" and "index", and put them somewhere safe.		For this project, we're going to use the simpler php version of the auth that was edited by fman23, which can be found at [https://github.com/fkmclane/ArmaAuth his launchpad directory]. Go ahead and copy "Config" and "index", and put them somewhere safe.

	~~'''~~Step Two~~'''~~		===Step Two===
	We're going to have to edit that config file to make it play nice with a mysql installation. Find the line that talks about the login information table. Edit the file so that it looks more like the following:		We're going to have to edit that config file to make it play nice with a mysql installation. Find the line that talks about the login information table. Edit the file so that it looks more like the following:

Line 31:		Line 31:
	'role_col' => 'group_id',</pre>		'role_col' => 'group_id',</pre>

	~~Change "Host", "User", "Pass" and "Database" to the values that match your website.~~

	~~'''~~Step Three~~'''~~		===Step Three===
	Whilst we still have the config open, we're going to amend all the columns to match our database. For example: Your "user" column may be represented by "user", "php_user", "phpbb"user", ~~and so on~~. Make sure everything matches up. Save and close.		Whilst we still have the config open, we're going to amend all the columns to match our database. For example: Your "user" column may be represented by "user", "php_user", "phpbb"user", etc. Make sure everything matches up. Save and close.

	~~'''~~Step Four~~'''~~		===Step Four===
	We need to edit the files in your phpbb installation to enable your forum users passwords to be stored in md5. Go to the root of your ftp folder (public_html), and find the following path:		We need to edit the files in your phpbb installation to enable your forum users passwords to be stored in md5. Go to the root of your ftp folder (public_html), and find the following path:

Line 52:		Line 51:
	Save and close.		Save and close.

	~~'''~~Step Five~~'''~~		===Step Five===
	Go back to the root of your phpbb installation and create the following folder path:		Go back to the root of your phpbb installation and create the following folder path:

Line 59:		Line 58:
	Now, upload the config and index files from earlier into the 0.1 folder, and exit.		Now, upload the config and index files from earlier into the 0.1 folder, and exit.

	~~'''~~Step Six~~'''~~		===Step Six===
	Now, logout of the forum, login again, and request a password change. Change it to whatever, you can change it back to whatever was your previous password if you want to. For this to work, however, you must change the password at least once, for all users.		Now, logout of the forum, login again, and request a password change. Change it to whatever, you can change it back to whatever was your previous password if you want to. For this to work, however, you must change the password at least once, for all users.

Delinquent at 14:12, 24 July 2020

2020-07-24T14:12:51Z

← Older revision		Revision as of 10:12, 24 July 2020
Line 10:		Line 10:
	* Access to FTP or a file manager		* Access to FTP or a file manager
	* Access to your mysql database		* Access to your mysql database
	* A degree of patience, this will almost definitely not work first time.

	'''Step One'''		'''Step One'''

Delinquent: Removed some of my poor attempts at humour which were out of keeping with the rest of the article

2020-07-24T14:12:19Z

Removed some of my poor attempts at humour which were out of keeping with the rest of the article

← Older revision		Revision as of 10:12, 24 July 2020
Line 16:		Line 16:

	'''Step Two'''		'''Step Two'''
	We're going to have to edit that config file~~, just~~ to make it play nice with a mysql installation. ~~Open it up and find~~ the line that talks about the login information table. Edit the file so that it looks more like the following:		We're going to have to edit that config file to make it play nice with a mysql installation. Find the line that talks about the login information table. Edit the file so that it looks more like the following:

	<pre>//Table containing login information		<pre>//Table containing login information
Line 32:		Line 32:
	'role_col' => 'group_id',</pre>		'role_col' => 'group_id',</pre>

	~~It's probably a good idea to refrain from copy/pasting, syntax and formatting does not always copy with the selected text.~~		Change "Host", "User", "Pass" and "Database" to the values that match your website.

	~~Whilst you're knee deep in confusion, go ahead and change~~ "Host", "User", "Pass" and "Database" to the values that match your website.

	'''Step Three'''		'''Step Three'''
	Whilst we still have the config open, we're going to amend all the columns to match our database. For example: Your "user" column may be represented by "user", "php_user", "phpbb"user", ~~you get the picture~~. Make sure everything matches up. Save and close.		Whilst we still have the config open, we're going to amend all the columns to match our database. For example: Your "user" column may be represented by "user", "php_user", "phpbb"user", and so on. Make sure everything matches up. Save and close.

	'''Step Four'''		'''Step Four'''
	~~Here comes the scary bit.~~ We~~'re going~~ to edit the files in your phpbb installation to enable your forum users passwords to be stored in md5. Go to the root of your ftp folder (public_html), and find the following path:		We need to edit the files in your phpbb installation to enable your forum users passwords to be stored in md5. Go to the root of your ftp folder (public_html), and find the following path:

	<pre>/includes/functions.php</pre>		<pre>/includes/functions.php</pre>
Line 65:		Line 63:
	Now, logout of the forum, login again, and request a password change. Change it to whatever, you can change it back to whatever was your previous password if you want to. For this to work, however, you must change the password at least once, for all users.		Now, logout of the forum, login again, and request a password change. Change it to whatever, you can change it back to whatever was your previous password if you want to. For this to work, however, you must change the password at least once, for all users.

	~~Open up your arma client, and see if you can login. For extra merit, cross your fingers. For even more good luck, cut off a rabbit's foot and hang it precariously over your PC.~~

	= Understanding the requirements of an Authentication server =		= Understanding the requirements of an Authentication server =

Delinquent: Added disclaimer and shameless plug

2014-02-20T18:18:04Z

Added disclaimer and shameless plug

← Older revision		Revision as of 14:18, 20 February 2014
Line 1:		Line 1:
	{{Sections}}		{{Sections}}

	= How to run a ~~phpbb~~ forum based Authentication Server =		= How to run a phpbb3 forum based Authentication Server =

	''Credits to fman23 and Lover$boy''		''Credits to fman23 and Lover$boy''

			''Note: This guide was written specifically for phpbb3 only. Other/older variants of phpbb may not work, and you risk damaging your forum build. The editors of the wiki take no responsibility for the advice contained herein, although you may be able to obtain informal, unofficial assistance at the [http://forums3.armagetronad.net/viewforum.php?f=49 Armagetron support forums] or the [https://www.phpbb.com/support/ phpbb website].''

	'''You will need:'''		'''You will need:'''

Delinquent: Changed second title to reflect differences between basic guide and advanced properties.

2014-02-20T10:42:48Z

Changed second title to reflect differences between basic guide and advanced properties.

← Older revision		Revision as of 06:42, 20 February 2014
Line 65:		Line 65:
	Open up your arma client, and see if you can login. For extra merit, cross your fingers. For even more good luck, cut off a rabbit's foot and hang it precariously over your PC.		Open up your arma client, and see if you can login. For extra merit, cross your fingers. For even more good luck, cut off a rabbit's foot and hang it precariously over your PC.

	= ~~How to run~~ an Authentication ~~Server~~ =		= Understanding the requirements of an Authentication server =

	Have a look at [[Hash Authentication Design\|the protocol]] to see what is expected of an Authentication Server. Game servers will issue HTTP requests to it with		Have a look at [[Hash Authentication Design\|the protocol]] to see what is expected of an Authentication Server. Game servers will issue HTTP requests to it with

Delinquent: /* How to run a forum based Authentication Server */

2014-02-20T10:39:14Z

How to run a forum based Authentication Server

← Older revision		Revision as of 06:39, 20 February 2014
Line 1:		Line 1:
	{{Sections}}		{{Sections}}

	= How to run a forum based Authentication Server =		= How to run a phpbb forum based Authentication Server =

	''Credits to fman23 and Lover$boy''		''Credits to fman23 and Lover$boy''