PolarDB:DBMS_CRYPTO

DBMS_CRYPTO の関数とストアドプロシージャ

注

• DBMS_CRYPTO の関数とストアドプロシージャは、以下の Oracle 互換のエラーメッセージに対応しています。

  ORA-28239 - DBMS_CRYPTO.KeyNull
  ORA-28829 - DBMS_CRYPTO.CipherSuiteNull
  ORA-28827 - DBMS_CRYPTO.CipherSuiteInvalid

• Oracle とは異なり、PolarDB は、すでに暗号化されているデータを再暗号化しても ORA-28233 エラーメッセージを返しません。

• RAW と BLOB は PostgreSQL の BYTEA データ型のエイリアスで、CLOB は TEXT のエイリアスです。

DECRYPT

パラメーター

例

CREATE TABLE passwords
(
  principal  VARCHAR2(90) PRIMARY KEY,  -- ユーザー名
  ciphertext RAW(9)                     -- 暗号化されたパスワード
);
CREATE FUNCTION get_password(username VARCHAR2) RETURN RAW AS
 typ        INTEGER := DBMS_CRYPTO.DES_CBC_PKCS5;
 key        RAW(128) := 'my secret key';
 iv         RAW(100) := 'my initialization vector';
 password   RAW(2048);
BEGIN

  SELECT ciphertext INTO password FROM passwords WHERE principal = username;

  RETURN dbms_crypto.decrypt(password, typ, key, iv);
END;

ENCRYPT

ENCRYPT 関数または ENCRYPT ストアドプロシージャは、ユーザー定義のアルゴリズム、暗号化キー、およびオプションの初期化ベクトルを使用して RAW、BLOB、または CLOB データを暗号化します。 ENCRYPT 関数の構文は次のとおりです。

ENCRYPT
  (src IN RAW, typ IN INTEGER, key IN RAW, 
   iv IN RAW DEFAULT NULL) RETURN RAW

ENCRYPT ストアドプロシージャの構文は次のとおりです。

ENCRYPT
  (dst INOUT BLOB, src IN BLOB, typ IN INTEGER, key IN RAW, 
   iv IN RAW DEFAULT NULL)

または

ENCRYPT
  (dst INOUT BLOB, src IN CLOB, typ IN INTEGER, key IN RAW, 
   iv IN RAW DEFAULT NULL) 

ストアドプロシージャとして呼び出されると、ENCRYPT は暗号化された出力を指定された宛先の BLOB に書き込みます。

パラメーター

例

この例では、アルゴリズムと修飾子の事前定義された組み合わせである DBMS_CRYPTO.DES_CBC_PKCS5 ブロック暗号スイートを使用して、passwords テーブルの値を暗号化します。

CREATE TABLE passwords
(
  principal  VARCHAR2(90) PRIMARY KEY,  -- ユーザー名
  ciphertext RAW(2048)                  -- 暗号化されたパスワード
);
CREATE PROCEDURE set_password(username VARCHAR2, cleartext RAW) AS
 typ        INTEGER := DBMS_CRYPTO.DES_CBC_PKCS5;
 key        RAW(128) := 'my secret key';
 iv         RAW(100) := 'my initialization vector';
 encrypted  RAW(2048);
BEGIN
  encrypted := dbms_crypto.encrypt(cleartext, typ, key, iv); 
  UPDATE passwords SET ciphertext = encrypted WHERE principal = username;
END;

password を暗号化する際、 ENCRYPT はシークレットキーと初期化ベクトルを使用します。 password を復号するには、同じキーと初期化ベクトルを指定する必要があります。

HASH

HASH 関数は、ユーザー指定のハッシュアルゴリズムを使用して、RAW または CLOB 値のハッシュ値を返します。

HASH
  (src IN RAW, typ IN INTEGER) RETURN RAW
HASH
  (src IN CLOB, typ IN INTEGER) RETURN RAW 

パラメーター

例

この例では、DBMS_CRYPTO.HASH 関数を使用して、文字列 'cleartext source' の MD5 ハッシュ値を計算します。

DECLARE
  typ        INTEGER := DBMS_CRYPTO.HASH_MD5;
  hash_value RAW(100);
BEGIN

  hash_value := DBMS_CRYPTO.HASH('cleartext source', typ);

END;

MAC

MAC 関数は、指定された MAC 関数を使用し、RAW、BLOB、または CLOB データに対する HMAC 値を返します。関数の構文は次のとおりです。

MAC
  (src IN RAW, typ IN INTEGER, key IN RAW) RETURN RAW
MAC
  (src IN CLOB, typ IN INTEGER, key IN RAW) RETURN RAW
MAC 
  (src IN BLOB, typ IN INTEGER, key IN RAW) RETURN RAW

パラメーター

例

次の例では、文字列「cleartext source」の HMAC 値を計算します。

DECLARE
  typ       INTEGER := DBMS_CRYPTO.HMAC_MD5;
  key       RAW(100) := 'my secret key';
  mac_value RAW(100);
BEGIN

  mac_value := DBMS_CRYPTO.MAC('cleartext source', typ, key);

END;

DBMS_CRYPTO.MAC 関数は、キー「my secret key」を使用して「cleartext source」の HMAC 値を計算します。

RANDOMBYTES

RANDOMBYTES 関数は、指定した数の暗号論的に安全なランダムバイトを含む RAW 値を返します。構文は次のとおりです。

RANDOMBYTES
  (number_bytes IN INTEGER) RETURNS RAW

パラメーター

例

次の例では、RANDOMBYTES 関数を使用して 1,024 個のランダムバイトを返します。

DECLARE
  result RAW(1024);
BEGIN
  result := DBMS_CRYPTO.RANDOMBYTES(1024);
END;

RANDOMINTEGER

RANDOMINTEGER 関数は、Oracle BINARY_INTEGER データ型の範囲内でランダムな整数を返します。構文は次のとおりです：

RANDOMINTEGER() RETURNS INTEGER

例

この例では、RANDOMINTEGER 関数は暗号的に安全な整数を返します：

DECLARE
  result INTEGER;
BEGIN
  result := DBMS_CRYPTO.RANDOMINTEGER();
  DBMS_OUTPUT.PUT_LINE(result);
END;

RANDOMNUMBER

RANDOMNUMBER 関数は、範囲 [0..2¹²⁸ - 1] 内の暗号論的に安全な NUMBER 型の乱数を返します。構文は次のとおりです：

RANDOMNUMBER() RETURNS NUMBER

例

この例では、RANDOMNUMBER 関数の使用方法を示します：

DECLARE
  result NUMBER;
BEGIN
  result := DBMS_CRYPTO.RANDOMNUMBER();
  DBMS_OUTPUT.PUT_LINE(result);
END;