SharedSecret

A key agreement result from which you can derive a symmetric cryptographic key.

struct SharedSecret

Mangled symbol

s6Crypto12SharedSecretVWhat are these?

FNV24: [737E3]

Generate a shared secret by calling your private key’s sharedSecretFromKeyAgreement(publicKeyShare:) method with the public key from another party. The other party computes the same secret by passing your public key to the equivalent method on their own private key.

The shared secret isn’t suitable as a symmetric cryptographic key (SymmetricKey) by itself. However, you use it to generate a key by calling either the hkdfDerivedSymmetricKey(using:salt:sharedInfo:outputByteCount:) or x963DerivedSymmetricKey(using:sharedInfo:outputByteCount:) method of the shared secret. After the other party does the same, then you both share a symmetric key suitable for creating a message authentication code like HMAC, or for opening and closing a sealed box with a cipher like ChaChaPoly or AES.

Citizens in Crypto

Conformances

protocol ContiguousBytes
Indicates that the conforming type is a contiguous collection of raw bytes whose underlying storage is directly accessible by withUnsafeBytes.
protocol Copyable
A type whose values can be implicitly or explicitly copied.
protocol CustomStringConvertible
A type with a customized textual representation.
protocol Equatable
A type that can be compared for value equality.
protocol Escapable
protocol Hashable
A type that can be hashed into a Hasher to produce an integer hash value.

Type members

static func == (lhs: `Self`, rhs: `Self`) -> Bool
static func == <D>(lhs: `Self`, rhs: D) -> Bool
Determines whether a shared secret is equivalent to a collection of contiguous bytes.

Instance members

var description: String
func hash(into: inout Hasher)
func hkdfDerivedSymmetricKey<H, Salt, SI>(using: H.Type, salt: Salt, sharedInfo: SI, outputByteCount: Int) -> SymmetricKey
Derives a symmetric encryption key from the secret using HKDF key derivation.
func withUnsafeBytes<R>((UnsafeRawBufferPointer) throws -> R) rethrows -> R
Invokes the given closure with a buffer pointer covering the raw bytes of the shared secret.
func x963DerivedSymmetricKey<H, SI>(using: H.Type, sharedInfo: SI, outputByteCount: Int) -> SymmetricKey
Derives a symmetric encryption key from the secret using x9.63 key derivation.

Type features

static func != (lhs: Self, rhs: Self) -> Bool
Returns a Boolean value indicating whether two values are not equal.