Files
swift-certificates/Sources/X509/SignatureAlgorithm.swift
T
2022-11-16 15:50:52 +01:00

104 lines
4.5 KiB
Swift

//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftCertificate open source project
//
// Copyright (c) 2022 Apple Inc. and the SwiftCertificate project authors
// Licensed under Apache License v2.0
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.md for the list of SwiftCertificate project authors
//
// SPDX-License-Identifier: Apache-2.0
//
//===----------------------------------------------------------------------===//
extension Certificate {
/// A representation of a kind of signature algorithm.
///
/// X.509 certificates support a wide range of signature algorithms. This type
/// identifies the algorithm, independently of the signature itself.
///
/// This type represents an unbounded enumeration. There are potentially infinite
/// signature algorithms. Users are able to create representations of the signature
/// algorithms this library supports by using static fields on this type.
public struct SignatureAlgorithm {
@usableFromInline
var _algorithmIdentifier: AlgorithmIdentifier
@inlinable
init(algorithmIdentifier: AlgorithmIdentifier) {
switch algorithmIdentifier {
// Per RFC 4055 § 5, we need to accept the RSA parameters field being
// absent, but we must _produce_ the one with an explicit NULL. So we
// normalise the signature algorithm here.
case .sha1WithRSAEncryptionUsingNil:
self._algorithmIdentifier = .sha1WithRSAEncryption
case .sha256WithRSAEncryptionUsingNil:
self._algorithmIdentifier = .sha256WithRSAEncryption
case .sha384WithRSAEncryptionUsingNil:
self._algorithmIdentifier = .sha384WithRSAEncryption
case .sha512WithRSAEncryptionUsingNil:
self._algorithmIdentifier = .sha512WithRSAEncryption
case let identifier:
self._algorithmIdentifier = identifier
}
}
/// This value represents an ECDSA signature using SHA256 and P256.
public static let ecdsaWithSHA256 = Self(algorithmIdentifier: .ecdsaWithSHA256)
/// This value represents an ECDSA signature using SHA384 and P384.
public static let ecdsaWithSHA384 = Self(algorithmIdentifier: .ecdsaWithSHA384)
/// This value represents an ECDSA signature using SHA512 and P521.
public static let ecdsaWithSHA512 = Self(algorithmIdentifier: .ecdsaWithSHA512)
/// This value represents an RSA signature with PKCS1v1.5 padding and SHA1 as the hash function.
public static let sha1WithRSAEncryption = Self(algorithmIdentifier: .sha1WithRSAEncryption)
/// This value represents an RSA signature with PKCS1v1.5 padding and SHA256 as the hash function.
public static let sha256WithRSAEncryption = Self(algorithmIdentifier: .sha256WithRSAEncryption)
/// This value represents an RSA signature with PKCS1v1.5 padding and SHA384 as the hash function.
public static let sha384WithRSAEncryption = Self(algorithmIdentifier: .sha384WithRSAEncryption)
/// This value represents an RSA signature with PKCS1v1.5 padding and SHA521 as the hash function.
public static let sha512WithRSAEncryption = Self(algorithmIdentifier: .sha512WithRSAEncryption)
}
}
extension Certificate.SignatureAlgorithm: Hashable { }
extension Certificate.SignatureAlgorithm: Sendable { }
extension Certificate.SignatureAlgorithm: CustomStringConvertible {
public var description: String {
switch self {
case .ecdsaWithSHA256:
return "SignatureAlgorithm.ecdsaWithSHA256"
case .ecdsaWithSHA384:
return "SignatureAlgorithm.ecdsaWithSHA384"
case .ecdsaWithSHA512:
return "SignatureAlgorithm.ecdsaWithSHA512"
case .sha1WithRSAEncryption:
return "SignatureAlgorithm.sha1WithRSAEncryption"
case .sha256WithRSAEncryption:
return "SignatureAlgorithm.sha256WithRSAEncryption"
case .sha384WithRSAEncryption:
return "SignatureAlgorithm.sha384WithRSAEncryption"
case .sha512WithRSAEncryption:
return "SignatureAlgorithm.sha512WithRSAEncryption"
default:
return "SignatureAlgorithm(\(self._algorithmIdentifier))"
}
}
}
extension AlgorithmIdentifier {
@inlinable
init(_ signatureAlgorithm: Certificate.SignatureAlgorithm) {
self = signatureAlgorithm._algorithmIdentifier
}
}