ACAP Module

Application Configuration Access Protocol
Configuring the ACAP module

The CommuniGate ACAP module implements an ACAP server for TCP/IP networks.

The ACAP protocol allows a client (mailer) application to connect to the Server computer and upload and download the application preferences, configuration settings and other datasets (such as personal address books).

Application Configuration Access Protocol

The Application Configuration Access Protocol allows mailers and other application store any type of structured data on an ACAP server. That data can be the application configuration data, so when the application is started on any workstation, it can connect to the ACAP server and configure itself using the configuration stored in the ACAP 'dataset' belonging to the current user.

ACAP 'datasets' can also be used to store address books, and there are several mailer applications like Mulberry® that can work with the address books stored on an ACAP server. The CommuniGate Pro WebUser Interface module uses the same datasets to store its address books. This feature allows CommuniGate Pro users to use the same personal address books via the WebUser Interface and via an ACAP-enabled mailer.

Configuring the ACAP module

Use the WebAdmin Interface to configure the ACAP module. Open the Access page in the Settings realm:

Log

Use this setting to specify what kind of information the ACAP module should put in the Server Log. Usually you should use the Major (password modification reports) or Problems (non-fatal errors) levels. But when you experience problems with the ACAP module, you may want to set the Log Level setting to Low-Level or All Info: in this case protocol-level or link-level details will be recorded in the System Log as well.

The ACAP module records in the System Log are marked with the ACAP tag.

channels

When you specify a non-zero value for the TCP/IP Channels setting, the ACAP module creates a so-called "listener" on the specified port. The module starts to accept all ACAP connections from mail clients and other applications. This setting is used to limit the number of simultaneous connections the ACAP module can accept. If there are too many incoming connections open, the module will reject new connections, and the user should retry later.

listener

By default, the ACAP module Listener accepts clear text connections on the TCP port 674. Follow the listener link to tune the ACAP Listener.

The ACAP module supports the STARTTLS command that allows client mailers to establish a connection in the clear text mode and then turn it into a secure connection.