Skip navigation
Toggle Sidebar

Certificates


Certain Connectors and document types may require the use of a certificate in order to ensure security when transmitting data across the communication protocol. Connectors such as FTPS, SFTP, HTTPS, AS2 and many others require the use of certificates in order to encrypt data and channels and to verify the digital signature of the person sending the data.

The Certificate component may use an existing key obtained from a certificate authority such as Verisign or Thawte or it may use a key generated by Dell Boomi. Keys generated by Dell Boomi are no less secure than purchased certificates.

You can create two types of Dell Boomi certificates: X.509 or PGP. A Dell Boomi certificate can be public or private.

  • A public certificate contains only a public key.
  • A private certificate contains both public and private keys.

If you open a private certificate you can:

  • Import another private certificate into it
  • Export its private and public keys.

If you open a public certificate you can:

  • Import another public certificate into it
  • Export its public key.

Private and public certificate file names have different file extensions.

Certificate Type
File Extension(s)
Public X.509
.cer
.der
Private X.509 .pfx
.p12
Public PGP
_pub.asc
Private PGP
_priv.asc

Note: Please check the documentation about the specific Connector that you are using for more information about its specific certificate usage.


Creating a Certificate and Generating a Private Key

When you create an X.509 certificate and generate a private key for it you must provide the following information, which will be stored in the private certificate.

X.509 Field Description
Company Name (CN) Free-form description
Organization (O) Free-form description
Organizational Unit (OU) Free-form description
Locality City
State/Province (ST) State abbreviation
Country (C) Country abbreviation; US = United States
Signature Algorithm MD5 (default)
SHA1
Key Length 2048 (default)
1024
768
Validity (in days) 365 (default)

When you create a PGP certificate and generate a private key for it you must provide the following information, which will be stored in the private certificate.

PGP Field Description
Identity Free-form description
Pass Phrase
boomi
Key Algorithm DSA (default)
RSA
Key Length
512 (default)
1024


To Create a Certificate and Generate a Private Key

  1. On the Build menu click Create Component.
    The Create Component window opens.
  2. Select Certificate from the first select box.
  3. Type a name for the certificate.
  4. Select the folder in which to save the certificate.
  5. Select the type of certification (X.509 or PGP) that you would like to generate.
  6. Click Create.
    A tab appears to the right with the certificate's name.
  7. Click Generate or Generate Private Key.
    The Generate Private Key Wizard opens.
  8. Enter the required information for the X.509 or PGP certificate. See Generating Private Keys for information.
  9. Click Finish.
    The X.509 or PGP certificate details are displayed on the tab.

  10. Click Save or Save and Close.


Creating a Certificate by Importing a Certificate

When you create an X.509 or PGP certificate you can import an existing private or public certificate into it. If you import a private certificate your new certificate is private. If you import a public certificate your new certificate is public.

To Create a Certificate by Importing a Certificate

  1. On the Build menu click Create Component.
    The Create Component window opens.
  2. Select Certificate from the first select box.
  3. Type a name for the certificate.
  4. Select the folder in which to save the certificate.
  5. Select the type of certification (X.509 or PGP) that you would like to import.
  6. Click Create.
    A tab appears to the right with the certificate's name.
  7. Click Import.
    The Import Certificate Wizard or Import PGP Certificate Wizard opens.
  8. Click Browse and locate the private or public certificate file.
  9. (Optional) Enter a pass phrase or password, if required.
  10. Click Finish.
    The certificate details are displayed on the tab.
  11. Click Save or Save and Close.


Modifying Certificates

After creating a Dell Boomi certificate you can change its name.

If you created a private certificate you also can choose to re-import a private certificate or regenerate the private key. This will overwrite the current certificate, saving you from the trouble of creating a new certificate and changing any Process components to reference the new certificate. This is very useful when you have to replace expired certificates.

If you created a public certificate you also can re-import a public certificate, which is similar to re-importing a private certificate. You cannot generate a new key for a public certificate.

To Import a Certificate

  1. On the Build menu open an existing private or public certificate.
  2. Click Import.
    The Import Certificate Wizard or Import PGP Certificate Wizard opens.
  3. Click Browse and locate the private or public certificate file.
  4. (Optional) Enter a pass phrase or password, if required.
  5. Click Finish.
    The certificate details are displayed on the tab.
  6. Click Save or Save and Close.

To Generate a Private Key for a Certificate

  1. On the Build menu open an existing private certificate. 
  2. Click Generate.
    The Generate Private Key Wizard opens.
  3. Enter the required information for the X.509 or PGP certificate. See Generating Private Keys for information.
  4. Click Finish.
    The certificate details are displayed on the tab.
  5. Click Save or Save and Close.


Exporting Certificates

After creating a private certificate you can export its public and/or private keys. After creating a public certificate you can export only its public key. You may want to export a public key to give to your trading partner (or other client application) to encrypt the data they send you.

See general information about certificates for information about the file extensions for public and private keys. Exported private keys are password protected with the password "boomi".

To Export a Public or Private Key

  1. On the Build menu open an existing private or public certificate.
  2. If you opened a public or private certificate, click Export Public Cert.
    A dialog opens showing you the file name and prompting you to open or save the file.
  3. Do one of the following:
    Click Open and Browse to select an application, then OK.
    Click Save then OK.
    The file is opened or saved.
  4. If you opened a private certificate, click Export Private Key.
    A dialog opens showing you the file name and prompting you to open or save the file.
  5. Do one of the following:
    Click Open and Browse to select an application, then OK.
    Click Save then OK.
    The file is opened or saved.

Adaptavist Theme Builder Powered by Atlassian Confluence