porter/libsrc/porter/infra/crypto/crypto_linux.c

1 ファイル

1.1 porter/libsrc/porter/infra/crypto/crypto_linux.c

Linux 向け暗号化・復号モジュール (OpenSSL AES-256-GCM)。

OpenSSL の EVP インターフェースを使用して AES-256-GCM 暗号化・復号を実装します。
Windows 実装 (BCrypt) と同一の wire フォーマット ([暗号文][GCM タグ 16B]) を使用するため、クロスプラットフォーム通信に対応します。
本ファイルは Linux ビルドでのみコンパイルされます (_WIN32 未定義時)。

1.1.1 作者

c-modernization-kit sample team

1.1.2 バージョン

1.0.0

1.1.3 日付

2026/03/12

1.1.4 著作権

2 関数

2.1 potr_encrypt

int potr_encrypt ( uint8_t *dst, size_t *dst_len, const uint8_t *src, size_t src_len, const uint8_t *key, const uint8_t *nonce, const uint8_t *aad, size_t aad_len )

AES-256-GCM でデータを暗号化します。

2.1.1 引数

dst [out] 暗号化後データを格納するバッファ。
内容: [暗号文: src_len バイト][GCM タグ: POTR_CRYPTO_TAG_SIZE バイト]
dst == src の in-place 暗号化も可能。
dst_len [in,out] 入力: dst のバッファサイズ (>= src_len + POTR_CRYPTO_TAG_SIZE)。
出力: 書き込んだバイト数 (= src_len + POTR_CRYPTO_TAG_SIZE)。
src [in] 平文データへのポインタ。
src_len [in] 平文データのバイト数。
key [in] AES-256 鍵 (POTR_CRYPTO_KEY_SIZE バイト)。
nonce [in] ノンス (POTR_CRYPTO_NONCE_SIZE バイト)。
aad [in] 追加認証データへのポインタ。NULL の場合は AAD なし。
aad_len [in] AAD のバイト数。

2.1.2 戻り値

成功時は 0、失敗時は -1 を返します。

2.2 potr_decrypt

int potr_decrypt ( uint8_t *dst, size_t *dst_len, const uint8_t *src, size_t src_len, const uint8_t *key, const uint8_t *nonce, const uint8_t *aad, size_t aad_len )

AES-256-GCM でデータを復号し、認証タグを検証します。

2.2.1 引数

dst [out] 復号後データを格納するバッファ。
dst_len [in,out] 入力: dst のバッファサイズ (>= src_len - POTR_CRYPTO_TAG_SIZE)。
出力: 書き込んだバイト数 (= src_len - POTR_CRYPTO_TAG_SIZE)。
src [in] 暗号化データへのポインタ。
内容: [暗号文: src_len - POTR_CRYPTO_TAG_SIZE バイト][GCM タグ: POTR_CRYPTO_TAG_SIZE バイト]
src_len [in] 暗号化データのバイト数 (タグを含む)。>= POTR_CRYPTO_TAG_SIZE。
key [in] AES-256 鍵 (POTR_CRYPTO_KEY_SIZE バイト)。
nonce [in] ノンス (POTR_CRYPTO_NONCE_SIZE バイト)。
aad [in] 追加認証データへのポインタ。NULL の場合は AAD なし。
aad_len [in] AAD のバイト数。

2.2.2 戻り値

成功 (認証タグ検証 OK) 時は 0、失敗 (認証タグ不一致含む) 時は -1 を返します。

2.3 potr_passphrase_to_key

int potr_passphrase_to_key ( uint8_t *key, const uint8_t *passphrase, size_t passphrase_len )

任意のパスフレーズを SHA-256 ハッシュにより AES-256 鍵に変換します。

設定ファイルの encrypt_key に 64 文字 hex 以外の文字列が指定された場合に使用します。
入力バイト列の SHA-256 ダイジェストをそのまま鍵として使用します。
送受信の双方で同一のパスフレーズを指定すれば、同一の鍵が導出されます。

2.3.1 引数

key [out] 出力鍵バッファ (POTR_CRYPTO_KEY_SIZE = 32 バイト)。
passphrase [in] パスフレーズへのポインタ (任意のバイト列)。
passphrase_len [in] パスフレーズの長さ (バイト)。0 の場合も有効。

2.3.2 戻り値

成功時は 0、失敗時は -1 を返します。