Changeset 102294 in vbox

Timestamp:

Nov 24, 2023 1:40:35 PM (12 months ago)

Author:

vboxsync

Message:

IPRT: Implemented SHA-crypt 256 / 512 variants, along with testcases. Needed for password hashing in cloud-init-based Linux installers [docs fixes]. bugref:10551

Location:

trunk

Files:

• include/iprt/crypto/shacrypt.h (modified) (4 diffs)
• src/VBox/Runtime/common/crypto/shacrypt.cpp (modified) (4 diffs)

trunk/include/iprt/crypto/shacrypt.h

@@ -60 +60 @@
  *                              Must be >= RT_SHACRYPT_MIN_SALT_LEN and <= RT_SHACRYPT_MAX_SALT_LEN.
  * @param   cRounds             Number of rounds to use.
- * @param   pabHash             Where to return the hash on success.
+ * @param   abHash              Where to return the hash on success.
  *
  * @note    This implements SHA-crypt.txt Version: 0.6 2016-8-31.
  */
-RTR3DECL(int) RTShaCrypt256(const char *pszKey, const char *pszSalt, uint32_t cRounds, uint8_t pabHash[RTSHA256_HASH_SIZE]);
+RTR3DECL(int) RTShaCrypt256(const char *pszKey, const char *pszSalt, uint32_t cRounds, uint8_t abHash[RTSHA256_HASH_SIZE]);
 
 /**
@@ -70 +70 @@
  *
  * @returns VBox status code.
- * @param   pabHash             SHAcrypt (SHA-256) digest to return printable scheme for.
+ * @param   abHash              SHAcrypt (SHA-256) digest to return printable scheme for.
  * @param   pszSalt             Salt to use. Must match the salt used when generating \a pabHash via RTSha256Crypt().
  * @param   cRounds             Number of rounds used for generating \a pabHash.
@@ -89 +89 @@
  *                              Must be >= RT_SHACRYPT_MIN_SALT_LEN and <= RT_SHACRYPT_MAX_SALT_LEN.
  * @param   cRounds             Number of rounds to use.
- * @param   pabHash             Where to return the hash on success.
+ * @param   abHash              Where to return the hash on success.
  *
  * @note    This implements SHA-crypt.txt Version: 0.6 2016-8-31.
  */
-RTR3DECL(int) RTShaCrypt512(const char *pszKey, const char *szSalt, uint32_t cRounds, uint8_t pabHash[RTSHA512_HASH_SIZE]);
+RTR3DECL(int) RTShaCrypt512(const char *pszKey, const char *pszSalt, uint32_t cRounds, uint8_t abHash[RTSHA512_HASH_SIZE]);
 
 
@@ -100 +100 @@
  *
  * @returns VBox status code.
- * @param   pabHash             SHAcrypt (SHA-512) digest to return printable scheme for.
+ * @param   abHash              SHAcrypt (SHA-512) digest to return printable scheme for.
  * @param   pszSalt             Salt to use. Must match the salt used when generating \a pabHash via RTSha512Crypt().
  * @param   cRounds             Number of rounds used for generating \a pabHash.

trunk/src/VBox/Runtime/common/crypto/shacrypt.cpp

@@ -48 +48 @@
 
 
-RTR3DECL(int) RTShaCrypt256(const char *pszKey, const char *pszSalt, uint32_t cRounds, uint8_t pabHash[RTSHA256_HASH_SIZE])
+RTR3DECL(int) RTShaCrypt256(const char *pszKey, const char *pszSalt, uint32_t cRounds, uint8_t abHash[RTSHA256_HASH_SIZE])
 {
     AssertPtrReturn(pszKey,   VERR_INVALID_POINTER);
@@ -159 +159 @@
     }
 
-    memcpy(pabHash, abDigest, RTSHA256_HASH_SIZE);
+    memcpy(abHash, abDigest, RTSHA256_HASH_SIZE);
 
     RTMemWipeThoroughly(abDigestTemp, RTSHA256_HASH_SIZE, 3);
@@ -222 +222 @@
 
 
-RTR3DECL(int) RTShaCrypt512(const char *pszKey, const char *pszSalt, uint32_t cRounds, uint8_t pabHash[RTSHA512_HASH_SIZE])
+RTR3DECL(int) RTShaCrypt512(const char *pszKey, const char *pszSalt, uint32_t cRounds, uint8_t abHash[RTSHA512_HASH_SIZE])
 {
     AssertPtrReturn(pszKey,   VERR_INVALID_POINTER);
@@ -333 +333 @@
     }
 
-    memcpy(pabHash, abDigest, RTSHA512_HASH_SIZE);
+    memcpy(abHash, abDigest, RTSHA512_HASH_SIZE);
 
     RTMemWipeThoroughly(abDigestTemp, RTSHA512_HASH_SIZE, 3);