Sample code for 30+ languages & platforms
C Requires Chilkat v11.6.0+

Hash a Password with Argon2 (Tuned Options)

Demonstrates Crypt2.Argon2HashPassword with explicit options: the cost parameters, saltLen (how many random salt bytes to generate when no salt is given), and an optional secret (pepper).

Background. For hashing, the salt is optional — when omitted, a random salt of saltLen bytes (default 16) is generated, which is the normal case. A secret or ad is not stored in the PHC string; the same values must be supplied to Argon2VerifyPassword for the password to verify.

Chilkat C Downloads

C
#include <C_CkCrypt2.h>
#include <C_CkJsonObject.h>

void ChilkatSample(void)
    {
    HCkCrypt2 crypt;
    const char *password;
    HCkJsonObject json;
    const char *phcHash;

    crypt = CkCrypt2_Create();

    //  The password should come from a secure source rather than being hard-coded.
    password = "correct horse battery staple";

    //  The Argon2 options are the same members as Argon2DeriveKey, except the salt is optional for
    //  hashing.  When no "salt" is given, a random salt is generated; "saltLen" (default 16, range 8..1024)
    //  sets how many random bytes to use.
    json = CkJsonObject_Create();
    CkJsonObject_UpdateString(json,"variant","argon2id");
    CkJsonObject_UpdateInt(json,"memoryCostKb",131072);
    CkJsonObject_UpdateInt(json,"iterations",4);
    CkJsonObject_UpdateInt(json,"parallelism",2);
    CkJsonObject_UpdateInt(json,"saltLen",16);

    //  A secret (pepper) and/or ad may be used, but neither is stored in the returned PHC string.  The
    //  same values must be supplied to Argon2VerifyPassword for the password to verify.
    CkJsonObject_UpdateString(json,"secret","application-wide-pepper");
    CkJsonObject_UpdateString(json,"secretEncoding","utf-8");

    phcHash = CkCrypt2_argon2HashPassword(crypt,password,CkJsonObject_emit(json));
    if (CkCrypt2_getLastMethodSuccess(crypt) == FALSE) {
        printf("%s\n",CkCrypt2_lastErrorText(crypt));
        CkCrypt2_Dispose(crypt);
        CkJsonObject_Dispose(json);
        return;
    }

    printf("%s\n",phcHash);


    CkCrypt2_Dispose(crypt);
    CkJsonObject_Dispose(json);

    }