ExchangeDefender Compliance Archiving Data Access


ExchangeDefender Compliance Archive provides secure, long-term storage, recovery and eDiscovery system that assures compliance with regulatory requirements established by IRS, HIPAA, SOX and SEC.

Web Access


ExchangeDefender clients can access compliance archive data securely at: 


Our friendly user interface enables users to quickly locate the message and print/download it.

Command Line Access


ExchangeDefender Compliance Archive data can be accessed via command line interface tool cacli. ExchangeDefender provides cacli tool for Windows, Linux, and MacOS X and can be downloaded at: 


Command line interface supports list (listing of messages in a mailbox) and view (showing contents of the selected message).


Username and password are always domain credentials (same authentication used for Domain Admin login at https://admin.exchangedefender.com) and password can be provided in plain text (bad) or MD5 hash (better).

Usage: cacli view

View messages from compliance

Flags:
  -h, --help Show context-sensitive help.
      --debug
      --include-body Include message body in result
  -u, --username=example.com Domain name
  -p, --password=******* Domain password <
  -i, --message-id=1
  -m, --mailbox-email=user@example.com

Usage: cacli list

List messages from compliance

Flags:

  -h, --help Show context-sensitive help.
      --debug
  -L, --limit=10 limit results
  -S, --skip=10 skip results
  -u, --username=example.com Domain name
  -p, --password=******* Domain password
  -m, --mailbox-email=user@example.com


For example, to view the first message in the ExchangeDefender Compliance Archive for demo@demo.exchangedefender.com:

>> cacli view -i 1 -m demo@demo.exchangedefender.com -u demo.exchangedefender.com -p b9492ebbaf0201b121eefc

Output:

+-----+----------------------------------+--------------------------------------------------------+-----------------------------------+--------------------------------+------------------------------+
| ID |                FROM                |                               TO                                 |             SUBJECT               |       ATTACHMENTS      |           RECEIVED         |
+-----+----------------------------------+--------------------------------------------------------+-----------------------------------+--------------------------------+------------------------------+
|  1  |  social@facebook.com  | demo@demo.exchangedefender.com|           Elmhurn Blvd         | No                                 | 2013-01-31 09:05:00|
+-----+----------------------------------+--------------------------------------------------------+-----------------------------------+--------------------------------+------------------------------+

API Access


ExchangeDefender enables clients read-only access to their archive data via programmable interface (API) for integration with third party solutions.


Required Parameters:


Name Value Type Location Description
X-Action list
view
view-attachment
download
Header The desired action to perform
X-Target-User email Header The email address of the compliance mailbox to open
X-Auth-User Domain name Header The domain name username for the domain administrator login
X-Auth-User String Header The password for the X-Auth-User account


All actions except download will return XML for a successful request. A download request will return a downloadable eml file.

Download Message:

Returns packaged eml file with the name format of $username_$id.eml

Example:

Here is a curl example

curl
-O
-H "X-Action: download"
-H "X-Target-User-Message-Id: 1234"
-H "X-Target-User: user@customer.com"
-H "X-Auth-User: customer.com"
-H "X-Auth-Password: ******"
https://compliancearchive.exchangedefender.com/download/


List Messages:

Returns XML of the ids and received timestamp for all messages in the mailbox

Example:

Here is a curl example

curl
-H "X-Action: list"
-H "X-Target-User: user@customer.com"
-H "X-Auth-User: customer.com"
-H "X-Auth-Password: ******"
https://compliancearchive.exchangedefender.com/download/


Result example :

<?xml version="1.0"?>
<
response>
<
row>
<
id>1234</id>
<
received>2018-07-18 12:02:40</received>
</
row>
<
row>
<
id>1235</id>
<
received>2018-07-18 12:03:00</received>
</
row>
</
response>


View Message:

Returns XML. Messages with HTML content will have tags XML sanitized

Example:

Here is a curl example

curl
-H "X-Action: view"
-H "X-Target-User-Message-Id: 1234"
-H "X-Target-User: user@customer.com"
-H "X-Auth-User: customer.com"
-H "X-Auth-Password: ******"
https://compliancearchive.exchangedefender.com/download/


Result example :


<?xml version="1.0"?>
<
response>
<
row>
<
id>1234</id>
<
from>sender@external.com</from>
<
to>user@customer.com</to>
<
subject>Sample Message</subject>
<
body>        Message raw here</body>
<
bodytype>Text</bodytype>
<
attachments>1</attachments>
<
received>2018-07-18 12:02:40</received>
</
row>
</
response>


View Message Attachments:

Returns XML. Messages with HTML content will have tags XML sanitized

Example:

Here is a curl example

curl
-H "X-Action: view-attachment"
-H "X-Target-User-Message-Id: 1234"
-H "X-Target-User: user@customer.com"
-H "X-Auth-User: customer.com"
-H "X-Auth-Password: ******"
https://compliancearchive.exchangedefender.com/download/


Result example :


<?xml version="1.0"?>
<
response>
<
row>
<
id>1234</id>
<
name>test.pdf</name>
<
binary>---BINARY DATA---</binary>
<
source>1234</source>
</
row>
<
row>
<
id>422</id>
<
name>test2.pdf</name>
<
binary>---BINARY DATA---</binary>
<
source>1234</source>
</
row>
</
response>


Need assistance?

ExchangeDefender is easy to reach, and we are here to help with your IT: