0Kamil/samp-argon2

SampArgon2

A argon2 plugin for samp in Rust.

Installation

• Download suitable binary files from releases for your operating system
• Add it your plugins folder
• Add samp_argon2.dll (for windows) or samp_argon2.so (for linux) to server.cfg
• Add samp_argon2.inc in includes folder

API

• argon2_hash(playerid, const callback[], const pass[], const salt[], variant, mem_cost, time_cost, lanes, hash_length, const args[] = "", {Float, _}:...)

  • playerid - id of the player
  • callback[] - callback to execute after hashing
  • pass[] - string to hash
  • salt[] - string to salt
  • variant - set variant
  • mem_cost - set mem cost
  • time_cost - set time cost
  • lanes - set lanes
  • hash_length - set hash length
  • args[] - custom arguments

  Example

  main()
  {
  	argon2_hash(0, "OnPasswordHash", "password", "somesalt", VARIANT_ARGON2I, 4096, 3, 1, 32);
  }
  
  forward OnPasswordHash(playerid);
  public OnPasswordHash(playerid)
  {
  	//hashing completed
  }
  

• argon2_get_hash(const hash[], size = sizeof(hash))

  • hash[] - string to store hashed data
  • size - max size of hash string

  Example

  main()
  {
  	argon2_hash(0, "OnPasswordHash", "password", "somesalt", VARIANT_ARGON2I, 4096, 3, 1, 32);
  }
  
  forward OnPasswordHash(playerid);
  public OnPasswordHash(playerid)
  {
  	new hash[85];
  	argon2_get_hash(hash);
  	printf("Hash: %s", hash);
  }
  

• argon2_verify(playerid, const callback[], const pass[], const hash[], const args[] = "", {Float, _}:...)

  • playerid - id of the player
  • callback[] - callback to execute after hashing
  • pass[] - text to compare with hash
  • hash[] - hash to compare with text
  • args[] - custom arguments

  Example

  main()
  {
  	argon2_hash(0, "OnPasswordHash", "password", "somesalt", VARIANT_ARGON2I, 4096, 3, 1, 32);
  }
  
  forward OnPasswordHash(playerid);
  public OnPasswordHash(playerid)
  {
  	new hash[85];
  	argon2_get_hash(hash);
  	argon2_verify(playerid, "OnPasswordVerify", "password", hash);
  }
  
  forward OnPasswordVerify(playerid, bool:success);
  public OnPasswordVerify(playerid, bool:success)
  {
  	//success denotes verifying was successful or not
  	if(success)
  	{
  		//verfied
  	}
  	else
  	{
  		//hash doesn't match with text
  	}
  }