PolarDB:DBMS_CRYPTO

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

注意事項

• Oracle データベースと同様に、PolarDB for 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 関数またはストアドプロシージャを使用して、ユーザー定義のアルゴリズム、キー、およびオプションの初期化ベクトルに基づいて 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 をストアドプロシージャとして呼び出すと、ENCRYPT は BLOB または CLOB データをユーザー指定の BLOB に返します。

パラメーター

例

次の例では、DBMS_CRYPTO.DES_CBC_PKCS5 ブロック暗号スイート (定義済みのアルゴリズムと修飾子のセット) を使用して、passwords テーブルから取得した値を暗号化します。

CREATE TABLE passwords
(
 principal  VARCHAR2(90) PRIMARY KEY,  -- ユーザー名
 ciphertext RAW(9)                     -- 暗号化されたパスワード
);
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;

パスワードを暗号化する時に、ENCRYPT は my secret key をキーとして、my initialization vector を初期化ベクトルとして使用します。パスワードの復号化時には、暗号化の時と同じキーと初期化ベクトルを使用する必要があります。

HASH

HASH 関数を使用して、ユーザー指定のハッシュアルゴリズムにより RAW または CLOB データのハッシュ値を返すことができます。 HASH 関数の構文

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 関数を使用して、RAW または CLOB データの HMAC 値を返すことができます。 MAC 関数の構文

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

パラメーター

例

次の例では、DBMS_CRYPTO.MAC を使用して 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 をキーとして使用します。

RANDOMBYTES

RANDOMBYTES 関数を使用して、暗号化のランダムなバイトシーケンスを含む RAW 値を返すことができます。 RAW 値の長さを指定できます。 RANDOMBYTES の構文

RANDOMBYTES
  (number_bytes IN INTEGER) RETURNS RAW

パラメーター

例

次の例では、RANDOMBYTES を使用して、長さが 1,024 バイトの値を返します。

DECLARE
  result RAW(1024);
BEGIN
  /* 1024 バイトのランダムなバイト列を生成 */
  result := DBMS_CRYPTO.RANDOMBYTES(1024);
END;

RANDOMINTEGER

RANDOMINTEGER 関数を使用して、Oracle BINARY_INTEGER データ型の使用できる範囲内のランダムな整数を返すことができます。 RANDOMINTEGER の構文

RANDOMINTEGER() RETURNS INTEGER

例

次の例では、RANDOMINTEGER 関数を使用して、暗号化のランダムな整数を返します。

DECLARE
  result INTEGER;
BEGIN
  result := DBMS_CRYPTO.RANDOMINTEGER(); -- ランダムな整数を生成
  DBMS_OUTPUT.PUT_LINE(result); -- 結果を出力
END;

RANDOMNUMBER

RANDOMNUMBER 関数を使用して、Oracle NUMBER データ型の [0..2**128-1] 範囲内の数を返すことができます。 RANDOMNUMBER の構文

RANDOMNUMBER() RETURNS NUMBER

例

次の例では、RANDOMNUMBER 関数を使用して、暗号化乱数を返します。

DECLARE
  result NUMBER;
BEGIN
  result := DBMS_CRYPTO.RANDOMNUMBER();
  DBMS_OUTPUT.PUT_LINE(result);
END;
/* 次の例では、RANDOMNUMBER 関数を使用して、暗号的に安全な乱数を返します。 */