RediffMail Pro Connector

Overview

RediffMail Pro is a cloud-based business email service offering secure webmail, file sharing, video conferencing, and messaging capabilities. The RediffMail Pro connector enables the ingestion and processing of mail flow logs via the RediffMail Pro API. It primarily offers two types of data :

• outbound_mail_delivery_report: Contains delivery details of outbound emails.
• activity_report: Captures user activity and administrative actions

Prerequisites

• IP Whitelisting
  RediffMail Pro enforces strict IP validation. Only API calls from approved IP addresses or CIDR ranges will be accepted.
  • You must share your public IP or IP range in CIDR format with the Rediff support team for whitelisting.
• Email Authentication
  The following credentials are required for authentication:
  • domain: Name of the Rediff domain
  • user_email: Admin email ID associated with the domain
  • passwd: Password of the admin account

Configuration

Fields	Description
Connector Name	Enter a unique name for the connector
Domain	Enter the domain name
Admin User Email ID	Admin email address for authentication
Admin User Password	Base64-encoded password of the admin account

• Click Save to store the configuration.
• Use Test Connection to validate connectivity. A success message with a timestamp will confirm the setup.
• Ensure the connector appears under the Collection Status screen with status Active.

Sample Log Event

{
    "outbound_mail_delivery_report": [
        {
            "date_time": "2024-09-16 22:25:22",
            "from_address": "admin@eprotesting.com",
            "return_path": "admin@eprotesting.com",
            "recipient": "amolmtest@eprotesting.com",
            "service": "HTTP",
            "subject": " Impotant announcement",
            "sender_ip": "119.252.144.94",
            "rcpt_to_count": 1,
            "rcpt_cc_count": 1,
            "rcpt_bcc_count": 1,
            "attachment_names": null,
            "mail_size_bytes": 6722
        },
        {
            "date_time": "2024-09-16 22:25:22",
            "from_address": "admin@eprotesting.com",
            "return_path": "admin@eprotesting.com",
            "recipient": "amrishs@eprotesting.com",
            "service": "HTTP",
            "subject": " Impotant announcement",
            "sender_ip": "119.252.144.94",
            "rcpt_to_count": 1,
            "rcpt_cc_count": 1,
            "rcpt_bcc_count": 1,
            "attachment_names": null,
            "mail_size_bytes": 6722
        }
    ],
    "activity_report": [
        {
            "actionby": "admin@eprotesting.com",
            "actionon": "renoj@eprotesting.com",
            "usertype": "ADMIN",
            "actiontype": "FAR",
            "clientip": "119.252.144.94",
            "useragent": "Mozilla/5.0 "
        },
        {
            "actionby": "admin@eprotesting.com",
            "actionon": "admin@eprotesting.com",
            "usertype": "USER",
            "actiontype": "SWEEPDELETE_USER",
            "clientip": "119.252.144.94",
            "useragent": "Mozilla/5.0  Gecko/20100101 Firefox/130.0"
        }
    ]
}

Field Descriptions

Outbound Delivery Logs (outbound_mail_delivery_report)

Fields	Description
date_time	Date and time the email was sent
from_address	Sender’s email address
return_path	Bounce-back address for undelivered mail (usually same as sender)
recipient	Email recipient
service	Platform used to send mail (e.g., HTTP, SMTP)
subject	Subject of the email
sender_ip	IP address from which the email was sent
rcpt_to_count	Number of recipients in the “To” field
rcpt_cc_count	Number of recipients in the “Cc” field
rcpt_bcc_count	Number of recipients in the “Bcc” field
attachment_names	Names of attached files, if any
mail_size_bytes	Size of the email in bytes

Activity Report (activity_report)

Fields	Description
actionby	User who performed the action
actionon	User account affected by the action
usertype	Who performed the action (ADMIN / USER / SYSTEM)
actiontype	Type of action taken (e.g., FAR, SWEEPDELETE_USER, PASSWORD_CHANGED, etc.)
clientip	IP address from which the action was initiated
useragent	Browser or client application used

Note: The list of actiontype values is subject to expansion by Rediff in future API versions.