このページは機械翻訳したものです。
アプリケーションで MySQL Enterprise Encryption を使用するには、実行する操作に適した関数を呼び出します。 このセクションでは、代表的なタスクの実行方法を示します:
-- Encryption algorithm; can be 'DSA' or 'DH' insteadSET @algo = 'RSA';-- Key length in bits; make larger for stronger keysSET @key_len = 1024;-- Create private keySET @priv = create_asymmetric_priv_key(@algo, @key_len);-- Derive corresponding public key from private key, using same algorithmSET @pub = create_asymmetric_pub_key(@algo, @priv);鍵のペアを使用すると、データを暗号化および復号化したり、データを署名および検証したり、対称鍵を生成したりできるようになりました。
これには、鍵ペアのメンバーが RSA 鍵である必要があります。
SET @ciphertext = asymmetric_encrypt(@algo, 'My secret text', @priv);SET @plaintext = asymmetric_decrypt(@algo, @ciphertext, @pub);反対に、公開鍵を使用して暗号化し、秘密鍵を使用して復号化できます。
SET @ciphertext = asymmetric_encrypt(@algo, 'My secret text', @pub);SET @plaintext = asymmetric_decrypt(@algo, @ciphertext, @priv);いずれの場合でも、暗号化関数および復号化関数用に指定されたアルゴリズムは、鍵を生成したときに使用されたアルゴリズムと一致する必要があります。
-- Digest type; can be 'SHA256', 'SHA384', or 'SHA512' insteadSET @dig_type = 'SHA224';-- Generate digest stringSET @dig = create_digest(@dig_type, 'My text to digest');キーペアを使用してデータに署名し、署名がダイジェストと一致することを確認できます。
-- Encryption algorithm; could be 'DSA' instead; keys must-- have been created using same algorithmSET @algo = 'RSA';-- Generate signature for digest and verify signature against digestSET @sig = asymmetric_sign(@algo, @dig, @priv, @dig_type);-- Verify signature against digestSET @verf = asymmetric_verify(@algo, @dig, @sig, @pub, @dig_type); これには、共有対称シークレットを使用して作成される DH 秘密鍵/公開鍵が入力として必要です。 キー長をcreate_dh_parameters() に渡してシークレットを作成し、そのシークレットを「「キー長」」としてcreate_asymmetric_priv_key() に渡します。
-- Generate DH shared symmetric secretSET @dhp = create_dh_parameters(1024);-- Generate DH key pairsSET @algo = 'DH';SET @priv1 = create_asymmetric_priv_key(@algo, @dhp);SET @pub1 = create_asymmetric_pub_key(@algo, @priv1);SET @priv2 = create_asymmetric_priv_key(@algo, @dhp);SET @pub2 = create_asymmetric_pub_key(@algo, @priv2);-- Generate symmetric key using public key of first party,-- private key of second partySET @sym1 = asymmetric_derive(@pub1, @priv2);-- Or use public key of second party, private key of first partySET @sym2 = asymmetric_derive(@pub2, @priv1); 鍵文字列の値は、SET、SELECT、またはINSERT を使用することで実行時に作成し、変数やテーブルに格納できます。
SET @priv1 = create_asymmetric_priv_key('RSA', 1024);SELECT create_asymmetric_priv_key('RSA', 1024) INTO @priv2;INSERT INTO t (key_col) VALUES(create_asymmetric_priv_key('RSA', 1024)); ファイルに格納されている鍵文字列の値は、FILE 権限を持つユーザーがLOAD_FILE() 関数を使用することで読み取ることができます。
ダイジェストと署名の文字列は、同様に処理できます。
create_asymmetric_priv_key() およびcreate_dh_parameters() 暗号化関数はキー長パラメータを取り、これらの関数に必要な CPU リソースの量はキーの長さが増加するにつれて増加します。 一部のインストールでは、アプリケーションが過度に長いキーを頻繁に生成する場合、これによって CPU 使用率が許容できなくなることがあります。
OpenSSL では、すべてのキーに 1,024 ビットの最小キー長が課されます。 OpenSSL では、create_asymmetric_priv_key() では DSA キーおよび RSA キーに対してそれぞれ 10,000 ビットおよび 16,384 ビットの最大キー長、およびcreate_dh_parameters() では 10,000 ビットの最大キー長も課されます。 これらの最大値が大きすぎる場合は、MySQL サーバー管理者がキー生成の最大長を低く設定できるようにするために、3 つの環境変数を使用できます。これにより、CPU 使用率を制限できます:
MYSQL_OPENSSL_UDF_DSA_BITS_THRESHOLD:create_asymmetric_priv_key()の DSA キーの最大長 (ビット単位)。 この変数の最小値と最大値は 1,024 と 10,000 です。MYSQL_OPENSSL_UDF_RSA_BITS_THRESHOLD:create_asymmetric_priv_key()の RSA キーの最大長 (ビット単位)。 この変数の最小値と最大値は 1,024 と 16,384 です。MYSQL_OPENSSL_UDF_DH_BITS_THRESHOLD:create_dh_parameters()の最大キー長 (ビット単位)。 この変数の最小値と最大値は 1,024 と 10,000 です。
これらの環境変数のいずれかを使用するには、サーバーを起動するプロセスの環境に設定します。 設定されている場合、それらの値は OpenSSL によって課される最大キー長よりも優先されます。 たとえば、DSA に 4,096 ビット、create_asymmetric_priv_key() に RSA キーの最大キー長を設定するには、次の変数を設定します:
export MYSQL_OPENSSL_UDF_DSA_BITS_THRESHOLD=4096export MYSQL_OPENSSL_UDF_RSA_BITS_THRESHOLD=4096この例では Bourne シェル構文を使用します。 ほかのシェルの構文は異なる場合があります。