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

PSS

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

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

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

Provides digital signature generation and verification with a probabilistic padding scheme.

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

For the legacy signature padding scheme, see PKCS1.

Types

Companion

object Companion : CryptographyAlgorithmId<RSA.PSS>

KeyPair

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

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

PrivateKey

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

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

An RSA-PSS private key that provides signature generation via signatureGenerator.

PublicKey

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

interface PublicKey : RSA.PublicKey

An RSA-PSS public key that provides signature verification via signatureVerifier.

Properties

open override val id: CryptographyAlgorithmId<RSA.PSS>

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.PSS.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.PSS.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.PSS.PublicKey>

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