class Sodium::CryptoBox::SecretKey

• Sodium::CryptoBox::SecretKey
• Sodium::Key
• Reference
• Object

Overview

You may either send encrypted signed messages using "Authenticated encryption" or encrypt unsigned messages using "Sealed Boxes".

For signing without encryption see Sodium::Sign::SecretKey.

Authenticated encryption

https://libsodium.gitbook.io/doc/public-key_cryptography/authenticated_encryption

Usage:

bob = Sodium::CryptoBox::SecretKey.new
alice = Sodium::CryptoBox::SecretKey.new
message = "hi"

# Encrypt and sign a message from bob to alice's public_key
bob.box alice.public_key do |box|
  ciphertext = box.encrypt message
end

Sealed Boxes

https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes

Usage:

secret_key = Sodium::CryptoBox::SecretKey.new
public_key = secret_key.public_key

ciphertext = public_key.encrypt message
secret_key.decrypt ciphertext

Defined in:

sodium/crypto_box/secret_key.cr

Constant Summary

KEY_SIZE = LibSodium.crypto_box_secretkeybytes.to_i

SEAL_SIZE = LibSodium.crypto_box_sealbytes.to_i

SEED_SIZE = LibSodium.crypto_box_seedbytes.to_i

Constructors

• .new(sbuf : SecureBuffer, pkey : Bytes? = nil)

  Use existing secret and public keys.

• .new(bytes : Bytes, pkey : Bytes? = nil)

  Use existing secret and public keys.

• .new

  Generate a new random secret/public key pair.

• .new(*, seed : Bytes, erase = false)

  Derive a new secret/public key pair based on a consistent seed.

• .new(*, seed : SecureBuffer)

  Derive a new secret/public key pair based on a consistent seed.

Instance Method Summary

• #box(public_key) : CryptoBox

  Return a Box containing a precomputed shared secret for use with authenticated encryption/decryption.

• #box(public_key, &)

  Create a new box and automatically close when the block exits.

• #decrypt(src, dst : Bytes? = nil) : Bytes

  Anonymously receive messages without a signature.

• #decrypt_string(src, dst : Bytes? = nil) : String

  Anonymously receive messages without a signature.

• #public_key : PublicKey
• #seed
• #to_slice : Bytes

  Returns key

Constructor Detail

Instance Method Detail