Skip to main content

Connecting Magalu Object Storage

This guide walks you through connecting a Magalu Object Storage destination to Pluton.

Prerequisites​

Before connecting Magalu Object Storage, you need:

  1. A Magalu Cloud account - Sign up here
  2. S3 API credentials (Access Key ID and Secret Access Key)

Getting Your Magalu Credentials​

Step 1: Generate API Keys​

  1. Log into the Magalu Cloud Console
  2. Navigate to Object Storage in the dashboard
  3. Go to the Credentials or API Keys section
  4. Click Create Key to generate new S3-compatible credentials
  5. Copy the Access Key ID and Secret Access Key
  6. Important: Save both credentials immediately - the Secret Access Key may only be shown once

Step 2: Create a Bucket​

  1. In the Object Storage section, click Create Bucket
  2. Enter a unique bucket name
  3. Select your preferred region (e.g., Sao Paulo or Fortaleza)
  4. Configure access settings and create the bucket

Connecting to Pluton​

Pluton Magalu

Step 1: Add Storage​

  1. In Pluton, navigate to Storages
  2. Click Add Storage button
  3. Select Magalu from the provider list

Step 2: Configure Connection​

Fill in the required fields:

  • Storage Name: A friendly name (e.g., "Magalu Backups")
  • Access Key ID: Paste your Magalu S3 Access Key ID
  • Secret Access Key: Paste your Magalu S3 Secret Access Key
  • Region: Select the region matching your bucket:
    • Sao Paulo, SP (BR) - br-se1
    • Fortaleza, CE (BR) - br-ne1
    • Or enter a custom endpoint

Step 3: Advanced Options (Optional)​

Additional settings available:

  • Server-side Encryption: Choose AES256 or KMS encryption for data at rest
  • Storage Class: Select the storage class for new objects
  • Bucket ACL: Set access control for bucket operations
  • Upload Cutoff: Threshold for switching to chunked uploads (default: 200 MiB)
  • Chunk Size: Size of chunks for multipart uploads (default: 5 MiB)
  • Force Path Style: Enabled by default; use path-style access for S3 requests

Step 4: Test and Save​

  1. Click Test Connection to verify credentials
  2. If successful, click Save
  3. Your Magalu Object Storage is now ready for backup plans

Common Issues​

Authentication Failure: Verify your Access Key ID and Secret Access Key are correct. Ensure the credentials have not been revoked.

Region Mismatch: Make sure the selected region matches where your bucket was created. Sao Paulo uses br-se1 and Fortaleza uses br-ne1.

Bucket Not Found: Confirm the bucket name is correct and exists in your Magalu account.

Best Practices​

  • Create dedicated API keys for Pluton with minimum required permissions
  • Select the region closest to your Pluton server for best performance
  • Enable server-side encryption for sensitive backup data
  • Monitor storage usage through the Magalu Cloud console regularly