PasswordHash - Revision history

Lettify: indexed page with portuguese version

2022-05-21T20:31:29Z

indexed page with portuguese version

← Older revision		Revision as of 20:31, 21 May 2022
Line 85:		Line 85:
	==See Also==		==See Also==
	{{Utility functions}}		{{Utility functions}}
			[[pt-br:passwordHash]]

Qaisjp: tweak text

2020-01-13T01:16:47Z

tweak text

← Older revision		Revision as of 01:16, 13 January 2020
Line 27:		Line 27:
	** ''salt'' (string), default: empty string		** ''salt'' (string), default: empty string
	*** an empty string will automatically generate a salt with the ''cost'' provided		*** an empty string will automatically generate a salt with the ''cost'' provided
	*** '''deprecated''': if a string is provided, it will be used as a salt ('''~~only~~ do this ~~if you know what you're doing~~!''')		*** '''deprecated''': if a string is provided, it will be used as a salt ('''do not do this!''')
	*** the provided string should be longer than or equal to 22 characters		*** the provided string should be longer than or equal to 22 characters

Qaisjp: remove extra bullet

2020-01-13T01:06:20Z

remove extra bullet

← Older revision		Revision as of 01:06, 13 January 2020
Line 29:		Line 29:
	*** '''deprecated''': if a string is provided, it will be used as a salt ('''only do this if you know what you're doing!''')		*** '''deprecated''': if a string is provided, it will be used as a salt ('''only do this if you know what you're doing!''')
	*** the provided string should be longer than or equal to 22 characters		*** the provided string should be longer than or equal to 22 characters
	~~***~~

	===Returns===		===Returns===

Qaisjp: update use of salt param

2020-01-13T01:05:49Z

update use of salt param

← Older revision		Revision as of 01:05, 13 January 2020
Line 25:		Line 25:
	* ''bcrypt'':		* ''bcrypt'':
	** ''cost'' (int), default: 10. Visit [http://security.stackexchange.com/questions/17207/recommended-of-rounds-for-bcrypt this link] to determine the number of rounds appropriate for your server.		** ''cost'' (int), default: 10. Visit [http://security.stackexchange.com/questions/17207/recommended-of-rounds-for-bcrypt this link] to determine the number of rounds appropriate for your server.
	** ''salt'' (string), default: ~~automatically generate salt~~		** ''salt'' (string), default: empty string
	*** an empty string will automatically generate a salt with the ''cost'' provided		*** an empty string will automatically generate a salt with the ''cost'' provided
	*** if a string is provided, ~~the given~~ salt ~~is used~~ (~~do not~~ do this!)		*** '''deprecated''': if a string is provided, it will be used as a salt ('''only do this if you know what you're doing!''')
	*** the provided string should be longer or equal ~~than~~ 22 characters		*** the provided string should be longer than or equal to 22 characters
			***

	===Returns===		===Returns===

Qaisjp: prefer normal note

2019-09-07T08:29:53Z

prefer normal note

← Older revision		Revision as of 08:29, 7 September 2019
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Shared function}}		{{Shared function}}
	{{Note ~~box~~\|Using '''passwordHash''' is the recommended way of storing passwords.}}		{{Note\|Using '''passwordHash''' is the recommended way of storing passwords.}}
	{{New feature/item\|3.0154\|1.5.4\|11277\|		{{New feature/item\|3.0154\|1.5.4\|11277\|
	This function creates a new password hash using a specified hashing algorithm.		This function creates a new password hash using a specified hashing algorithm.

Myonlake at 23:31, 4 August 2018

2018-08-04T23:31:42Z

← Older revision		Revision as of 23:31, 4 August 2018
Line 9:		Line 9:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	string passwordHash ( string password, string algorithm, table options ~~= {}~~ [, function callback ])		string passwordHash ( string password, string algorithm, table options [, function callback ] )
	</syntaxhighlight>		</syntaxhighlight>

Line 37:		Line 37:
	This example makes use of [https://wiki.multitheftauto.com/wiki/PasswordHash passwordHash] and [https://wiki.multitheftauto.com/wiki/PasswordVerify passwordVerify] in account creation and account login to boost up security.		This example makes use of [https://wiki.multitheftauto.com/wiki/PasswordHash passwordHash] and [https://wiki.multitheftauto.com/wiki/PasswordVerify passwordVerify] in account creation and account login to boost up security.
	<section name="Example 1" class="server" show="true">		<section name="Example 1" class="server" show="true">
	* Use '''</accountCreate [username] [password]>''' to create an account.		* Use '''/accountCreate [username] [password]''' to create an account.
	* Use '''</accountLogin [username] [password]>''' to login in account.		* Use '''/accountLogin [username] [password]''' to login in account.
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	-- lets add command handler that will handle the account creation		-- lets add command handler that will handle the account creation
	addCommandHandler("accountCreate",function(source,cmd,username,password)		addCommandHandler("accountCreate",function(source,cmd,username,password)
	if (username and password) then		if (username and password) then
	local hashedPassword = passwordHash(password,"bcrypt") -- create new hash for password		local hashedPassword = passwordHash(password,"bcrypt",{}) -- create new hash for password
	if (hashedPassword) then -- check if hash has been generated		if (hashedPassword) then -- check if hash has been generated
	local account = addAccount(username,hashedPassword) -- now lets add account with new hash what we got when we made it for password.		local account = addAccount(username,hashedPassword) -- now lets add account with new hash what we got when we made it for password.

Skully: Updated options parameter to be required.

2018-02-19T19:53:02Z

Updated options parameter to be required.

← Older revision		Revision as of 19:53, 19 February 2018
Line 9:		Line 9:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	string passwordHash ( string password, string algorithm [, table options = {} ][, function callback ])		string passwordHash ( string password, string algorithm, table options = {} [, function callback ])
	</syntaxhighlight>		</syntaxhighlight>

Line 16:		Line 16:
	*'''algorithm:''' The algorithm to use:		*'''algorithm:''' The algorithm to use:
	** ''bcrypt'': use the bcrypt hashing algorithm. Hash length: 60 characters. <span style="color:red">Note that only the prefix ''$2y$'' is supported (older prefixes can cause security issues).</span>		** ''bcrypt'': use the bcrypt hashing algorithm. Hash length: 60 characters. <span style="color:red">Note that only the prefix ''$2y$'' is supported (older prefixes can cause security issues).</span>
			*'''options:''' table with options for the hashing algorithm, as detailed below.

	===Optional Arguments===		===Optional Arguments===
	*'''options:''' table with options for the hashing algorithm, as detailed below
	{{New feature/item\|3.0154\|1.5.4\|11281\|		{{New feature/item\|3.0154\|1.5.4\|11281\|
	*'''callback:''' providing a callback will run this function asynchronously, the arguments to the callback are the same as the returned values below.		*'''callback:''' providing a callback will run this function asynchronously, the arguments to the callback are the same as the returned values below.

LordHenry: /* Example */

2017-09-07T21:14:49Z

Example

← Older revision		Revision as of 21:14, 7 September 2017
Line 77:		Line 77:
	end		end
	else		else
	outputChatBox("Wrong parameters! Correct Syntax </~~accountCreate~~ [username] [password]>",source,160,20,20)		outputChatBox("Wrong parameters! Correct Syntax </accountLogin [username] [password]>",source,160,20,20)
	end		end
	end);		end);

Jusonex at 15:19, 14 May 2017

2017-05-14T15:19:02Z

← Older revision		Revision as of 15:19, 14 May 2017
Line 15:		Line 15:
	*'''password:''' The password to hash.		*'''password:''' The password to hash.
	*'''algorithm:''' The algorithm to use:		*'''algorithm:''' The algorithm to use:
	** ''bcrypt'': use the bcrypt hashing algorithm. Hash length: 60 characters.		** ''bcrypt'': use the bcrypt hashing algorithm. Hash length: 60 characters. <span style="color:red">Note that only the prefix ''$2y$'' is supported (older prefixes can cause security issues).</span>

	===Optional Arguments===		===Optional Arguments===

AlexTMjugador: Typos

2017-05-01T16:55:52Z

Typos

← Older revision		Revision as of 16:55, 1 May 2017
Line 15:		Line 15:
	*'''password:''' The password to hash.		*'''password:''' The password to hash.
	*'''algorithm:''' The algorithm to use:		*'''algorithm:''' The algorithm to use:
	** ''bcrypt'': use the bcrypt hashing algorithm~~, lenght~~: 60 ~~chars~~.		** ''bcrypt'': use the bcrypt hashing algorithm. Hash length: 60 characters.

	===Optional Arguments===		===Optional Arguments===
Line 28:		Line 28:
	*** an empty string will automatically generate a salt with the ''cost'' provided		*** an empty string will automatically generate a salt with the ''cost'' provided
	*** if a string is provided, the given salt is used (do not do this!)		*** if a string is provided, the given salt is used (do not do this!)
	*** string should be longer or equal 22 ~~chars~~		*** the provided string should be longer or equal than 22 characters

	===Returns===		===Returns===