SCOSSL - O mecanismo e provedor SymCrypt para OpenSSL

O mecanismo e provedor SymCrypt para OpenSSL (SCOSSL) permitem o uso do OpenSSL com SymCrypt como provedor para operações criptográficas principais. A principal motivação para isso é suportar a certificação FIPS, uma vez que o OpenSSL 1.1.1 padrão não possui um módulo criptográfico certificado FIPS, e o módulo fips do OpenSSL 3 não é certificado no padrão FIPS 140-3.

• Mecanismo SymCrypt (OpenSSL 1.1.1)
• Provedor SymCrypt (OpenSSL 3)

Versionamento e Manutenção

A partir da versão 1.0.0, o SCOSSL utiliza o esquema de versionamento definido pela especificação Semantic Versioning 2.0.0. Isso significa:

• Mudanças na versão principal (major) introduzem alterações de quebra de ABI e/ou API
• Mudanças na versão secundária (minor) introduzem funcionalidades adicionais ou melhorias compatíveis com versões anteriores e/ou correções de bugs
• Mudanças na versão de patch introduzem correções de bugs compatíveis com versões anteriores

Em relação à manutenção, nossa forte recomendação é que fornecedores de distribuições e desenvolvedores de aplicativos atualizem regularmente para a versão mais recente do SymCrypt e do mecanismo/provedor SymCrypt, tanto para correções de segurança quanto para melhorias de funcionalidade/desempenho.

Daremos suporte de manutenção de longo prazo para versões específicas com correções de segurança. Os detalhes deste plano serão divulgados publicamente no futuro.

Instruções de Build

Instruções de Compilação

1. Instale o libssl, ou compile e instale o OpenSSL a partir do código-fonte
2. Siga as instruções de compilação para Linux do repositório SymCrypt SymCrypt para compilar o módulo SymCrypt para Linux
   • Você pode instalar o módulo SymCrypt para Linux (ou seja, libsymcrypt.so* em /usr/lib/, e inc/* em /usr/include/), ou
   • Copiar o módulo compilado para a raiz do repositório SymCrypt-OpenSSL cp <SymCryptRepo>/bin/module/<arch>/LinuxUserMode/<module_name>/libsymcrypt.so ./
3. Se você estiver compilando com a opção de syslog KeysInUse (-DKEYSINUSE_LOG_SYSLOG=1), instale o pacote de desenvolvimento 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 você não instalou os arquivos de cabeçalho do SymCrypt, também pode especificar o diretório raiz -DSYMCRYPT_ROOT_DIR=<SymCryptRepo>
   • Se quiser vincular a uma instalação específica do OpenSSL, também pode especificar -DOPENSSL_ROOT_DIR=<OpensslInstallDirectory>
   • Se quiser habilitar o keysinuse no provedor symcrypt, especifique -DKEYSINUSE_ENABLED=1
   • Se quiser compilar apenas a biblioteca independente keysinsue, especifique -DKEYSINUSE_STANDALONE=1
   • Se quiser que o keysinuse registre no syslog em vez de um arquivo, especifique -DKEYSINUSE_LOG_SYSLOG=1
   • Opcionalmente, para um build de release, especifique -DCMAKE_BUILD_TYPE=Release
6. cmake --build .
   • Opcionalmente, especifique -jN, onde N é o número de processos que você deseja iniciar para a compilação

Executar Exemplos

./SslPlay/SslPlay

Contribuição

Este projeto recebe contribuições e sugestões. A maioria das contribuições exige que você concorde com um Contrato de Licença de Contribuidor (CLA), declarando que você tem o direito de nos conceder, e de fato concede, os direitos de uso da sua contribuição. Para obter detalhes, visite https://cla.opensource.microsoft.com.

Quando você envia um pull request, um bot de CLA determinará automaticamente se você precisa fornecer um CLA e decorará o PR adequadamente (por exemplo, verificação de status, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que usam nosso CLA.

Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para obter mais informações, consulte as Perguntas Frequentes sobre o Código de Conduta ou entre em contato com [email protected] caso tenha dúvidas ou comentários adicionais.

Marcas Registradas

Este projeto pode conter marcas registradas ou logotipos de projetos, produtos ou serviços. O uso autorizado de marcas registradas ou logotipos da Microsoft está sujeito e deve seguir as Diretrizes de Marcas Registradas e Marca da Microsoft. O uso de marcas registradas ou logotipos da Microsoft em versões modificadas deste projeto não deve causar confusão ou implicar patrocínio da Microsoft. Qualquer uso de marcas registradas ou logotipos de terceiros está sujeito às políticas desses terceiros.