cryptography-core/dev.whyoleg.cryptography.algorithms/RSA/PKCS1

PKCS1

@SubclassOptInRequired(markerClass = [CryptographyProviderApi::class])

interface PKCS1 : RSA<RSA.PKCS1.PublicKey, RSA.PKCS1.PrivateKey, RSA.PKCS1.KeyPair> (source)

RSA with PKCS#1 v1.5 padding as defined in RFC 8017 Sections 7.2 and 8.2.

Provides both encryption and digital signatures using the legacy PKCS#1 v1.5 padding scheme.

val keys = provider.get(RSA.PKCS1).keyPairGenerator().generateKey()
val signature = keys.privateKey.signatureGenerator().generateSignature(data)
keys.publicKey.signatureVerifier().verifySignature(data, signature)

Prefer OAEP for encryption and PSS for signatures in new applications.

Types

Companion

object Companion : CryptographyAlgorithmId<RSA.PKCS1>

KeyPair

@SubclassOptInRequired(markerClass = [CryptographyProviderApi::class])

interface KeyPair : RSA.KeyPair<RSA.PKCS1.PublicKey, RSA.PKCS1.PrivateKey>

PrivateKey

@SubclassOptInRequired(markerClass = [CryptographyProviderApi::class])

interface PrivateKey : RSA.PrivateKey<RSA.PKCS1.PublicKey>

An RSA-PKCS1 private key that provides signature generation via signatureGenerator and decryption via decryptor.

PublicKey

@SubclassOptInRequired(markerClass = [CryptographyProviderApi::class])

interface PublicKey : RSA.PublicKey

An RSA-PKCS1 public key that provides signature verification via signatureVerifier and encryption via encryptor.

Properties

open override val id: CryptographyAlgorithmId<RSA.PKCS1>

The typed identifier that uniquely distinguishes this algorithm and is used to look it up from a CryptographyProvider.

Functions

keyPairGenerator

abstract fun keyPairGenerator(keySize: BinarySize = 4096.bits, digest: CryptographyAlgorithmId<Digest> = SHA512, publicExponent: BigInt = 65537.toBigInt()): KeyGenerator<RSA.PKCS1.KeyPair>

Returns a KeyGenerator that generates RSA key pairs with the given parameters.

privateKeyDecoder

abstract fun privateKeyDecoder(digest: CryptographyAlgorithmId<Digest>): Decoder<RSA.PrivateKey.Format, RSA.PKCS1.PrivateKey>

Returns a Decoder that decodes RSA private keys for the given digest from the specified PrivateKey.Format.

publicKeyDecoder

abstract fun publicKeyDecoder(digest: CryptographyAlgorithmId<Digest>): Decoder<RSA.PublicKey.Format, RSA.PKCS1.PublicKey>

Returns a Decoder that decodes RSA public keys for the given digest from the specified PublicKey.Format.