RSA Cryptography

Saiba mais sobre o conector RSA Cryptography e como usá-lo na Digibee Integration Platform.

O conector RSA Cryptography realiza criptografia e descriptografia com base no algoritmo RSA.

Parâmetros

Configure o conector utilizando os parâmetros abaixo. Os campos que suportam expressões Double Braces estão marcados na coluna Suporta DB.

General

Parâmetro	Descrição	Tipo de dado	Suporta DB	Valor padrão	Visível quando
Use Dynamic Account	Se habilitado, o conector usa a conta de forma dinâmica via o conector Store Account; caso contrário, usa a conta estática configurada em Contas na Plataforma.	Boolean	❌	false	—
Scoped	Se habilitado, isola a conta armazenada de outros subprocessos. Não é suportado para contas usadas em headers ou body. Para saber mais, consulte a documentação de Dynamic Accounts.	Boolean	❌	false	Use Dynamic Account está habilitado
Account Name	Nome da conta definida no conector Store Account.	String	✅	N/A	Use Dynamic Account está habilitado
Account	Conta a ser usada pelo conector. As operações de encrypt e wrap exigem uma conta do tipo Public Key; as operações de decrypt e unwrap exigem uma conta do tipo Private Key. As operações de encrypt também suportam o fornecimento da chave diretamente no corpo da mensagem. A configuração da conta é feita em Contas na Plataforma.	String	❌	N/A	Use Dynamic Account está desabilitado
Crypto Operation	Define o tipo de operação a ser executada: Encrypt Fields, Decrypt Fields, Encrypt Payload, Decrypt Payload, Unwrap Key ou Wrap Key.	String	❌	Encrypt Fields	—
Fields To Encrypt/Decrypt	Campos a serem criptografados ou descriptografados, especificados usando notação com pontos (ex.: body.field1, body.field2, body).	String	❌	a.test	Crypto Operation é Encrypt Fields ou Decrypt Fields
Payload To Encrypt/Decrypt	Payload a ser criptografado ou descriptografado, especificado usando notação com pontos.	String	❌	N/A	Crypto Operation é Encrypt Payload ou Decrypt Payload
Secret Key	Chave secreta a ser encapsulada (wrap) ou desencapsulada (unwrap), especificada usando notação com pontos.	String	❌	N/A	Crypto Operation é Wrap Key ou Unwrap Key
Operation Mode	Modo de operação a ser utilizado na operação criptográfica.	String	❌	ECB	Crypto Operation é Encrypt Fields, Decrypt Fields, Encrypt Payload ou Decrypt Payload
Padding	Esquema de padding usado em operações de cifra de bloco para preencher os blocos com bytes de padding (ex.: AES 128 bits usa 16 bytes de padding).	String	❌	OAEPWithSHA-512AndMGF1Padding	—
Charset	Codificação de caracteres da chave fornecida quando o tipo de chave é string.	String	❌	UTF-8	—
Encrypted Message As Hexa	Se habilitado, retorna a resposta da secret key em formato hexadecimal; caso contrário, é retornada em formato Base64.	Boolean	❌	false	—
Fail On Error	Se habilitado, interrompe a execução do pipeline quando ocorre um erro. Caso contrário, a execução prossegue e o resultado retorna false para a propriedade "success".	Boolean	❌	false	—

Documentation

Informações adicionais dos parâmetros

Wrap e Unwrap Key

As operações de wrap e unwrap diferem um pouco das operações padrão de encrypt e decrypt. Ao fazer o wrap de uma chave, você não apenas a criptografa, mas também adiciona proteção de integridade para garantir que a chave não tenha sido adulterada. Da mesma forma, ao fazer o unwrap de uma chave, você a descriptografa validando simultaneamente sua integridade.

No conector RSA Cryptography, essas operações são projetadas para encapsular com segurança uma chave de sessão (ou secreta) para transferência através de outros conectores da Digibee, garantindo tanto confidencialidade quanto integridade.

Por serem funcionalidades experimentais, atualmente apenas uma configuração específica é suportada.

Para a Crypto Operation Wrap Key

No campo Account, selecione uma chave pública de um par de chaves RSA de 2048 bits.

No campo Secret Key, especifique uma chave AES de 256 bits a partir do payload de entrada. Use notação com pontos para referenciar o respectivo campo da chave.

Os valores são criptografados em formato hexadecimal.

A operação de wrap RSA é realizada com os seguintes parâmetros:

• Operation Mode: ECB

• Padding Scheme: OAEPWithSHA-256AndMGF1Padding

Para a Crypto Operation Unwrap Key

No campo Account, selecione uma chave privada de um par de chaves RSA de 2048 bits.

No campo Secret Key, especifique uma chave AES de 256 bits a partir do payload de entrada. Use notação com pontos para referenciar o respectivo campo da chave.

Os valores são criptografados em formato hexadecimal.

A operação de unwrap RSA é realizada com os seguintes parâmetros:

• Operation Mode: ECB

• Padding Scheme: OAEPWithSHA-256AndMGF1Padding

Fluxo de mensagens

Operation: Encrypt Fields

Entrada

{
    "operation": "encrypt_fields",
    "operationMode": "ECB",
    "padding": "OAEPWithSHA1AndMGF1Padding",
    "encryptedFields": "data,data1",
    "failOnError": true,
    "key": "PoeK/VBTcUyRHFkmWYjckbhsRLnZur6S83lKZ78V51EL3KlDNnPJZkdz+m7joRfOxFuEqU=" // Informe o parâmetro Key caso a Account não esteja configurada
}

Payload

{
    "data": someData,
    "data1": someData1
}

Saída

{
    "data": "RXZlbiBpZiBwZXJmZWN0IGNyeXB0b2dyYXBoaWMgcm91dGluZXMgYXJlIH=",
    "data1": "RXZlbiBpZifd441mZWN0IGNyeXB0b2dyYXBoaWMgcm91dGluZXMgYXJlIH="
}

Operation: Decrypt Fields

Entrada

{
    "operation": "decrypt_fields",
    "operationMode": "ECB",
    "padding": "OAEPWithSHA1AndMGF1Padding",
    "encryptedFields": "data,data1",
    "failOnError": true
}

Payload

{
    "data": "RXZlbiBpZiBwZXJmZWN0IGNyeXB0b2dyYXBoaWMgcm91dGluZXMgYXJlIH=",
    "data1": "RXZlbiBpZifd441mZWN0IGNyeXB0b2dyYXBoaWMgcm91dGluZXMgYXJlIH="
}

Saída

{
    "data": someData,
    "data1": someData1
}

Operation: Wrap Key

Payload

{
  "encryptedData": {
    "key": "D379C385D6234349046ABCFD42160E5B461E852A63F53B8FDA3B6ED044332E34"
  }
}

Saída

{
  "encryptedData": {
    "key": "1e9fbbe9f77020cd05318d71ae242c68ab62981cc40b0e88c42ad89bb24807e46c6589edbb81bc7271c3824d60c2fa754651325eb2510a7cd82125f4ca9356b0b48d2dea8e8348f68173eabecb096a4c41a4a852ec2fb7cd9b0381d080e9d1e09a0bb614d3bbf550e52fe4583a5fdd47623e13256c69ee434b6c44d2e90de89804f0e0ff1c83f25adeef9ae89e657b79d8270511b9be5ce56a8955b2c8c5356c9639e6556c12c208a58e2d30e554a51d3a45317de54ab7380482f2d9f6d70c0223594b39c1c2f6f1d28301cb128167946082085c6dbf89825b6fc41929380305d4a5009d85c97d3d08f9672e66e71188b02eb23dffcb40271f1bb7b4d2f4fd5b"
  }
}

Operation: Unwrap Key

Payload

{
  "encryptedData": {
    "key": "1e9fbbe9f77020cd05318d71ae242c68ab62981cc40b0e88c42ad89bb24807e46c6589edbb81bc7271c3824d60c2fa754651325eb2510a7cd82125f4ca9356b0b48d2dea8e8348f68173eabecb096a4c41a4a852ec2fb7cd9b0381d080e9d1e09a0bb614d3bbf550e52fe4583a5fdd47623e13256c69ee434b6c44d2e90de89804f0e0ff1c83f25adeef9ae89e657b79d8270511b9be5ce56a8955b2c8c5356c9639e6556c12c208a58e2d30e554a51d3a45317de54ab7380482f2d9f6d70c0223594b39c1c2f6f1d28301cb128167946082085c6dbf89825b6fc41929380305d4a5009d85c97d3d08f9672e66e71188b02eb23dffcb40271f1bb7b4d2f4fd5b"
  }
}

Saída

{
  "encryptedData": {
    "key": "D379C385D6234349046ABCFD42160E5B461E852A63F53B8FDA3B6ED044332E34"
  }
}