SCOSSL - OpenSSL 用 SymCrypt エンジンおよびプロバイダー

OpenSSL 用 SymCrypt エンジンおよびプロバイダー (SCOSSL) により、OpenSSL はコア暗号化操作のプロバイダーとして SymCrypt を使用できます。主な動機は FIPS 認証をサポートすることです。素の OpenSSL 1.1.1 には FIPS 認証済みの暗号モジュールがなく、OpenSSL 3 の fips モジュールは FIPS 140-3 標準で認証されていないためです。

SymCrypt エンジン (OpenSSL 1.1.1)
SymCrypt プロバイダー (OpenSSL 3)

バージョニングとサービス

SCOSSL はバージョン 1.0.0 以降、セマンティックバージョニング 2.0.0 仕様で定義されたバージョニング方式を使用しています。つまり、

メジャーバージョンの変更は、ABI または API の互換性を破壊する変更をもたらします
マイナーバージョンの変更は、後方互換性のある追加機能や改善、またはバグ修正をもたらします
パッチバージョンの変更は、後方互換性のあるバグ修正をもたらします

サービスに関しては、ディストリビューションベンダーとアプリケーション開発者が、セキュリティ修正と機能/パフォーマンスの改善の両方のために、SymCrypt および SymCrypt エンジン/プロバイダーの最新バージョンに定期的に更新することを強くお勧めします。

当プロジェクトでは、セキュリティ修正のための特定リリースの長期サービスをサポートする予定です。この計画の詳細は、今後公開される予定です。

ビルド手順

コンパイル手順

libssl をインストールするか、ソースから OpenSSL をコンパイルしてインストールします
SymCrypt リポジトリ SymCrypt の Linux ビルド手順に従って、Linux SymCrypt モジュールをビルドします
- Linux SymCrypt モジュールをインストールするか (つまり、libsymcrypt.so* を /usr/lib/ に、inc/* を /usr/include/ に配置する)、または
- ビルドしたモジュールを SymCrypt-OpenSSL リポジトリのルートにコピーします cp <SymCryptRepo>/bin/module/<arch>/LinuxUserMode/<module_name>/libsymcrypt.so ./
KeysInUse syslog オプション (-DKEYSINUSE_LOG_SYSLOG=1) を使用してビルドする場合は、libsystemd 開発パッケージをインストールします Azure Linux tdnf install -y systemd-devel Debian/Ubuntu apt-get install -y libsystemd-dev
mkdir bin; cd bin
cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake-toolchain/LinuxUserMode-<arch>.cmake
- SymCrypt ヘッダーファイルをインストールしていない場合は、ルートディレクトリ -DSYMCRYPT_ROOT_DIR=<SymCryptRepo> を指定することもできます
- 特定の OpenSSL インストールにリンクしたい場合は、-DOPENSSL_ROOT_DIR=<OpensslInstallDirectory> を指定することもできます
- symcrypt プロバイダーで keysinuse を有効にするには、-DKEYSINUSE_ENABLED=1 を指定します
- スタンドアロンの keysinsue ライブラリのみをビルドしたい場合は、-DKEYSINUSE_STANDALONE=1 を指定します
- keysinuse がファイルではなく syslog にログを記録するようにする場合は、-DKEYSINUSE_LOG_SYSLOG=1 を指定します
- 必要に応じて、リリースビルドの場合は -DCMAKE_BUILD_TYPE=Release を指定します
cmake --build .
- 必要に応じて -jN を指定します。N はビルドのために起動するプロセス数です

サンプルの実行

./SslPlay/SslPlay

コントリビューション

このプロジェクトでは、コントリビューションと提案を歓迎しています。ほとんどのコントリビューションには、あなたのコントリビューションを使用する権利を当社に付与する権利を有し、実際に付与することを宣言する Contributor License Agreement (CLA) への同意が必要です。詳細については、https://cla.opensource.microsoft.com をご覧ください。

プルリクエストを送信すると、CLA ボットが CLA の提供が必要かどうかを自動的に判断し、PR を適切に装飾します (例: ステータスチェック、コメント)。ボットから提供される指示に従ってください。この操作は、当社の CLA を使用するすべてのリポジトリで一度だけ行う必要があります。

このプロジェクトは、Microsoft オープンソースの行動規範を採用しています。詳細については、行動規範に関する FAQ をご覧になるか、追加の質問やコメントがある場合は [email protected] までお問い合わせください。

商標

このプロジェクトには、プロジェクト、製品、またはサービスの商標またはロゴが含まれる場合があります。Microsoft の商標またはロゴの許可された使用は、Microsoft の商標およびブランドのガイドラインに従う必要があります。このプロジェクトの修正版で Microsoft の商標またはロゴを使用する場合、混乱を引き起こしたり、Microsoft の支援を示唆したりしてはなりません。第三者の商標またはロゴの使用は、それらの第三者のポリシーに従います。

SymCrypt-OpenSSL

人気