Official Content

This is part of GeneXus Cryptography Module. and allows to manage certificates, for asymmetric Encryption.

Certificate

Valid Public Key formats

  • Encoded Base64 key PKCS8 formatted (.pem extension). It can contain a public key, private key, certificate or both.  
    • Encrypted .pem files are not supported
    • Files with .key extensions are supported since GeneXus 16 Upgrade 11
  • DER certificate (.crt or .cer extension). It contains only public keys.
  • PKCS12 certificate or keystore (.p12 or .pfx or .jks extension). It contains only private keys or both.
    • JKS format (JavaKeyStore) is available only for Java implementation.
    • For PKCS12 certificates the file password is needed for both Java and .Net implementations.
    • .Net implementation does not use the PKCS12 alias; it takes the public key from the first certificate on the certificate chain and the first default private key listed on the file.
    • Files with .pkcs12 extensions are supported since GeneXus 16 Upgrade 11
  • Every certificate must implement the X509 standard.
  • Public keys outside certificates are admitted in PKCS8 format. Supported since GeneXus 18 Upgrade 4

Properties

  • String issuer
  • String subject
  • String serialNumber
  • String thumbprint
  • Date notAfter
  • Date notBefore
  • int version

Load

Certificate.Load(path)
  • Input path: VarChar(256) path to the X509 certificate
  • Returns: Boolean true if it is correctly loaded

LoadPKCS12

Certificate.LoadPKCS12(path, alias, password)
  • Input path: VarChar(256) path of the X509 certificate 
  • Input alias: Character(100) certificate's alias
  • Input password: Character(100) file password
  • Returns Boolean true if it is correctly loaded

Loads a public key from a PKCS#12 formatted certificate.

FromBase64

Certificate.FromBase64(base64Data)
  • Input base64Data: VarChar(256) base64 encoded X509 certificate
  • Returns Boolean true if it is correctly loaded

Loads an X509 certificate from its base64 encoded representation.

ToBase64

Certificate.ToBase64()
  • Returns VarChar(256) base64 encoded certificate

Retrieves the loaded certificate on base64 encoding.

 




Last update: February 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant