SCOSSL - Il motore SymCrypt e provider per OpenSSL

Il motore SymCrypt e provider per OpenSSL (SCOSSL) consentono l'uso di OpenSSL con SymCrypt come provider per le operazioni crittografiche core. La motivazione principale è supportare la certificazione FIPS, poiché OpenSSL 1.1.1 vanilla non dispone di un modulo crittografico certificato FIPS, e il modulo fips di OpenSSL 3 non è certificato secondo lo standard FIPS 140-3.

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

Versioning e Manutenzione

A partire dalla versione 1.0.0, SCOSSL utilizza lo schema di versioning definito dalla specifica Semantic Versioning 2.0.0. Ciò significa:

• Le modifiche di versione Major introducono modifiche incompatibili a livello di ABI e/o API
• Le modifiche di versione Minor introducono funzionalità aggiuntive o miglioramenti retrocompatibili e/o correzioni di bug
• Le modifiche di versione Patch introducono correzioni di bug retrocompatibili

Per quanto riguarda la manutenzione, la nostra forte raccomandazione è che i vendor di distribuzioni e gli sviluppatori di applicazioni aggiornino regolarmente all'ultima versione di SymCrypt e del motore/provider SymCrypt sia per le correzioni di sicurezza sia per i miglioramenti di funzionalità/prestazioni.

Supportiamo la manutenzione a lungo termine di rilasci specifici per le correzioni di sicurezza. I dettagli di questo piano saranno resi pubblici in futuro.

Istruzioni di Build

Istruzioni di Compilazione

1. Installare libssl, oppure compilare e installare OpenSSL dal sorgente
2. Seguire le istruzioni di build Linux dal repository SymCrypt SymCrypt per compilare il modulo Linux SymCrypt
   • È possibile installare il modulo Linux SymCrypt (cioè libsymcrypt.so* in /usr/lib/, e inc/* in /usr/include/), oppure
   • Copiare il modulo compilato nella radice del repository SymCrypt-OpenSSL cp <SymCryptRepo>/bin/module/<arch>/LinuxUserMode/<module_name>/libsymcrypt.so ./
3. Se si compila con l'opzione syslog KeysInUse (-DKEYSINUSE_LOG_SYSLOG=1), installare il pacchetto di sviluppo 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
   • Se non sono stati installati i file header di SymCrypt, è possibile specificare anche la directory radice -DSYMCRYPT_ROOT_DIR=<SymCryptRepo>
   • Se si desidera collegarsi a una specifica installazione di OpenSSL, è possibile specificare anche -DOPENSSL_ROOT_DIR=<OpensslInstallDirectory>
   • Se si desidera abilitare keysinuse nel provider symcrypt, specificare -DKEYSINUSE_ENABLED=1
   • Se si desidera compilare solo la libreria standalone keysinsue, specificare -DKEYSINUSE_STANDALONE=1
   • Se si desidera che keysinuse registri su syslog invece che su un file, specificare -DKEYSINUSE_LOG_SYSLOG=1
   • Opzionalmente, per una build di rilascio, specificare -DCMAKE_BUILD_TYPE=Release
6. cmake --build .
   • Opzionalmente specificare -jN dove N è il numero di processi che si desidera generare per la build

Eseguire gli Esempi

./SslPlay/SslPlay

Contribuire

Questo progetto accoglie contributi e suggerimenti. La maggior parte dei contributi richiede di accettare un Contributor License Agreement (CLA) che dichiara di avere il diritto di concederci, e di concederci effettivamente, i diritti di utilizzo del proprio contributo. Per i dettagli, visitare https://cla.opensource.microsoft.com.

Quando si invia una pull request, un bot CLA determinerà automaticamente se è necessario fornire un CLA e decorerà la PR in modo appropriato (ad es. status check, commento). È sufficiente seguire le istruzioni fornite dal bot. Sarà necessario farlo una sola volta in tutti i repository che utilizzano il nostro CLA.

Questo progetto ha adottato il Microsoft Open Source Code of Conduct. Per maggiori informazioni vedere le Code of Conduct FAQ oppure contattare [email protected] per eventuali domande o commenti aggiuntivi.

Marchi

Questo progetto può contenere marchi o loghi di progetti, prodotti o servizi. L'uso autorizzato dei marchi o dei loghi Microsoft è soggetto a e deve seguire Microsoft's Trademark & Brand Guidelines. L'uso di marchi o loghi Microsoft in versioni modificate di questo progetto non deve causare confusione o implicare il patrocinio di Microsoft. Qualsiasi uso di marchi o loghi di terze parti è soggetto alle politiche di tali terze parti.