Securely manages encryption keys and stores encrypted key-value pairs. Simplifies key generation, encryption, and storage for building secure applications. Supports saving and retrieving various data types.
Surfaced from shared tags and platforms — no rankings paid for.
KCrypt is a Kotlin Multiplatform Mobile (KMM) library that provides a secure and unified way to manage encryption keys across iOS and Android platforms. It abstracts the complexities of key generation, encryption, and storage, thereby providing you with a unique key that can be used for cryptographic purposes, allowing you to focus on building secure and robust multiplatform applications.
Kcrypt also provides a secured storage where in key-value pairs.
If you want a secure String that you can use for encryption or any other cryptographic reasons, KCrpyt provides you with one. For example: If we take the Realm Kmm library, in order to encrypt the db we need to provide it with a key
val config = RealmConfiguration
.Builder(
schema = setOf(
UserDbEntity::class,
ClipboardDbEntity::class
)
)
.schemaVersion(dbVersion)
.encryptionKey(getKCrypt().getEncryptionKey()!!)
.build()
We need to provide a key to the encryptionKey() method. Here comes KCrypt which provides a unique secure key across Android and iOS, that can be passed to the encryptionKey() method. Similarly, KCrypt can be used for other encryption/cryptographic purposes where one needs an encryption key.
Or
If you want to store data using key value pairs in an encrypted format, KCrypt is here for you. For example: If we want to store a value how we would normally store in encrypted shared preferences or keychain, we can do so as follows:
getKCrypt().saveString("stringVal", "my sample string")
val storedString = getKCrypt().getString("stringVal") // returns "my sample string"
To get started with KCrypt in your KMM project, follow these steps:
build.gradle.kts:// build.gradle.kts in the shared module
kotlin {
sourceSets {
val commonMain by getting {
dependencies {
implementation("io.github.abhriyaroy:KCrypt:0.0.15")
}
}
}
}
// Shared code
import studio.zebro.kcrypt.getKCrypt
val kCrypt = getKCrypt()
// to get encryption key in 64 byte array
val encryptionKeyByteArray : ByteArray = kCrypt.getEncryptionKey()
// to save a custom encryption key
kCrypt.saveEncryptionKey("MyCustomKey", isHexString = false)
// to get encryption key as a String representation of 64 byte array
val encryptionkeyInString : String = kCrypt.getEncryptionKeyToHexString()
convertedByteArrayInString : String = kCrypt.byteArrayToHexString(encryptionKeyByteArray)
convertedStringInByteArray : ByteArray = kCrypt.hexStringToByteArray(encryptionkeyInString)
KCrypt is designed to work with Kotlin Multiplatform Mobile projects targeting both iOS and Android platforms.
Contributions to KCrypt are welcome! Feel free to open issues for feature requests, bug reports, or general discussions. Pull requests are also appreciated.
You can view the latest test reports here.
This project is licensed under the MIT License.
// Shared code
import studio.zebro.kcrypt.getKCrypt
val kCrypt = getKCrypt()
// save string value
kCrypt.saveString("stringVal", "my string")
// retrieve saved string value
kCrypt.getString("stringVal")
// save int value
kCrypt.saveInt("intVal", 101)
// retrieve saved int value
kCrypt.getInt("intVal")
// save float value
kCrypt.saveFloat("floatVal", 100.5f)
// retrieve float value
kCrypt.getFloat("floatVal")
// save double value
kCrypt.saveDouble("doubleVal", 599.4)
// retrieve double value
kCrypt.getDouble("doubleVal")
// save boolean value
kCrypt.saveBoolean("booleanVal", true)
// retrieve boolean value
kCrypt.getBoolean("booleanVal")