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

RSA

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

interface RSA<PublicK : RSA.PublicKey, PrivateK : RSA.PrivateKey<PublicK>, KP : RSA.KeyPair<PublicK, PrivateK>> : CryptographyAlgorithm(source)

RSA asymmetric cryptography algorithm as defined in RFC 8017.

RSA provides public-key encryption and digital signatures based on the difficulty of factoring large integers. Multiple padding schemes are available:

OAEP — authenticated encryption (recommended for new applications).
PSS — probabilistic signatures (recommended for new applications).
PKCS1 — legacy encryption and signatures.
RAW — unpadded operations (unsafe for general use).

Inheritors

Types

KeyPair

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

interface KeyPair<PublicK : RSA.PublicKey, PrivateK : RSA.PrivateKey<PublicK>>

OAEP

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

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

RSA with Optimal Asymmetric Encryption Padding (OAEP) as defined in RFC 8017 Section 7.1.

PKCS1

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

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

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

PrivateKey

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

interface PrivateKey<PublicK : RSA.PublicKey> : Encodable<RSA.PrivateKey.Format> , PublicKeyAccessor<PublicK>

PSS

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

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

RSA Probabilistic Signature Scheme (PSS) as defined in RFC 8017 Section 8.1.

PublicKey

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

interface PublicKey : Encodable<RSA.PublicKey.Format>

RAW

@DelicateCryptographyApi

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

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

Raw RSA without padding (textbook RSA).

Properties

abstract val id: CryptographyAlgorithmId<*>

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<KP>

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

privateKeyDecoder

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

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, PublicK>

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