Device Integration: Acronis using rest API

TABLE OF CONTENTS

• Overview
• Prerequisites
  • Permissions and Access
• Required Information
• Obtain Acronis API Credentials
  • Creating API Client in Acronis Cyber Cloud
  • What You'll Get
• Configure Integration in ADR
  • Accessing the Configuration Interface
  • Field Mapping and Configuration
    • Basic Authentication Fields
    • Configuration Section
  • Complete Configuration Steps
• Validation and Testing
  • Verify Configuration
  • Test Connection
• Troubleshooting
  • Common Issues and Solutions
• Additional Resources
  • Documentation Links
  • Support Contacts
• Notes

Overview

This knowledge base article provides comprehensive guidance for customers who need to forward security logs from Acronis Cyber Protect Cloud using REST API endpoints. Acronis provides a library of public APIs that enable integration with Acronis Cyber Protect Cloud, with both APIv.1 and APIv.2 supported for comprehensive data access.

Security log forwarding enables organizations to:

• Centralize security monitoring and incident response
• Integrate Acronis security events with SIEM/SOAR platforms
• Automate threat detection and response workflows
• Maintain compliance with security audit requirements
• Enable real-time security analytics and reporting

The Acronis REST API provides programmatic access to security events, audit logs, and monitoring data through standardized HTTP endpoints with JSON-formatted responses.

Prerequisites

Before implementing security log forwarding from Acronis, ensure the following requirements are met:

• Permissions and Access

  • API Client with appropriate scopes for security log access
  • Read permissions for audit logs, security events, and monitoring data
  • Network firewall rules allowing outbound HTTPS connections to Acronis endpoints
  • Compliance approvals if required by organizational policies

Required Information

To complete this integration, you will need to obtain the following credentials from your Acronis environment:

• Client ID (API Client identifier)
• Client Secret (API Client secret key)
• Datacenter URL (Your Acronis datacenter endpoint)

Obtain Acronis API Credentials

Creating API Client in Acronis Cyber Cloud

1. Log into your Acronis Cyber Cloud management console
2. Navigate to the API client creation section
3. Follow the detailed instructions provided in the official Acronis documentation:
   • Reference Link: Creating API Client - Acronis Documentation

What You'll Get

After completing the API client creation process, you will receive:

• Client ID: A unique identifier for your API client
• Client Secret: A secure key for authentication
• Datacenter URL: Your specific Acronis datacenter endpoint URL

Configure Integration in ADR

Accessing the Configuration Interface

1. Log into your ADR platform
2. Navigate to Administration-->Addon Store
3. Search for Acronis Device
4. Choose "Acronis" from the device type dropdown

Field Mapping and Configuration

Basic Authentication Fields

• Access ID/User Name Field: Enter your Client ID from Acronis
• Password/Secret Key Field: Enter your Client Secret from Acronis

Configuration Section

In the Config section, you need to enter the datacenter URL in JSON format:

Format:

{"domain":"https://xxxxx.xxxxxx.com"}

Example Configuration:

{"domain":"https://us-west-1.api.acronis.com"}

Complete Configuration Steps

1. Device Type: Select "Acronis"
2. Name: Enter a descriptive name for this integration (e.g., "acronis")
3. CCE Host: Enter the appropriate CCE IP address or use 127.0.0.1 if local
4. Access ID/User Name: Paste your Acronis Client ID
5. Password/Secret Key: Paste your Acronis Client Secret
6. Config: Enter the JSON configuration with your datacenter URL:

   {"domain":"https://your-datacenter-url.com"}
   

Validation and Testing

Verify Configuration

1. Ensure all fields are populated correctly
2. Validate that the JSON format in the Config section is properly structured
3. Check that there are no trailing spaces or special characters

Test Connection

1. Save the configuration
2. Monitor the integration status in ADR
3. Check for successful authentication and data flow
4. Verify that Acronis logs are appearing in the SIEM under Logs and Flow Collection Status and Deep Tracker

Troubleshooting

Common Issues and Solutions

Authentication Failures:

• Verify Client ID and Client Secret are copied correctly
• Ensure API client has appropriate permissions in Acronis
• Check if API client is active and not expired

Connection Issues:

• Validate the datacenter URL format
• Ensure network connectivity between ADR and Acronis : SSH to CCE and do the telnet ,e.g.   telnet domain 443
• Check firewall rules and proxy settings

JSON Format Errors:

• Verify proper JSON syntax in Config field
• Ensure double quotes around keys and values
• Remove any trailing commas or extra characters

Additional Resources

Documentation Links

• Acronis API Documentation
• ADR Device Integration Guide (consult your ADR documentation)

Support Contacts

• Acronis Support: Contact through your Acronis support portal
• ADR Support: Contact your ADR support representative through support@ADR.net

Notes

• Keep API credentials secure and rotate them regularly
• Monitor integration status regularly to ensure continuous data flow
• Document any custom configurations for future reference

Last Updated: [26-08-2025]
Document Version: 1.0