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,  -- username
  ciphertext RAW(9)                     -- encrypted password
);
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
  (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的是BLOB或CLOB資料。

參數

樣本

下列樣本使用了DBMS_CRYPTO.DES_CBC_PKCS5分組密碼組（一組預先定義的演算法和修改器）對從passwords表中檢索出的值加密：

CREATE TABLE passwords
(
  principal  VARCHAR2(90) PRIMARY KEY,  -- username
  ciphertext RAW(9)                     -- encrypted password
);
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使用了my secret key的一個索引值和my initialization vector的一個初始化向量。當解密password時需要指定相同的鍵和初始化向量。

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函數使用了一個使用者指定的MAC函數，返回RAW或CLOB值的MAC雜湊值。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

參數

樣本

以下樣本為尋找字串cleartext source的MAC雜湊值：

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;

在計算cleartext source的MAC值時，DBMS_CRYPTO.MAC使用了my secret key的索引值。

RANDOMBYTES

RANDOMBYTES函數返回的是指定長度的RAW值，包含加密的隨機位元組。文法如下：

RANDOMBYTES
  (number_bytes IN INTEGER) RETURNS RAW

參數

樣本

下列樣本使用RANDOMBYTES函數返回長度為1024位元組的值：

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函數返回的隨機NUMBER介於[0..2**128-1]之間。文法如下：

RANDOMNUMBER() RETURNS NUMBER

樣本

以下樣本使用了RANDOMNUMBER函數來返回加密型隨機數字：

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