SCOSSL – Die SymCrypt-Engine und der SymCrypt-Provider für OpenSSL

Die SymCrypt-Engine und der SymCrypt-Provider für OpenSSL (SCOSSL) ermöglichen die Verwendung von OpenSSL mit SymCrypt als Provider für kryptografische Kernoperationen. Die Hauptmotivation hierfür ist die Unterstützung der FIPS-Zertifizierung, da Vanilla-OpenSSL 1.1.1 kein FIPS-zertifiziertes kryptografisches Modul besitzt und das FIPS-Modul von OpenSSL 3 nicht nach dem Standard FIPS 140-3 zertifiziert ist.

• SymCrypt-Engine (OpenSSL 1.1.1)
• SymCrypt-Provider (OpenSSL 3)

Versionierung und Wartung

Ab Version 1.0.0 verwendet SCOSSL das in der Spezifikation Semantic Versioning 2.0.0 definierte Versionsschema. Dies bedeutet:

• Änderungen der Hauptversion führen zu ABI- und/oder API-brächenden Änderungen
• Änderungen der Nebenversion führen zu abwärtskompatiblen zusätzlichen Funktionen oder Verbesserungen und/oder Fehlerbehebungen
• Änderungen der Patchversion führen zu abwärtskompatiblen Fehlerbehebungen

Bezüglich der Wartung empfehlen wir nachdrücklich, dass Distributionsanbieter und Anwendungsentwickler regelmäßig auf die neueste Version von SymCrypt und der SymCrypt-Engine/dem SymCrypt-Provider aktualisieren – sowohl für Sicherheitskorrekturen als auch für Funktions- und Leistungsverbesserungen.

Wir werden langfristige Wartung bestimmter Releases für Sicherheitskorrekturen unterstützen. Details zu diesem Plan werden in Zukunft öffentlich bekannt gegeben.

Build-Anleitung

Kompilieranleitung

1. Installieren Sie libssl oder kompilieren und installieren Sie OpenSSL aus dem Quellcode
2. Befolgen Sie die Linux-Build-Anweisungen aus dem SymCrypt-Repository SymCrypt, um das Linux-SymCrypt-Modul zu erstellen
   • Sie können entweder das Linux-SymCrypt-Modul installieren (d. h. libsymcrypt.so* nach /usr/lib/ und inc/* nach /usr/include/), oder
   • Kopieren Sie das erstellte Modul in das Wurzelverzeichnis des SymCrypt-OpenSSL-Repositorys: cp <SymCryptRepo>/bin/module/<arch>/LinuxUserMode/<module_name>/libsymcrypt.so ./
3. Wenn Sie mit der Syslog-Option KeysInUse bauen (-DKEYSINUSE_LOG_SYSLOG=1), installieren Sie das Entwicklungs Paket von libsystemd Azure Linux tdnf install -y systemd-devel Debian/Ubuntu apt-get install -y libsystemd-dev
4. mkdir bin; cd bin
5. cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake-toolchain/LinuxUserMode-<arch>.cmake
   • Wenn Sie die SymCrypt-Headerdateien nicht installiert haben, können Sie auch das Wurzelverzeichnis angeben: -DSYMCRYPT_ROOT_DIR=<SymCryptRepo>
   • Wenn Sie mit einer bestimmten OpenSSL-Installation verlinken möchten, können Sie außerdem -DOPENSSL_ROOT_DIR=<OpensslInstallDirectory> angeben

Beispiele ausführen

./SslPlay/SslPlay

Mitwirken

Dieses Projekt begrüßt Beiträge und Vorschläge. Für die meisten Beiträge müssen Sie einer Contributor License Agreement (CLA) zustimmen, in der Sie erklären, dass Sie das Recht haben, uns die Rechte zur Nutzung Ihres Beitrags zu gewähren, und dies auch tatsächlich tun. Weitere Informationen finden Sie unter https://cla.opensource.microsoft.com.

Wenn Sie einen Pull-Request einreichen, prüft ein CLA-Bot automatisch, ob Sie eine CLA bereitstellen müssen, und gestaltet den PR entsprechend aus (z. B. Statusprüfung, Kommentar). Befolgen Sie einfach die Anweisungen des Bots. Sie müssen dies nur einmal für alle Repositorys tun, die unsere CLA verwenden.

Dieses Projekt hat den Microsoft Open Source Code of Conduct übernommen. Weitere Informationen finden Sie in den FAQ zum Code of Conduct oder kontaktieren Sie [email protected] bei weiteren Fragen oder Anmerkungen.

Marken

Dieses Projekt kann Marken oder Logos für Projekte, Produkte oder Dienste enthalten. Die autorisierte Verwendung von Microsoft-Marken oder -Logos unterliegt den Marken- und Markenrichtlinien von Microsoft und muss diesen entsprechen. Die Verwendung von Microsoft-Marken oder -Logos in modifizierten Versionen dieses Projekts darf keine Verwechslungen hervorrufen oder eine Partnerschaft mit Microsoft implizieren. Die Verwendung von Marken oder Logos Dritter unterliegt den Richtlinien dieser Dritten.