Navigation Path​

  1. In the ​Main Navigation​, click ​User Management​ > ​Permissions​ > Credentials.
  2. Click ​Create​.
     ⇒  The record creation window opens.

The Create New Record window​

In the Create New Record window, you create records to encrypt transferred data or connections to the CMS of an external Mapp Engage system. You specify the information that is required for a connection with an external infrastructure. This information includes the server address, account name, and password.

You have various options for the encryption of transferred data (see ⇘ ​Credentials Options​).

The appearance of the   ​Create New Record​   window varies depending on the record type

  • Name: This input field defines the encryption. The system transmitts the value that is entered here instead of the user names, user passwords, user accounts, or CMS accounts to be encrypted. The encryption allows up to 50 alphanumeric characters. Capital letters are not allowed. The name of a record cannot be edited later. This input field is mandatory because the name of the record is always used to compile the relevant information for the transfer security placeholders. The record name must be unique regardless of the selected type.

  • Description: This input field is optional and is only provided for easier identification of the record.

  • Type: This input field defines the record type.
    The following types are available:

    • User Name: The ​User Name​ type encrypts the user names entered.

    • User Password: The ​User Password​ type encrypts the user passwords entered.

    • User Account: The ​User Account​ type encrypts all data that is related to the user account entered, meaning the user name and user password. This type is the most secure option for encrypting sensitive user data.

    • CMS Account: The ​CMS Account​ type grants access to the CMS of an external Mapp Engage system.

    • FTP Server: The ​FTP Server​ type grants access to a third-party FTP infrastructure.

    • Rest endpoint: The ​Rest endpoint​ type grants access to a third-party API endpoint.

    • Token Certificate Account: The ​Token Certificate Account​ type retrieves a temporary token for API communication.

  • Cancel: This button cancels the creation of the record. All changes are lost.

  • Save: This button saves the record that is created. Once saved, the defined record is immediately active and available for use.

User Name Type​

The ​User Name​ type encrypts the user names entered.

The following entries are required to define this record:

  • User Name: This input field defines the user to be encrypted. The value that is entered in the ​Name​ field replaces this user name.

User Password Type​

The ​User Password​ type encrypts the user passwords entered.

The following entries are required for the definition of a record with the ​User Password​ type:

  • Password: This input field defines the password to be encrypted.

  • Confirm Password: This input field validates the password. Both passwords must be identical. The value that is entered in the ​Name​ field replaces the password.

User Account Type​

The ​User Account​ type encrypts the complete user account, including user name and user password. This type is the most secure option for encrypting sensitive user data.

The following entries are required for the definition of a record with the ​User Account​ type:

  • User Name: This input field defines the user to be encrypted.

  • Password: This input field defines the password to be encrypted for the entered user.

  • Confirm Password: This input field validates the password. Both passwords must be identical. The value that is entered in the ​Name​ field replaces the password and user name.

CMS Account Type​

The ​CMS Account​ type grants access to the CMS of an external Mapp Engage system.

For more information, see Import CMS Messages​.

Only one active record with the   ​CMS Account​   type can be saved. If a record with the type   ​CMS Account​   exists, either edit or archive and delete the existing record


The following entries are required for the definition of a record with the ​CMS Account​ type:

  • URL: This input field defines the URL of the external Mapp Engage system.
    The URL must conform to the following structure: ​https://secure.ecircle-ag.com/systemname​ .

  • User Name: This input field defines the user name of the account that is created to interface with the external Mapp Engage system.

  • Password: This input field defines the password of the user who is entered in the ​User Name​ input field.

  • Confirm Password: This input field detects the value that is entered in the ​Password​ field and validates the password.

FTP Server Type​

The ​FTP Server​ type grants access to a third-party ftp server.

In accordance with the latest security standards, Mapp supports Secure File Transfer Protocol (SFTP). Secure File Transfer Protocol is a secure way to transfer files with the SSH protocol.


The following entries are required for the definition of a record with the ​FTP Server​ type.

  • File Location: This input field defines the path for the FTP server. The file location format is sftp://servername/path.

  • Account name: This input field defines the name of the account that is created to interface with the FTP server.

  • Password: This input field defines the password of the account that is entered in the ​Account Name​ input field.

  • Confirm Password: This input field detects the value that is entered in the ​Password​ field and validates the password.

Rest Endpoint Type​

The ​Rest Endpoint​ type grants access via API to a specific URL.

The following entries are required for the definition of a record with the ​API Endpoint​ type.

  • Path (exact URL of the endpoint:) This input field defines the path to the API endpoint.
    This path uses the format server_name/folder/folder, for example, servername/contacts/imports.

  • Account name: This input field defines the name of the account that is created to interface with the FTP server.

  • Password: This input field defines the password of the account that is entered in the ​Account Name​ input field.

  • Confirm Password: This input field detects the value that is entered in the ​Password​ field and validates the password.

Token Certificate Account Type​

The ​Token Certificate Account​ type obtains a temporary token for API communication.

The following entries are required for the definition of a record with the ​Token Certificate Account​ type.

Request the complete information for the token certificate account from your service provider.

  • Path (URL of API for obtaining token): This input field defines the path to the API endpoint to obtain the token.
    This path uses the format server_name/folder/folder, for example, servername/contacts/imports.

  • User Key (user identifier): Enter the user key (ID) for the user to access the API This input field defines the name of the account that is created to interface with the FTP server.

  • API Key: This input field defines the API key.

  • XPath to token in response body: This input field defines the path to the token, for example //[local-name()='AuthToken']//text().

  • Request Body: Enter contents of the request.

If all entries are correct, the Response Body will be displayed after clicking ​Test Connection.​

Amazon S3 Account​

Find details here.

Google Storage Account​

Find details here.