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:
- Belina Connect → API Keys → New Key
- Set permissions (read, write, admin)
- Set expiration (recommended: 1 year)
- Copy key (shown only once!)
2. OAuth 2.0 (Recommended)
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 Type | Limit |
|---|---|
| Read | 1,000 requests/minute |
| Write | 100 requests/minute |
| Bulk | 10 requests/minute |
Exceeding limits returns 429 Too Many Requests.
IP Whitelisting
Restrict API access to specific IPs:
- Connect → Security → IP Whitelist
- Add allowed IPs/CIDR ranges
- 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:
- Immediately: Revoke all API keys
- Within 1 hour: Email security@belinasystems.com
- Within 24 hours: We'll respond with investigation results
- Ongoing: Cooperate with audit and remediation
Questions? Contact our security team: security@belinasystems.com
Was this page helpful?