MySQL 用 vsql_crypto 拡張機能

vsql_crypto は、OpenSSL 上に構築された pgcrypto 互換の関数セットを MySQL にもたらします。4 つの仕事をカバーします。値のハッシュ、ペイロードの署名、カラムの暗号化、および後で検証できるパスワードの保存です。


メンテナー	VillageSQL
ソースと完全なドキュメント	villagesql/vsql-crypto
ライセンス	GPL-2.0

インストール

インストールスクリプト、Docker イメージ、またはリリース tarball で VillageSQL をインストールした場合、vsql_crypto.veb はすでにサーバーの lib/veb/ ディレクトリにあります。1 つのステートメントでサーバーにインストールします。

INSTALL EXTENSION vsql_crypto;

インストールされたことを確認します。

SELECT EXTENSION_NAME
FROM INFORMATION_SCHEMA.EXTENSIONS
WHERE EXTENSION_NAME = 'vsql_crypto';

+----------------+
| EXTENSION_NAME |
+----------------+
| vsql_crypto    |
+----------------+

自分でビルドするには、リポジトリのビルド手順に従ってください。

追加される機能

関数	戻り値	説明
`digest(data, algorithm)`	binary	`md5`、`sha1`、`sha224`、`sha256`、`sha384`、または `sha512` でデータをハッシュする
`hmac(data, key, algorithm)`	binary	鍵付きハッシュでデータに署名する
`encrypt(data, key, type)`	binary	AES で暗号化する
`decrypt(data, key, type)`	binary	同じ鍵で `encrypt` を元に戻す
`crypt(password, salt)`	text	パスワードを、自身のパラメーターを含む文字列にハッシュする
`gen_salt(type, iterations)`	text	`crypt` のためのソルトを生成する。`pbkdf2-sha256` と `pbkdf2-sha512` のみ
`gen_random_bytes(n)`	binary	暗号学的に安全なランダムバイト
`gen_random_uuid()`	text	ランダムなバージョン 4 の UUID をテキストで返す
`crypto_version()`	text	拡張機能がリンクされている OpenSSL のバージョン

binary と記された関数は生のバイトを返すため、読むには HEX() で包んでください。残りはテキストを返します。

例

ペイロードに署名します。

SET @secret = 'shared-key';
SELECT HEX(hmac('{"order":4711}', @secret, 'sha256')) AS signature;

+------------------------------------------------------------------+
| signature                                                        |
+------------------------------------------------------------------+
| 7261870227EF8090041AB514536550671974770FCE19416ABB634C55389C3141 |
+------------------------------------------------------------------+

パスワードを保存します。結果にはアルゴリズム、反復回数、およびソルトが含まれているため、検証のために他に保存しておくものはありません。

SELECT crypt('correct horse battery', gen_salt('pbkdf2-sha256', 100000)) AS hash;

+------------------------------------------------------------------------------------------+
| hash                                                                                     |
+------------------------------------------------------------------------------------------+
| $pbkdf2-sha256$100000$N6MXcYhD7SS4DS9sVhaQag$rv6zFwkwfo4N8+lgEpU5/LR4mOLtio04b6iKCSRlF5E |
+------------------------------------------------------------------------------------------+

ソルトはランダムなので、ハッシュは呼び出しのたびに異なります。

gen_salt がサポートするのは pbkdf2-sha256 と pbkdf2-sha512 だけです。bf、md5、または des を要求すると NULL が返り、NULL のソルトを渡した crypt も NULL を返すため、pgcrypto が書いた bcrypt ハッシュをここで検証することはできません。

拡張機能のインストールと実行

拡張機能カタログ

拡張機能の作成

インストール

追加される機能

例

関連項目

​インストール

​追加される機能

​例

​関連項目

インストール

追加される機能

例

関連項目