< Back to Top

Partner Mailbox Endpoint

A Partner Mailbox Endpoint allows CIC to act as an FTP or SFTP server. Your trading partners can connect to a Partner Mailbox as an FTP or SFTP client or as a Cleo Portal client.

Partner Mailbox Properties

Allowed Connections
Select one or all the following: FTP, SFTP, and Cleo Portal. 
If you select FTP, you can also choose to require a secure connection. 
Allowed File Types
Restrict what kinds of files are permitted to be processed by this Endpoint. Choose from the following: 
All
No restriction. Allow any kind of file. 
Allow upload of ONLY the following types 
Specify a comma- or semi-colon-separated list of filename patterns allowed to be processed by this Endpoint. You can use wildcards and regular expressions. See Using Wildcards and Regular Expressions in CIC. 
Authentication Type
This section is displayed whenever you select SFTP in the Allowed Connections section. 
Choose from the following: 
Password
Use username/password authentication only. 
Available whenever you select SFTP in the Allowed Connections section.
Key Authentication
Use key authentication only.
Available when you select only SFTP in the Allowed Connections section. 
Requires that you paste a key value into the Key Authentication field. 
Password or Key
Allow use of username/password or key authentication.
Available whenever you select SFTP in the Allowed Connections section. 
Requires that you paste a key value into the Key Authentication field. 
Password and Key
Use both username/password and key authentication.
Available when you select only SFTP in the Allowed Connections section. 
Requires that you paste a key value into the Key Authentication field.
Username
Required. Specify the username to be used with the password below for authentication when you log in to the Cleo Portal to upload and download from this partner mailbox. 
Password 
Confirm Password
Required. Specify the password to be used with the username for authentication. 
Passwords must be at least 8 characters long and include:
  • 1 uppercase
  • 1 lowercase
  • 1 number
  • 1 special character.
Key Authentication
Specify the key to be used for authentication.
Email
Optional. Specify the email address where you want to receive password reset requests.
OpenPGP
Inbound
Verify Signed Payloads
Select to ensure that when a signed payload is received, the signature matches the payload that was sent. 
When you select this check box, you are prompted to select the trading partner's signing certificate. This field is prefilled with the outbound encryption certificate as the same certificate is commonly used for both. See Selecting a certificate. 
Accept Encrypted Payloads
Select to accept encrypted inbound payloads. 
When you select this check box, you are prompted to select your decryption certificate. This field is prefilled with the outbound signing certificate as the same certificate is commonly used for both. See Selecting a certificate.
Outbound
Sign
Sign messages sent from this Endpoint. 
When you select Sign, you are prompted to select your signing certificate. This field is prefilled with the inbound decryption certificate as the same certificate is commonly used for both. See Selecting a certificate.
Encrypt
Apply encryption to messages sent from this Endpoint. 
When you select Encrypt, you are prompted to select the trading partner's encryption certificate. This field is prefilled with the inbound signing certificate as the same certificate is commonly used for both. See Selecting a certificate.
Compress
Apply ZLIB compression to messages sent from this Endpoint. Choose this option for large files to conserve bandwidth and improve efficiency and security.
Text Output (ASCII armor)
Encase encrypted messages in ASCII for ease of sending using standard messaging formats.
Advanced
OpenPGP Algorithms
Hash Algorithm
Choose the signing method used when OpenPGP packaging (with signing) is requested from the following:
  • MD2
  • MD5
  • RIPE-MD-160
  • SHA-1
  • SHA-256
  • SHA-384
  • SHA-512
V3 Signature
Select this check box to sign messages with Version 3 signatures.
Encryption Algorithm
Choose the algorithm you want to use to encrypt messages. The remote host receiving the message must be able to decrypt the message using the algorithm you choose. Choose from the following:
  • DES
  • 3DES
  • AES/128
  • AES/192
  • AES/256
  • CASTS
  • TWOFISH
  • BLOWFISH
Compression Algorithm
Choose the algorithm you want to use to compress messages. The remote host receiving the message must be able to decrypt the message using the algorithm you choose.
Choose either ZIP or ZLIB.
General
Password Expiration
Select to allow passwords to expire. 
Expire password after 
Select a period after which passwords expire. 
Default value is 6 months.

Using Cleo Portal to Connect to a Partner Mailbox

Of the several ways you can access the files in a Partner Mailbox, the Cleo Portal is perhaps the easiest to implement.  When you create a Partner Mailbox, you create a username and password that you use to log in to the Cleo Portal. 
  1. Create a Partner Mailbox Endpoint. 
  2. Select the Cleo Portal checkbox.
  3. Take note of the Username and Password you enter. You will need these values to log in to the Cleo Portal.
  4. Open a browser and go to acme.cleointegration.cloud/Portal. The Portal login page is displayed.
  5. Enter your username and password (from when you created the Partner Mailbox) and press Enter. The Cleo Portal appears and displays the Download and Upload folders belonging to your Partner Mailbox.
    You use the Download folder to receive files sent to your Partner Mailbox and you use the Upload folder to put files you want to send to the Data Flow configured to work with this Partner Mailbox.

Related articles