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的语法如下：

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;