Added _kdf_ all implementations and a simple and probably pointless test, also noted which functions are not available as they are not part of LazySodium

This commit is contained in:
Ugljesa Jovanovic committed 2020-09-16 14:09:14 +02:00
1 parent 5c387545ab
commit 8b26764938
7 files changed
+262 -29

No files matched your search

@@ -0,0 +1,66 @@
package com.ionspin.kotlin.crypto.kdf
import com.ionspin.kotlin.crypto.util.encodeToUByteArray
import com.ionspin.kotlin.crypto.util.toPtr
import kotlinx.cinterop.addressOf
import kotlinx.cinterop.convert
import kotlinx.cinterop.pin
import libsodium.crypto_kdf_derive_from_key
import libsodium.crypto_kdf_keygen
actual object Kdf {
/**
* The crypto_kdf_derive_from_key() function derives a subkey_id-th subkey subkey of length subkey_len bytes using
* the master key key and the context ctx.
* subkey_id can be any value up to (2^64)-1.
* subkey_len has to be between crypto_kdf_BYTES_MIN (inclusive) and crypto_kdf_BYTES_MAX (inclusive).
* Similar to a type, the context ctx is a 8 characters string describing what the key is going to be used for.
* Its purpose is to mitigate accidental bugs by separating domains. The same function used with the same key but
* in two distinct contexts is likely to generate two different outputs.
* Contexts don't have to be secret and can have a low entropy.
* Examples of contexts include UserName, __auth__, pictures and userdata.
* They must be crypto_kdf_CONTEXTBYTES bytes long.
* If more convenient, it is also fine to use a single global context for a whole application. This will still
* prevent the same keys from being mistakenly used by another application.
*/
actual fun deriveFromKey(
subkeyId: Int,
subkeyLength: Int,
context: String,
masterKey: UByteArray
): UByteArray {
val subkey = UByteArray(subkeyLength)
val contextEncoded = context.encodeToByteArray()
val contextEncodedAndPinned = contextEncoded.pin()
val masterKeyPinned = masterKey.pin()
val subkeyPinned = subkey.pin()
crypto_kdf_derive_from_key(
subkeyPinned.toPtr(),
subkeyLength.convert(),
subkeyId.convert(),
contextEncodedAndPinned.addressOf(0),
masterKeyPinned.toPtr()
)
contextEncodedAndPinned.unpin()
masterKeyPinned.unpin()
subkeyPinned.unpin()
return subkey
}
/**
* The crypto_kdf_keygen() function creates a master key.
*/
actual fun keygen(): UByteArray {
val masterKey = UByteArray(crypto_kdf_KEYBYTES)
val masterKeyPinned = masterKey.pin()
crypto_kdf_keygen(masterKeyPinned.toPtr())
masterKeyPinned.unpin()
return masterKey
}
}