Skip to main content

Security & Authentication

Belina Connect provides enterprise-grade security for all API interactions.

Authentication Methods​

1. API Keys (Simple)​

Best for: Server-to-server integrations

curl https://api.belinasystems.com/v1/employees \
-H "Authorization: Bearer YOUR_API_KEY"

Setup:

  1. Belina Connect → API Keys → New Key
  2. Set permissions (read, write, admin)
  3. Set expiration (recommended: 1 year)
  4. Copy key (shown only once!)

Best for: User-facing applications

# 1. Get authorization code
GET https://auth.belinasystems.com/oauth/authorize?
client_id=YOUR_CLIENT_ID&
redirect_uri=YOUR_CALLBACK&
scope=read:employees

# 2. Exchange for token
POST https://auth.belinasystems.com/oauth/token

3. JWT Tokens​

Best for: Microservices

const token = jwt.sign(
{ userId: 123, scope: 'read:payrolls' },
process.env.BELINA_SECRET,
{ expiresIn: '1h' }
);

Security Features​

Encryption​

  • At Rest: AES-256 encryption for all data
  • In Transit: TLS 1.3 only (older protocols disabled)
  • Backups: Encrypted with separate keys

Rate Limiting​

Endpoint TypeLimit
Read1,000 requests/minute
Write100 requests/minute
Bulk10 requests/minute

Exceeding limits returns 429 Too Many Requests.

IP Whitelisting​

Restrict API access to specific IPs:

  1. Connect → Security → IP Whitelist
  2. Add allowed IPs/CIDR ranges
  3. Test with whitelist active

Audit Logs​

All API calls are logged:

  • Timestamp
  • API key used
  • Endpoint called
  • Request body (sensitive data masked)
  • Response status
  • Originating IP

Retention: 90 days for standard, 7 years for compliance-mode

Compliance​

Standards​

  • ISO 27001 — Information Security Management
  • SOC 2 Type II — Service Organization Controls
  • GDPR — EU data protection (where applicable)
  • POPIA — South African data protection

Data Residency​

  • Primary: AWS Africa (Cape Town) - af-south-1
  • Backup: AWS Europe (Ireland) - eu-west-1
  • No data leaves Africa unless customer opts-in

Best Practices​

Storing API Keys​

❌ Don't:

const apiKey = "blk_live_abc123"; // Never hardcode!

✅ Do:

const apiKey = process.env.BELINA_API_KEY;

Rotating Keys​

Rotate API keys every:

  • 90 days — Production keys
  • 30 days — Admin keys
  • Immediately — If compromised

Monitoring​

Set up alerts for:

  • Unusual traffic patterns
  • Failed authentication attempts
  • Access from new IPs
  • High-volume data exports

Incident Response​

If you suspect a security breach:

  1. Immediately: Revoke all API keys
  2. Within 1 hour: Email security@belinasystems.com
  3. Within 24 hours: We'll respond with investigation results
  4. Ongoing: Cooperate with audit and remediation

Questions? Contact our security team: security@belinasystems.com

Was this page helpful?