====== CryptoConfig.OpenSslPath Property ======

Gets or sets the path to the OpenSSL library.

----

===== Definition =====

<code csharp>
namespace WvdS.System.Security.Cryptography

public static string? OpenSslPath { get; set; }
</code>

----

===== Property Value =====

| Type | ''string?'' |
| Default Value | ''null'' (automatic search) |

----

===== Remarks =====

When ''null'', the library automatically searches for OpenSSL:

^  Platform  ^  Search Paths  ^
| Windows x64 | ''libcrypto-3-x64.dll'' in application directory, PATH |
| Linux | ''libcrypto.so.3'' in LD_LIBRARY_PATH, /usr/lib |
| macOS | ''libcrypto.3.dylib'' in DYLD_LIBRARY_PATH, /opt/homebrew/lib |

----

===== Requirements =====

<WRAP round important>
OpenSSL **3.6.0 or higher** is required for ML-DSA and ML-KEM support.
</WRAP>

----

===== Examples =====

==== Windows ====

<code csharp>
CryptoConfig.OpenSslPath = @"C:\OpenSSL-3.6\bin\libcrypto-3-x64.dll";
</code>

==== Linux ====

<code csharp>
CryptoConfig.OpenSslPath = "/opt/openssl-3.6/lib64/libcrypto.so.3";
</code>

==== macOS ====

<code csharp>
CryptoConfig.OpenSslPath = "/opt/homebrew/opt/openssl@3/lib/libcrypto.3.dylib";
</code>

----

===== Exceptions =====

| DllNotFoundException | OpenSSL library not found or cannot be loaded |
| InvalidOperationException | OpenSSL version < 3.6 |

----

===== See Also =====

  * [[.:start|CryptoConfig Class]]
  * [[.:enablepostquantum|EnablePostQuantum Method]]

{{tag>property openssl}}

----
//Wolfgang van der Stille @ EMSR DATA d.o.o. - Post-Quantum Cryptography Professional//