Components
Infisical Platform — the control plane. Stores account credentials, manages permissions, and hosts the web interface. Gateway — a lightweight service you deploy in your private network. It proxies connections to your databases and servers, injects credentials, and records sessions. Client — a user’s browser (Web Access) or the CLI. Connects to the Gateway through an encrypted tunnel. An AI agent connects through the CLI, which holds the tunnel on its behalf. Actor — the user or machine identity the session belongs to. Permissions, policies, and the audit trail all follow the actor.How a Connection Works
When an actor connects to an account:- Access is requested — a user clicks Launch in the browser, or the CLI command runs
- Infisical checks permissions — verifies the actor has a membership with the right role
- Template rules are enforced — MFA, reason requirement, session duration
- Approval is checked — a gated account also needs an approved access request
- Connection is established — an encrypted tunnel is created between the client and Gateway
- Gateway fetches credentials — retrieves them from Infisical
- Gateway connects to the target — using the credentials
- Traffic flows through the Gateway — the actor interacts with the database/server
- Session is recorded — Gateway captures and uploads session activity, attributed to the actor
Network Security
The Gateway uses outbound connections only:- No inbound ports — your firewall doesn’t need to allow any inbound traffic
- Outbound to Infisical — for credential retrieval and session uploads
- Outbound to your infrastructure — to connect to databases and servers
Encryption
All connections are encrypted:- Client to Gateway — end-to-end encrypted tunnel
- Gateway to Infisical — TLS
- Session recordings — encrypted before upload
Recording Architecture
Recording happens at the Gateway:- Traffic flows through the Gateway
- Gateway captures session events
- Events are encrypted and cached locally
- Events upload to Infisical in real-time
- If connectivity drops, recording continues locally and syncs when restored
Deployment Options
For deployment instructions, see Deploy a Gateway.
Next Steps
Deploy a Gateway
Deploy a Gateway in your network.
Launch Your First Session
Connect to a database in under 10 minutes.