# Argon2CheckHash()

Verifies a password against an Argon2 hash. For new code, prefer Argon2Verify() for consistent naming.

**Introduced:** 5.3.8.43

**Requires Extension:** [Crypto Extension](https://download.lucee.org/#17AB52DE-B300-A94B-E058FC978BE4542D)

```
Argon2CheckHash( input=string, hash=string );
```

**Returns:** boolean

# Arguments

| Argument | Type | Required | Description | Default |
|----------|------|----------|-------------|---------|
| input | string | Yes | Input string. |  |
| hash | string | Yes | Argon2 hash to compare against input string |  |

# Usage Notes

Originally provided by the [Argon2 Extension](https://github.com/lucee/extension-argon2) on Lucee 5.3.8.43+ and 6.x, and now also by the Crypto Extension on Lucee 7+ (which replaces it).

For new code, prefer [Argon2Verify()](argon2verify.md) for consistent naming with [BCryptVerify()](bcryptverify.md) and [SCryptVerify()](scryptverify.md).

# Examples

```1
    secret = createUUID();
    dump(var=secret, label="input string");
    
    hashed = generateArgon2Hash(secret);
    dump(var=hashed, label="generateArgon2Hash");
    
    decoded= argon2checkhash(secret, hashed);
    dump(var=decoded, label="argon2checkhash matches");
```







# Categories

[Cryptography](../../categories/crypto.md)

# See Also

[Argon2Hash()](argon2hash.md), [Argon2Verify()](argon2verify.md), [GenerateArgon2Hash()](generateargon2hash.md), [VerifyArgon2Hash()](verifyargon2hash.md)