1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60
|
//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftCrypto open source project
//
// Copyright (c) 2019-2021 Apple Inc. and the SwiftCrypto project authors
// Licensed under Apache License v2.0
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.md for the list of SwiftCrypto project authors
//
// SPDX-License-Identifier: Apache-2.0
//
//===----------------------------------------------------------------------===//
#if CRYPTO_IN_SWIFTPM && !CRYPTO_IN_SWIFTPM_FORCE_BUILD_API
@_exported import CryptoKit
#else
import Foundation
#if !CRYPTO_IN_SWIFTPM_FORCE_BUILD_API
typealias AESWRAPImpl = CoreCryptoAESWRAPImpl
#else
typealias AESWRAPImpl = BoringSSLAESWRAPImpl
#endif
extension AES {
/// An implementation of AES Key Wrapping in accordance with the IETF RFC
/// 3394 specification.
public enum KeyWrap {
/// Wraps a key using the AES wrap algorithm.
///
/// Wrap is an implementation of the AES key wrap algorithm as specified
/// in IETF RFC 3394.
///
/// - Parameters:
/// - keyToWrap: The key to wrap.
/// - kek: The key encryption key.
///
/// - Returns: The wrapped key.
public static func wrap(_ keyToWrap: SymmetricKey, using kek: SymmetricKey) throws -> Data {
return try AESWRAPImpl.wrap(key: kek, keyToWrap: keyToWrap)
}
/// Unwraps a key using the AES wrap algorithm.
///
/// Wrap is an implementation of the AES key wrap algorithm as specified
/// in IETF RFC 3394. The method throws an error is the key was
/// incorrectly wrapped.
///
/// - Parameters:
/// - wrappedKey: The key to unwrap.
/// - kek: The key encryption key.
///
/// - Returns: The unwrapped key.
public static func unwrap<WrappedKey: DataProtocol>(_ wrappedKey: WrappedKey, using kek: SymmetricKey) throws -> SymmetricKey {
return try AESWRAPImpl.unwrap(key: kek, wrappedKey: wrappedKey)
}
}
}
#endif // Linux or !SwiftPM
|