Simple Log Service:Funções de codificação e decodificação

Codifica a string com o formato de codificação especificado.

• Sintaxe

  str_encode(value, "utf8", errors="ignore")

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  value	Arbitrário (convertido automaticamente para string)	Sim	Valor a codificar.
  encoding	String	Não	Formato de codificação. Valor padrão: UTF-8. Compatível com ASCII.
  errors	String	Não	Método de processamento de caracteres não reconhecidos pelo formato de codificação. Valores válidos: ignore (padrão): Não codifica os caracteres. strict: Relata um erro e descarta o log. replace: Substitui caracteres irreconhecíveis por pontos de interrogação (?). xmlcharrefreplace: Substitui caracteres irreconhecíveis por caracteres XML.

• Resposta

  Retorna uma string codificada.

• Exemplos

  • Exemplo 1

    • Log bruto

      test: asewds

    • Regra de transformação

      e_set("f1", str_decode(str_encode("Hello", "utf8"), "utf8"))

    • Resultado

      test: asewds
      f1: Hello

  • Exemplo 2

    • Log bruto

      f2: test Test data

    • Regra de transformação

      e_set("f1", str_encode(v("f2"), "ascii", errors="ignore"))

    • Resultado

      f1:test 
      f2:test Test data

  • Exemplo 3

    • Log bruto

      f2: test data

    • Regra de transformação

      e_set("f1", str_encode(v("f2"), "ascii", errors="strict"))

    • Resultado

      Ocorre um erro durante a execução.

  • Exemplo 4

    • Log bruto

      f2: test Test data

    • Regra de transformação

      e_set("f1", str_encode(v("f2"), "ascii", errors="replace"))

    • Resultado

      f1:test ????
      f2:test Test data

  • Exemplo 5

    • Log bruto

      f2: test Test data

    • Regra de transformação

      e_set("f1", str_encode(v("f2"), "ascii", errors="xmlcharrefreplace"))

    • Resultado

      f1:test 测试数据
      f2:test Test data

Decodifica o valor de entrada com o formato de codificação especificado.

• Sintaxe

  str_decode(value, "utf8", errors="ignore")

  Nota

  A função str_decode processa apenas dados do tipo byte.

• Parâmetros

  Nome do parâmetro	Tipos de dados	Obrigatório	Descrição
  value	Arbitrário (convertido automaticamente para string)	Sim	Valor a decodificar.
  encoding	Arbitrário (convertido automaticamente para string)	Não	Formato de codificação. Valor padrão: UTF-8. Compatível com ASCII.
  errors	Arbitrário (convertido automaticamente para string)	Não	Método de processamento de caracteres não reconhecidos pelo formato de codificação. Valores válidos: ignore (padrão): Não decodifica os caracteres. strict: Relata um erro e descarta o log. replace: Substitui caracteres irreconhecíveis por pontos de interrogação (?). xmlcharrefreplace: Substitui caracteres irreconhecíveis por caracteres XML.

• Resposta

  Retorna um valor decodificado.

• Exemplos

  • Log bruto

    test: asewds

  • Regra de transformação

    e_set("encoding", str_decode(b'\xe4\xbd\xa0\xe5\xa5\xbd', "utf8", 'strict'))

  • Resultado

    test: asewds
    encoding: Hello

A função base64_encoding codifica dados com o algoritmo Base64.

• Sintaxe

  base64_encoding(value, format=None)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  value	String	Sim	Valor a codificar.
  format	String	Não	Esquema de codificação Base64. Valores válidos: RFC3548 e RFC4648. Valor padrão: RFC3548.

• Resposta

  Retorna uma string codificada.

• Exemplos

  • Log bruto

    str_en : data to be encoded

  • Regra de transformação

    e_set("str_base64",base64_encoding(v("str_en")))

  • Resultado

    str_en : data to be encoded
    str_base64 : ZGF0YSB0byBiZSBlbmNvZGVk

A função base64_decoding decodifica dados com o algoritmo Base64.

• Sintaxe

  base64_decoding(value, format=None)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  value	String	Sim	Valor a decodificar.
  format	String	Não	Esquema de decodificação Base64. Valores válidos: RFC3548 e RFC4648. Valor padrão: RFC3548. Nota O esquema de decodificação Base64 da RFC 4648 usa sinais de igual (=) para preencher um valor decodificado até atingir um múltiplo de 4 bytes.

• Resposta

  Retorna uma string decodificada.

• Exemplos

  • Log bruto

    str_de: ZGF0YSB0byBiZSBlbmNvZGVk

  • Regra de transformação

    e_set("str_de_base64",base64_decoding(v("str_de")))

  • Resultado

    str_de: ZGF0YSB0byBiZSBlbmNvZGVk
    str_de_base64: data to be encoded

A função html_encoding codifica dados no formato HTML.

• Sintaxe

  html_encoding(value)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  value	String	Sim	Valor a codificar.

• Resposta

  Retorna uma string codificada.

• Exemplos

  • Log bruto

    str : <img class="size-medium wp-image-113" style="margin-left: 15px;" title="su1" src="http://aliyundoc.com/wp-content/uploads/2008/10/su1-300x194.jpg" alt="" width="300" height="194" />

  • Regra de transformação

    e_set("str_html_en",html_encoding(v("str")))

  • Resultado

    str : <img class="size-medium wp-image-113" style="margin-left: 15px;" title="su1" src="http://aliyundoc.com/wp-content/uploads/2008/10/su1-300x194.jpg" alt="" width="300" height="194" />
    str_html_en : &lt;img class=&quot;size-medium wp-image-113&quot; style=&quot;margin-left: 15px;&quot; title=&quot;su1&quot; src=&quot;http://aliyundoc.com/wp-content/uploads/2008/10/su1-300x194.jpg&quot; alt=&quot;&quot; width=&quot;300&quot; height=&quot;194&quot; /&gt;

A função html_decoding decodifica dados codificados em HTML.

• Sintaxe

  html_decoding(value)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  value	String	Sim	Valor a decodificar.

• Resposta

  Retorna uma string decodificada.

• Exemplos

  • Log bruto

    str : <img class="size-medium wp-image-113" style="margin-left: 15px;" title="su1" src="http://aliyundoc.com/wp-content/uploads/2008/10/su1-300x194.jpg" alt="" width="300" height="194" />

  • Regra de transformação

    e_set("str_html_de",html_decoding(v("str")))

  • Resultado

    str : <img class="size-medium wp-image-113" style="margin-left: 15px;" title="su1" src="http://aliyundoc.com/wp-content/uploads/2008/10/su1-300x194.jpg" alt="" width="300" height="194" />
    str_html_de : <img class="size-medium wp-image-113" style="margin-left: 15px;" title="su1" src="http://aliyundoc.com/wp-content/uploads/2008/10/su1-300x194.jpg" alt="" width="300" height="194" />

A função url_encoding aplica codificação URL aos dados.

• Sintaxe

  url_encoding(value, plus=False)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  value	String	Sim	Valor a codificar.
  plus	Boolean	Não	Define se espaços devem ser convertidos em sinais de mais (+). Valor padrão: False. Valores válidos: True False

• Resposta

  Retorna uma string codificada.

• Exemplos

  • Exemplo 1: Aplicar codificação URL aos dados.

    • Log bruto

      content : https://www.example.org/hello/asdah

    • Regra de transformação

      e_set("url",url_encoding(v("content")))

    • Resultado

      content : https://www.example.org/hello/asdah
      url: https%3A%2F%www.example.org%2FHello%2Fasdah

  • Exemplo 2: Aplicar codificação URL aos dados. Mantenha o parâmetro plus sem configuração para evitar que espaços sejam convertidos em sinais de mais (+).

    • Log bruto

      content : 1 2+3:4

    • Regra de transformação

      e_set("URL",url_encoding(v("content")))

    • Resultado

      content:1 2+3:4
      URL:1%202%2B3%3A4

  • Exemplo 3: Aplicar codificação URL aos dados. Defina o parâmetro plus como True para converter espaços em sinais de mais (+).

    • Log bruto

      content : 1 2+3:4

    • Regra de transformação

      e_set("URL", url_encoding(v("content"), plus=True))

    • Resultado

      content:1 2+3:4
      URL:1+2%2B3%3A4

A função url_decoding aplica decodificação URL aos dados.

• Sintaxe

  url_decoding(value, plus=False)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  value	String	Sim	Valor a decodificar.
  plus	Boolean	Não	Define se sinais de mais (+) devem ser convertidos em espaços. Valor padrão: False. Valores válidos: True False

• Resposta

  Retorna uma string decodificada.

• Exemplos

  • Exemplo 1: Aplicar decodificação URL aos dados.

    • Log bruto

      content : https%3A%2F%www.example.org%2FHello%2Fasdah

    • Regra de transformação

      e_set("URL",url_decoding(v("content")))

    • Resultado

      content : https%3A%2F%www.example.org%2FHello%2Fasdah
      URL : https://www.example.org/hello/asdah

  • Exemplo 2: Aplicar decodificação URL aos dados. Mantenha o parâmetro plus sem configuração para evitar que sinais de mais (+) sejam convertidos em espaços.

    • Log bruto

      content : /answer?event_date=2022-06-30+09%3A06%3A53%20123

    • Regra de transformação

      e_set("URL",url_decoding(v("content")))

    • Resultado

      content:/answer?event_date=2022-06-30+09%3A06%3A53%20123
      URL:/answer?event_date=2022-06-30+09:06:53 123

  • Exemplo 3: Aplicar decodificação URL aos dados. Defina o parâmetro plus como True para converter sinais de mais (+) em espaços.

    • Log bruto

      content : /answer?event_date=2022-06-30+09%3A06%3A53%20123

    • Regra de transformação

      e_set("URL",url_decoding(v("content"),plus=True))

    • Resultado

      content:/answer?event_date=2022-06-30+09%3A06%3A53%20123
      URL:/answer?event_date=2022-06-30 09:06:53 123

A função jwt_encoding codifica dados JSON conforme o padrão JWT.

• Sintaxe

  jwt_encoding(payload, key, algorithms="HS256", headers=None)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  payload	JSON	Sim	Valor a codificar. Deve estar no formato JSON. O padrão JWT define os campos abaixo, mas também é possível definir campos personalizados. iss: emissor exp: tempo de expiração sub: assunto aud: público-alvo nbf: Não antes de iat: Emitido em jti: ID do JWT Exemplo de dados JSON brutos: { "iss": "localhost", "sub": "name", "aud": "user", "address": { "street": "street number", "city": "hangzhou", "country": "china" } }
  key	String	Sim	Chave para criptografar o JWT. Varia conforme o algoritmo de criptografia selecionado. Algoritmo de criptografia assimétrica: Chave privada codificada em PEM Algoritmo de criptografia simétrica: Chave bruta
  algorithms	String	Não	Algoritmo para assinar o JWT. Valor padrão: HS256. Valores válidos: HS256, HS384, HS512, ES256, ES256K, ES384, ES512, RS256, RS384, RS512, PS256, PS384, PS512 e EdDSA.
  headers	JSON	Não	Informações sobre o cabeçalho do JWT. Valor padrão: { "typ": "JWT", "alg": "HS256" }

• Resposta

  Retorna uma string codificada.

• Exemplos

  • Exemplo 1: Codificar o valor do campo data.

    • Log bruto

      data: {"some": "payload"}

    • Regra de transformação

      e_set("jwt_token", jwt_encoding(v("data"),"secret", algorithms="HS256"))

    • Resultado

      data:{"some": "payload"}
      jwt_token:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzb21lIjoicGF5bG9hZCJ9.Joh1R2dYzkRvDkqv3sygm5YyK8Gi4ShZqbhK2gxcs2U

  • Exemplo 2: Usar um algoritmo de criptografia assimétrica para codificar o valor do campo data.

    • Log bruto

      data: {"some": "payload"}

    • Regra de transformação

      e_set(
          "jwt_token",
          jwt_encoding(
              v("data"),
              "-----BEGIN RSA PRIVATE KEY-----\nMIICYQIBAAKBgQC1iaUr5cgShCn0127+w14XN297q/IviaewIeIJsKTZF1hBPsLn\nNIPsnqtQ9DFbjIyqyZvdmQFDJCSLpXaVc648yepnFDKbOfs3r+K4Crnpo2SuZmNV\nNDVEi4pECXlBz810zJY1wqVArM7qGAyCcRLBprwXB6wfEhk3CAP3c29+pwIDAQAB\nAoGAARo65I9arbIbxx7fz7BEDAQMK0YaDGvbltg91S07cw4PPSYybNEG1BMKm01A\nV3v9BrR+u9PIDC5WAnsYwiODqEoSyk8OwO1E2kWA6+MNclYYfVjaJeiRJ5PzCud/\niUObonptRzxuTng+u1oGuX7QwUhwGJdXVBUAtJFYwXR2qVECRQC5S+6vdFESRLSX\n7yBZVM6+49lZcdehMv0HwT17UseLvWcjeSbiogvv02HbYilrW9ZydKsixAWP5w/U\nS3L34CS811VcDQI9APrOiL7c1xg5fX8wAWv2d+e+MfZoB3ohb8671W3pmp3JVnjY\ntzhoYNNQmnmRQQWf7n3J63MQz4sYYNn0gwJEE/pl37Dw1MFnn0H/AOKt79LtKkGl\n+BFhSqbBFDzWmvBu4Fo9oQ3Lr63gzSCGSrb6JhkCIptz5hIJmOARozwdeebVozkC\nPQDwOqVmU3c/P8nB6oRiGditw1Jt1yTaSW6jkOyUc73iRngqFkIgqHGd1kWwDX4/\nWfoAyEhalY6Fh5s1COsCRQCy4b3hnQws5zz/gmGNnoyxn9N+A09ySaFtn2WkUlrR\nZ6DwoJz+n6EgjLY8z6ZQyv342iobO5zKkZHFvO9QYGqk7y8lJA==\n-----END RSA PRIVATE KEY-----\n",
              algorithms="RS256",
          ),
      )

    • Resultado

      data:{"some": "payload"}
      jwt_token:eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzb21lIjoicGF5bG9hZCJ9.Ewwls5YPuJCmAR3XR2tcptOLrH83wVCzmUaUpGMzMLcPknRrIvbDmFGlNlQha-PMx0jsxt3t1oxpz7P3z3SR9o4qyWusAb99UG_Jn8oP8W0a5GKSy4UEJB0xgpVvJl5F2JaIPeUSHpV0VeS2WAsGSBBSAaOMkrc-8uie-H4J9M0

  • Exemplo 3: Definir o parâmetro algorithm como HS256 e configurar o parâmetro headers para codificar o valor do campo data.

    • Log bruto

      data: {"some": "payload"}

    • Regra de transformação

      e_set(
          "jwt_token",
          jwt_encoding(
              v("data"),
              "secret",
              algorithms="HS256",
              headers={"kid": "230498151c214b788dd97f22b85410a5"},
          ),
      )                                        

    • Resultado

      data:{"some": "payload"}
      jwt_token:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiIsImtpZCI6IjIzMDQ5ODE1MWMyMTRiNzg4ZGQ5N2YyMmI4NTQxMGE1In0.eyJzb21lIjoicGF5bG9hZCJ9.gdQ884yjlnLnIrYjfQaClE6rJC2x8v2OP2s_eXOLhZA

  • Exemplo 4: Especificar um campo JWT personalizado para o campo data e codificar seu valor.

    • Log bruto

      data: {"some": "payload", "iss": 9, "sub": "name", "nbf": 123, "iat": "22"}

    • Regra de transformação

      e_set("jwt_token", jwt_encoding(v("data"),"secret"))

    • Resultado

      data:{"some": "payload", "iss": 9, "sub": "name", "nbf": 123, "iat": "22"}
      jwt_token:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzb21lIjoicGF5bG9hZCIsImlzcyI6OSwic3ViIjoibmFtZSIsIm5iZiI6MTIzLCJpYXQiOiIyMiJ9.c6MxZHdXsgASchQ1Mdqj208NO_3rNGjYnvo6c7HNAyk

A função jwt_decoding decodifica dados para JSON bruto conforme o padrão JWT.

• Sintaxe

  jwt_decoding(jwt_payload, key="", algorithms=None, options=None, audience=None, issuer=None, leeway=0)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  jwt_payload	String	Sim	Valor a decodificar.
  key	String	Sim	Chave para descriptografar os dados. Deve ser idêntica à chave usada na codificação.
  algorithms	List	Não	Algoritmo para assinar o JWT. Exemplo: HS256.
  options	JSON	Não	Opções estendidas para decodificação e verificação. Valores válidos: verify_signature: Define se a assinatura JWT criptografada deve ser verificada. Valor padrão: True. require: Especifica os campos obrigatórios nos dados codificados. Por padrão, esta opção está vazia. Exemplo: ["exp", "iat", "nbf"]. verify_aud: Define se o campo aud deve ser verificado. Valor padrão: True. verify_iss: Define se o campo iss deve ser verificado. Valor padrão: True. verify_exp: Define se o campo exp deve ser verificado. Valor padrão: True. verify_iat: Define se o campo iat deve ser verificado. Valor padrão: True. verify_nbf: Define se o campo nbf deve ser verificado. Valor padrão: True. Exemplo: {"require": ["aud"], "verify_aud": True}.
  audience	String/List	Não	Verifica o valor do campo aud. Configure este parâmetro se o campo aud for especificado na codificação e "require": ["aud"] ou "verify_aud": True for definido no parâmetro options.
  issuer	String	Não	Verifica o valor do campo iss. Configure este parâmetro se o campo iss for especificado na codificação e "require": ["iss"] ou "verify_iss": True for definido no parâmetro options.
  leeway	float	Não	Intervalo para verificação de expiração. Unidade: segundos.

• Resposta

  Retorna uma string decodificada.

• Exemplos

  • Exemplo 1: Definir o algoritmo de assinatura para descriptografia como HS256 para decodificar o valor do campo data.

    • Log bruto

      data:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzb21lIjoicGF5bG9hZCJ9.Joh1R2dYzkRvDkqv3sygm5YyK8Gi4ShZqbhK2gxcs2U

    • Regra de transformação

      e_set("data_decoded", jwt_decoding(v("data"), "secret", algorithms="HS256"))

    • Resultado

      data_decoded: {"some": "payload"}

  • Exemplo 2: Usar uma chave pública para decodificar o valor do campo data.

    • Log bruto

      data: "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzb21lIjoicGF5bG9hZCJ9.Ewwls5YPuJCmAR3XR2tcptOLrH83wVCzmUaUpGMzMLcPknRrIvbDmFGlNlQha-PMx0jsxt3t1oxpz7P3z3SR9o4qyWusAb99UG_Jn8oP8W0a5GKSy4UEJB0xgpVvJl5F2JaIPeUSHpV0VeS2WAsGSBBSAaOMkrc-8uie-H4J9M0"

    • Regra de transformação

      e_set(
          "data_decoded",
          jwt_decoding(
              v("data"),
              "-----BEGIN RSA PUBLIC KEY-----\nMIGJAoGBALWJpSvlyBKEKfTXbv7DXhc3b3ur8i+Jp7Ah4gmwpNkXWEE+wuc0g+ye\nq1D0MVuMjKrJm92ZAUMkJIuldpVzrjzJ6mcUMps5+zev4rgKuemjZK5mY1U0NUSL\nikQJeUHPzXTMljXCpUCszuoYDIJxEsGmvBcHrB8SGTcIA/dzb36nAgMBAAE=\n-----END RSA PUBLIC KEY-----\n",
              algorithms="RS256",
          ),
      )                                        

    • Resultado

      data_decoded: {"some": "payload"}
      data:"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzb21lIjoicGF5bG9hZCJ9.Ewwls5YPuJCmAR3XR2tcptOLrH83wVCzmUaUpGMzMLcPknRrIvbDmFGlNlQha-PMx0jsxt3t1oxpz7P3z3SR9o4qyWusAb99UG_Jn8oP8W0a5GKSy4UEJB0xgpVvJl5F2JaIPeUSHpV0VeS2WAsGSBBSAaOMkrc-8uie-H4J9M0"

  • Exemplo 3: Usar o valor padrão do parâmetro options para decodificar o valor do campo data.

    • Log bruto

      data: "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzb21lIjoicGF5bG9hZCIsImlzcyI6OSwic3ViIjoibmFtZSIsIm5iZiI6MTIzLCJpYXQiOiIyMiJ9.DzvqhJd0PrTFk6eeASGZxOoDtrLBt_H3xC7CqOATRRw"

    • Regra de transformação

      e_set(
          "data_decoded", jwt_decoding(v("data"), "secret", algorithms="HS256", options=None)
      )

    • Resultado

      data_decoded:{
              "some": "payload",
              "iss": 9,
              "sub": "name",
              "nbf": 123,
              "iat": "22"
          }
      data:"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzb21lIjoicGF5bG9hZCIsImlzcyI6OSwic3ViIjoibmFtZSIsIm5iZiI6MTIzLCJpYXQiOiIyMiJ9.DzvqhJd0PrTFk6eeASGZxOoDtrLBt_H3xC7CqOATRRw"

  • Exemplo 4: Especificar um valor personalizado para o parâmetro options para decodificar o valor do campo data.

    • Log bruto

      data: "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzb21lIjoicGF5bG9hZCIsImlzcyI6Im5hbWUifQ.XwT9jqwofcdSP6olidbiYPC6CnZd36OEqCHZmGmooWM"

    • Regra de transformação

      e_set(
          "data_decoded",
          jwt_decoding(
              v("data"),
              "secret",
              algorithms="HS256",
              options={"require": ["iss"], "verify_iss": True},
              issuer="name",
          ),
      )

    • Resultado

      data_decoded:{"some": "payload", "iss": "name"}
      data: "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzb21lIjoicGF5bG9hZCIsImlzcyI6Im5hbWUifQ.XwT9jqwofcdSP6olidbiYPC6CnZd36OEqCHZmGmooWM"

A função gzip_compress comprime e codifica dados.

• Sintaxe

  gzip_compress(data, compresslevel=6, to_format="base64", encoding="utf-8")

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  data	String	Sim	Dados a comprimir.
  compresslevel	Int	Não	Nível de compressão. Valores válidos: 0 a 9. Valor padrão: 6. 1: Maior velocidade de compressão e menor taxa de compressão. 9: Menor velocidade de compressão e maior taxa de compressão. 0: Sem compressão de dados.
  to_format	String	Não	Formato de codificação para os dados comprimidos. Valores válidos: base64 e hex.
  encoding	String	Não	Formato de codificação para os dados brutos. Valor padrão: utf-8. Para mais informações sobre outros formatos de codificação, consulte Formatos de codificação padrão.

• Resposta

  Retorna uma string codificada.

• Exemplos

  • Exemplo 1: Comprimir um campo de log e codificá-lo com o algoritmo Base64.

    • Log bruto

      content: I always look forward to my holidays whether I travel or stay at home.

    • Regra de transformação

      e_set("base64_encode_gzip_compress",gzip_compress(v("content"),to_format="base64"))

    • Resultado

      content: I always look forward to my holidays whether I travel or stay at home.
      base64_encode_gzip_compress: H4sIAA8JXl4C/xXK0QmAMAwFwFXeBO7RMQKNREx5kAZDtle/7wbES3rDyRsnoyQmklgNo1/ztzJN08BAhjzqYGCnNCS/tPR4AcgrnWVGAAAA

  • Exemplo 2: Codificar um campo de log com o formato de codificação HEX.

    • Log bruto

      content: H4sIAA8JXl4C/xXK0QmAMAwFwFXeBO7RMQKNREx5kAZDtle/7wbES3rDyRsnoyQmklgNo1/ztzJN08BAhjzqYGCnNCS/tPR4AcgrnWVGAAAA

    • Regra de transformação

      e_set("hex_encode_gzip_compress", gzip_compress(v("content"), to_format="hex"))

    • Resultado

      content:H4sIAA8JXl4C/xXK0QmAMAwFwFXeBO7RMQKNREx5kAZDtle/7wbES3rDyRsnoyQmklgNo1/ztzJN08BAhjzqYGCnNCS/tPR4AcgrnWVGAAAA
      hex_encode_gzip_compress:1f8b08004a478c6202ff0dc1dd0e43301800d047aa65156e3ff52f4a2ba17649c43255194d4a9f9e73527c64007e2e2426e81485c35628c1c42616535079bc6405e5d1e92ef009b59c906786a879efe1c50fb55d6c5de44cb717b2dae6d4f103f8feecbf4f88a2a441bae618c679575d9bc0e306907876806c000000

A função gzip_decompress descomprime dados compactados.

• Sintaxe

  gzip_decompress(data, from_format="base64", encoding="utf-8")

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  data	Arbitrário	Sim	Dados a descomprimir.
  from_format	String	Não	Formato de codificação dos dados comprimidos. Valores válidos: base64 e hex.
  encoding	String	Não	Formato de codificação dos dados brutos. Valor padrão: utf-8. Para mais informações sobre outros formatos de codificação, consulte Formatos de codificação padrão.

• Resposta

  Retorna dados descomprimidos.

• Exemplos

  • Exemplo 1: Decodificar um campo de log com o algoritmo Base64.

    • Log bruto

      content: H4sIAA8JXl4C/xXK0QmAMAwFwFXeBO7RMQKNREx5kAZDtle/7wbES3rDyRsnoyQmklgNo1/ztzJN08BAhjzqYGCnNCS/tPR4AcgrnWVGAAAA

    • Regra de transformação

      e_set("gzip_decompress",gzip_decompress(v("content"),from_format="base64"))

    • Resultado

      content: H4sIAA8JXl4C/xXK0QmAMAwFwFXeBO7RMQKNREx5kAZDtle/7wbES3rDyRsnoyQmklgNo1/ztzJN08BAhjzqYGCnNCS/tPR4AcgrnWVGAAAA
      gzip_decompress: I always look forward to my holidays whether I travel or stay at home.

  • Exemplo 2: Decodificar um campo de log com o formato de decodificação HEX.

    • Log bruto

      content:1f8b0800bff8856202ff0dc1dd0e43301800d047aa65156e3ff52f4a2ba17649c43255194d4a9f9e73527c64007e2e2426e81485c35628c1c42616535079bc6405e5d1e92ef009b59c906786a879efe1c50fb55d6c5de44cb717b2dae6d4f103f8feecbf4f88a2a441bae618c679575d9bc0e306907876806c000000

    • Regra de transformação

      e_set("gzip_decompress", gzip_decompress(v("content"), from_format="hex"))

    • Resultado

      content:1f8b0800bff8856202ff0dc1dd0e43301800d047aa65156e3ff52f4a2ba17649c43255194d4a9f9e73527c64007e2e2426e81485c35628c1c42616535079bc6405e5d1e92ef009b59c906786a879efe1c50fb55d6c5de44cb717b2dae6d4f103f8feecbf4f88a2a441bae618c679575d9bc0e306907876806c000000
      gzip_decompress:H4sIAA8JXl4C/xXK0QmAMAwFwFXeBO7RMQKNREx5kAZDtle/7wbES3rDyRsnoyQmklgNo1/ztzJN08BAhjzqYGCnNCS/tPR4AcgrnWVGAAAA

A função zlib_compress comprime e codifica dados.

• Sintaxe

  zlib_compress(data, compresslevel=6, to_format="base64", encoding="utf-8")

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  data	String	Sim	Dados a comprimir.
  compresslevel	Int	Não	Nível de compressão. Valores válidos: 0 a 9. Valor padrão: 6. 1: Maior velocidade de compressão e menor taxa de compressão. 9: Menor velocidade de compressão e maior taxa de compressão. 0: Sem compressão de dados.
  to_format	String	Não	Formato de codificação para os dados comprimidos. Defina o valor como base64.
  encoding	String	Não	Formato de codificação para os dados brutos. Valor padrão: utf-8. Para mais informações sobre outros formatos de codificação, consulte Formatos de codificação padrão.

• Resposta

  Retorna dados codificados.

• Exemplos

  • Log bruto

    content: I always look forward to my holidays whether I travel or stay at home.

  • Regra de transformação

    e_set("zlib_compress", zlib_compress(v("content"), to_format="base64"))

  • Resultado

    zlib_compress: "eJwVytEJgDAMBcBV3gTu0TECjURMeZAGQ7ZXv+8GxEt6w8kbJ6MkJpJYDaNf87cyTdPAQIY86mBgpzQkv7T0eAGNshln"
    content: "I always look forward to my holidays whether I travel or stay at home."

A função zlib_decompress descomprime dados compactados.

• Sintaxe

  zlib_decompress(data, from_format="base64", encoding="utf-8")

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  data	String	Sim	Dados a descomprimir.
  from_format	String	Não	Formato de codificação dos dados comprimidos. Defina o valor como base64.
  encoding	String	Não	Formato de codificação. Valor padrão: utf-8. Para mais informações sobre outros formatos de codificação, consulte Formatos de codificação padrão.

• Resposta

  Retorna dados descomprimidos.

• Exemplos

  • Log bruto

    content: "eJwVytEJgDAMBcBV3gTu0TECjURMeZAGQ7ZXv+8GxEt6w8kbJ6MkJpJYDaNf87cyTdPAQIY86mBgpzQkv7T0eAGNshln"

  • Regra de transformação

    e_set("zlib_decompress", zlib_decompress(v("content"), from_format="base64"))

  • Resultado

    content: "eJwVytEJgDAMBcBV3gTu0TECjURMeZAGQ7ZXv+8GxEt6w8kbJ6MkJpJYDaNf87cyTdPAQIY86mBgpzQkv7T0eAGNshln"
    zlib_decompress: "I always look forward to my holidays whether I travel or stay at home."

A função aes_encrypt criptografa dados com o algoritmo AES. O AES é um algoritmo de criptografia simétrica comum. Para melhorar a segurança dos dados, utilize-o para criptografia.

• Sintaxe

  aes_encrypt(data, key, mode, pad_style, pad_block, input_format, input_encoding, output_format, iv)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  data	String	Sim	Dados a criptografar.
  key	String	Sim	Chave para criptografar os dados.
  mode	String	Não	Modo de criptografia AES. CBC: Cipher Block Chaining (padrão) ECB: Electronic Code Book CFB: Cipher Feedback OFB: Output Feedback CTR: Counter OPENPGP
  pad_style	String	Não	Modo de preenchimento. Valor padrão: pkcs7. Valores válidos: iso7816, x923 e pkcs7.
  input_format	String	Não	Formato dos caracteres de entrada. Valor padrão: raw. Valores válidos: raw: bytes hex: hexadecimal base64: Codificado em Base64
  input_encoding	String	Não	Formato de codificação dos caracteres de entrada. Necessário apenas se input_format for definido como raw. Valor padrão: utf-8.
  output_format	String	Não	Formato dos caracteres de saída. Valor padrão: hex. Valores válidos: raw: bytes hex: hexadecimal base64: Codificado em Base64
  iv	Bytes	Não	Deslocamento para criptografia.

• Resposta

  Retorna uma string criptografada.

• Exemplos

  • Exemplo 1

    • Log bruto

      "test": "aliyuntest"

    • Regra de transformação

      e_set('result',aes_encrypt(v("test"), "qwertyuiopasdfgd", iv=b"xxywosjdapdiawdk", output_format="base64"))

    • Resultado

      "result": "gXIqu0cBBtZHQxJBK8GLeA=="

  • Exemplo 2

    • Log bruto

      "test": "aliyuntest"

    • Regra de transformação

      e_set('result',aes_encrypt(v("test"), "qwertyuiopasdfgh", iv=b"ywisnjaduaqibdqi", mode="OFB"))

    • Resultado

      "result":  "5cac3e9e1c42f713dc6d"

A função aes_decrypt descriptografa dados com o algoritmo AES.

• Sintaxe

  aes_decrypt(data, key, mode, pad_style, input_format, input_encoding, output_format, iv, output_encoding)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  data	String	Sim	Dados a descriptografar.
  key	String	Sim	Chave para descriptografar os dados.
  mode	String	Não	Modo de descriptografia AES. CBC: Cipher Block Chaining (padrão) ECB: Electronic Code Book CFB: Cipher Feedback OFB: Output Feedback CTR: Counter OPENPGP
  pad_style	String	Não	Modo de preenchimento. Valor padrão: pkcs7. Valores válidos: iso7816, x923 e pkcs7.
  input_format	String	Não	Formato dos caracteres de entrada. Valor padrão: hex. Valores válidos: raw: bytes hex: hexadecimal base64: Codificado em Base64
  input_encoding	String	Não	Formato de codificação dos caracteres de entrada. Necessário apenas se input_format for definido como raw. Valor padrão: utf-8.
  output_format	String	Não	Formato dos caracteres de saída. Valor padrão: raw. Valores válidos: raw: bytes hex: hexadecimal base64: Codificado em Base64
  iv	Bytes	Não	Deslocamento para descriptografia.
  output_encoding	String	Não	Formato de codificação dos caracteres de saída. Valor padrão: None.

• Resposta

  Retorna uma string descriptografada.

• Exemplos

  • Exemplo 1

    • Log bruto

      "test": "gXIqu0cBBtZHQxJBK8GLeA=="

    • Regra de transformação

      e_set('result', aes_decrypt(v("test"), "qwertyuiopasdfgd", iv=b"xxywosjdapdiawdk", input_format="base64"))

    • Resultado

      "result": "aliyuntest"

  • Exemplo 2

    • Log bruto

      "test": "5cac3e9e1c42f713dc6d"

    • Regra de transformação

         e_set('result', aes_decrypt(v("test"), "qwertyuiopasdfgh", iv=b"ywisnjaduaqibdqi", mode="OFB"))

    • Resultado

      "result": "aliyuntest"

A função md5_encoding codifica dados com o algoritmo MD5.

• Sintaxe

  md5_encoding(value, format="hex")

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  value	String	Sim	Valor a codificar.
  format	String	Não	Valores válidos: binary e hex. Valor padrão: hex.

• Resposta

  Retorna uma string codificada.

• Exemplos

  • Exemplo 1

    • Log bruto

      str : GeeksforGeeks

    • Regra de transformação

      e_set("str_md5_en",md5_encoding(v("str")))

    • Resultado

      str : GeeksforGeeks
      str_md5_en : f1e069787ece74531d112559945c6871

  • Exemplo 2

    • Log bruto

      str : GeeksforGeeks

    • Regra de transformação

      e_set("str_md5_en",base64_encoding(md5_encoding(v("str"), format="binary")))

    • Resultado

      str : GeeksforGeeks
      str_md5_en : 8eBpeH7OdFMdESVZlFxocQ==

A função sha1_encoding codifica dados com o algoritmo SHA1.

• Sintaxe

  sha1_encoding(value, format=None)

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  value	String	Sim	Valor a codificar.
  format	String	Não	Tipo de codificação. Valores válidos: SHA1, SHA224, SHA256, SHA384 e SHA512. Valor padrão: SHA1.

• Resposta

  Retorna uma string codificada.

• Exemplos

  • Log bruto

    str : GeeksforGeeks

  • Regra de transformação

    e_set("str_sha1",sha1_encoding(v("str")))
    e_set("str_sha512",sha1_encoding(v("str"),format='SHA512'))
    e_set("str_sha224",sha1_encoding(v("str"),format='SHA224'))
    e_set("str_sha384",sha1_encoding(v("str"),format='SHA384'))
    e_set("str_sha256",sha1_encoding(v("str"),format='SHA256'))

  • Resultado

    str : GeeksforGeeks
    str_sha1 : 4175a37afd561152fb60c305d4fa6026b7e79856
    str_sha512 : 0d8fb9370a5bf7b892be4865cdf8b658a82209624e33ed71cae353b0df254a75db63d1baa35ad99f26f1b399c31f3c666a7fc67ecef3bdcdb7d60e8ada90b722
    str_sha224 : 173994f309f727ca939bb185086cd7b36e66141c9e52ba0bdcfd145d
    str_sha384 : d1e67b8819b009ec7929933b6fc1928dd64b5df31bcde6381b9d3f90488d253240490460c0a5a1a873da8236c12ef9b3
    str_sha256 : f6071725e7ddeb434fb6b32b8ec4a2b14dd7db0d785347b2fb48f9975126178f

A função crc32_encoding calcula um código CRC para os dados.

• Sintaxe

  crc32_encoding(data, input_format="raw", input_encoding="utf-8")

• Parâmetros

  Parâmetro	Tipo	Obrigatório	Descrição
  data	String	Sim	Valor para cálculo do código CRC.
  input_format	String	Não	Formato dos caracteres de entrada. Valor padrão: raw. Valores válidos: raw: bytes hex: hexadecimal base64: Codificado em Base64
  input_encoding	String	Não	Formato de codificação dos caracteres de entrada. Necessário apenas se input_format for definido como raw. Valor padrão: utf-8.

• Resposta

  Retorna o código CRC do valor de entrada.

• Exemplos

  • Exemplo 1: Calcular um código CRC para o campo test.

    • Log bruto

      test: aliyuntest

    • Regra de transformação

      e_set("str_crc32", crc32_encoding(v("test")))

    • Resultado

      str_crc32:1434103726
      test:aliyuntest

  • Exemplo 2: Unir os campos test1 e test2, codificá-los com o algoritmo MD5 e calcular um código CRC para o resultado.

    • Log bruto

      test1: test1
      test2: test2

    • Regra de transformação

      e_set(
          "str_crc32",
          crc32_encoding(
              md5_encoding(str_join("+", v("test1"), v("test2")), format="binary")
          ),
      )

    • Resultado

      str_crc32:369733261
      test1:test1
      test2:test2

  • Exemplo 3: Calcular um código CRC para o campo test. O valor do campo está codificado em Base64.

    • Log bruto

      test: Taloz+e+PzP3NltrEXiCig==

    • Regra de transformação

      e_set("str_crc32", crc32_encoding(v("test"), input_format="base64"))

    • Resultado

      str_crc32:1093789404
      test:Taloz+e+PzP3NltrEXiCig==