> ## Documentation Index
> Fetch the complete documentation index at: https://docs.already.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Security controls

> Current controls for API access, sessions, webhooks, and operator actions.

For a shareable summary of the connection model, controls, and partner setup, download the [Already partner integration and security overview (PDF, November 2026)](https://docs.already.finance/downloads/already-partner-security-overview.pdf).

Already's development integration uses different credentials for different trust boundaries:

| Connection | Authentication and controls |
| - | - |
| Partner server → Already API | Hashed, partner-scoped bearer key; explicit scopes; shared per-client rate limit |
| Partner website → widget | Publishable embed key and configured host origin for embed configuration; business session required for private actions |
| Person → portal | Verified Firebase ID token in deployed environments; workspace access resolved server-side |
| Already → partner webhook | HMAC-SHA256 signature over timestamp and raw body; timestamp and event ID for replay protection |
| Didit → Already | Signed provider webhook plus reconciliation of pending verification sessions |
| Already → Moov | Server-side provider credentials; transfers reconciled against saved amount and endpoints |

Admin access is separate from partner membership. The API verifies protected requests in deployed environments and does not accept development identity headers there. Sensitive operator actions are recorded with an actor, timestamp, subject, and reason or reference. Demo reset and development simulations are unavailable in production mode.

## Integrator responsibilities

Keep API keys and webhook signing secrets server-side. Verify webhook signatures before processing, deduplicate event IDs, and use an `Idempotency-Key` when submitting obligations. Limit who can read credentials and rotate them when access changes. Use HTTPS for hosted callbacks and send test events after configuration changes.

## Development status

The platform is still in pilot development. Do not treat these controls as a certification or as approval for live investor funds. Bank numbers are currently stored in the API database without application-level encryption; provider tokenization or encryption, production operations, and independent review remain launch work. See [data handling](https://docs.already.finance/trust/data.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.