openssl.vcpkg 3.5.2

OpenSSL vcpkg NuGet Package

This project creates a NuGet package of OpenSSL compiled using vcpkg for Windows x64 with Visual Studio 2022 (vc143).

📋 Overview

OpenSSL is a robust, commercial-grade, and full-featured cryptography library for the Transport Layer Security (TLS) and Secure Sockets Layer (SSL) protocols. It is also a general-purpose cryptography library.

This NuGet package includes:

• 🔐 Multiple OpenSSL versions (see version table below)
• 📚 Static and dynamic libraries
• 📁 Development headers
• ⚙️ Automatic configuration for Visual Studio
• 🖥️ Windows x64 support

🚀 Installation

Via NuGet Package Manager

Install-Package openssl.vcpkg

Via .NET CLI

dotnet add package openssl.vcpkg

Via PackageReference

<PackageReference Include="openssl.vcpkg" Version="3.5.2" />
<PackageReference Include="openssl.vcpkg" Version="3.3.2" />
<PackageReference Include="openssl.vcpkg" Version="3.3.0" />
<PackageReference Include="openssl.vcpkg" Version="3.2.1" />
<PackageReference Include="openssl.vcpkg" Version="3.1.4" />
<PackageReference Include="openssl.vcpkg" Version="3.0.8" />
<PackageReference Include="openssl.vcpkg" Version="1.1.1.14" />

📦 Package Contents

openssl.vcpkg/
├── build/
│   └── native/
│       ├── include/           # OpenSSL headers
│       ├── lib/
│       │   └── x64/
│       │       ├── Release/   # Release libraries
│       │       └── Debug/     # Debug libraries
│       ├── bin/
│       │   └── x64/
│       │       ├── Release/   # Release DLLs
│       │       └── Debug/     # Debug DLLs
│       └── openssl.vcpkg.targets

🔧 Usage

Automatic Configuration

The package automatically configures:

• Include Directories: OpenSSL headers are automatically added
• Library Directories: Libraries are automatically linked
• Dependencies: libssl.lib, libcrypto.lib, ws2_32.lib, crypt32.lib
• DLLs: Automatically copied to output directory

C++ Usage Example

#include <openssl/ssl.h>
#include <openssl/err.h>
#include <openssl/crypto.h>

int main() {
    // Initialize OpenSSL
    SSL_library_init();
    SSL_load_error_strings();
    OpenSSL_add_all_algorithms();
    
    // Your application here
    printf("OpenSSL Version: %s\n", OPENSSL_VERSION_TEXT);
    
    // Cleanup
    EVP_cleanup();
    CRYPTO_cleanup_all_ex_data();
    ERR_free_strings();
    
    return 0;
}

⚙️ Requirements

• Operating System: Windows 10/11
• Architecture: x64
• Visual Studio: 2022 (vc143)
• Runtime: Visual C++ Redistributable 2022

🏗️ Included Libraries

Release

• libssl.lib - SSL library
• libcrypto.lib - Cryptography library

Debug

• libssl.lib - SSL library (Debug)
• libcrypto.lib - Cryptography library (Debug)

System Dependencies

• ws2_32.lib - Windows Sockets API
• crypt32.lib - Windows Cryptography API

🔒 Supported OpenSSL Versions

This package supports multiple OpenSSL versions:

OpenSSL 3.5.2 (Latest)

• Complete TLS/SSL support
• Enhanced security features and performance improvements
• Provider-based architecture
• Improved algorithm support
• Better FIPS compliance
• Latest bug fixes and security patches
• New cryptographic algorithms and optimizations
• Enhanced post-quantum cryptography support
• Critical security updates
• Advanced performance optimizations

OpenSSL 3.3.2 (Stable)

• Complete TLS/SSL support
• Enhanced security features and performance improvements
• Provider-based architecture
• Improved algorithm support
• Better FIPS compliance
• Latest bug fixes and security patches
• New cryptographic algorithms and optimizations
• Enhanced post-quantum cryptography support
• Critical security updates

OpenSSL 3.3.0 (Stable)

• Complete TLS/SSL support
• Enhanced security features and performance improvements
• Provider-based architecture
• Improved algorithm support
• Better FIPS compliance
• Latest bug fixes and security patches
• New cryptographic algorithms and optimizations
• Enhanced post-quantum cryptography support

OpenSSL 3.2.1 (Stable)

• Complete TLS/SSL support
• Enhanced security features and performance improvements
• Provider-based architecture
• Improved algorithm support
• Better FIPS compliance
• Latest bug fixes and security patches
• New cryptographic algorithms and optimizations

OpenSSL 3.1.4 (Stable)

• Complete TLS/SSL support
• Enhanced security features and performance improvements
• Provider-based architecture
• Improved algorithm support
• Better FIPS compliance
• Latest bug fixes and security patches

OpenSSL 3.0.8 (Stable)

• Complete TLS/SSL support
• Enhanced security features and performance improvements
• Provider-based architecture
• Improved algorithm support
• Better FIPS compliance

OpenSSL 1.1.1n (Legacy)

• Stable and widely compatible
• Complete TLS/SSL support
• Symmetric and asymmetric cryptography
• X.509 certificates support

📊 Available Versions

Version Selection Guide

• Use 3.5.2: For new projects requiring the latest features and security patches
• Use 3.3.2: For projects needing stable OpenSSL 3.3.x features
• Use 3.3.0: For projects requiring proven stability
• Use 3.2.1: For projects requiring maximum stability
• Use 3.1.4: For projects requiring long-term stability
• Use 3.0.8: For projects requiring extended stability
• Use 1.1.1.14: For legacy compatibility or existing projects

Version Format Rules

• OpenSSL 3.x: Direct semantic versioning (3.0.8 → 3.0.8)
• OpenSSL 1.1.1x: Letter suffixes converted to numeric (a = 1, b = 2, etc.)
• All versions ensure NuGet SemVer compatibility

Creating the Package

To create the NuGet package locally:

# Navigate to project directory
cd openssl-vcpkg-nuget

# Create the package
nuget pack openssl.vcpkg.nuspec -OutputDirectory out

# Output: openssl.vcpkg.{version}.nupkg (e.g., openssl.vcpkg.3.0.8.nupkg)

�🛠️ Build Process

This project uses vcpkg to compile OpenSSL:

# vcpkg setup
vcpkg install openssl:x64-windows

# NuGet package is automatically created via GitHub Actions

📋 vcpkg Configuration

The project includes:

• vcpkg.json - Specifies dependencies
• vcpkg-configuration.json - Registry configuration
• Updated baseline to the latest vcpkg version

🤝 Contributing

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

🔗 Useful Links

• OpenSSL Official Website
• OpenSSL Documentation
• vcpkg Repository
• NuGet Package

📞 Support

If you encounter issues or have questions:

• Open an Issue
• Check the OpenSSL documentation

📊 Build Status

The package is automatically built using GitHub Actions whenever there are changes to the repository. The current build status can be checked in the badge at the top of this README.

⭐ If this project was useful to you, consider giving it a star!