Platform security
This page describes the controls Keyban runs on the platform behind Wallet for Agents, for the security reviewer of a customer or a vendor questionnaire. It describes the controls, not their configuration. How the agent wallets and the treasury are protected is in Agent wallet security and Treasury security.
Hosting
- Keyban runs on Amazon Web Services in the Paris region, and its monitoring in a European region of Google Cloud. Hosting in the European Union is a commitment of the terms of service.
- Development, testing and production each run in their own AWS account.
At the edge
- All traffic to the platform goes through a web application firewall that applies the OWASP Core Rule Set, limits the rate of requests per IP address and blocks some regions.
- The platform is served over HTTPS only: a plain HTTP request is redirected.
Access to the API
- The API limits the rate of requests.
- Every request carries one of three credentials, each with its own scope: a person's session in the dashboard, an OAuth sign-in with PKCE for the Keyban CLI, or an API key bound to an organization or to one agent wallet.
- A person's rights follow their role in the organization, and an agent wallet's API key can only ask for payments for its own wallet. See Permissions and roles and Agent wallet security.
The signing services
- The services that hold Keyban's key shares run apart from the rest of the platform. They are not reachable from the internet, and network policies let only the services that need them call them.
- Their key shares are kept in a dedicated store, encrypted in transit, and at rest with a key held in a hardware security module (HSM), through AWS KMS: the encryption key never leaves the HSM.
- They run from minimal container images, with no shell or package manager.
Data
- Databases and disks are encrypted at rest with keys held in hardware security modules, through AWS KMS. Storage buckets are encrypted at rest, private and versioned.
- Databases are backed up continuously, with point-in-time recovery.
- Container images are scanned for known vulnerabilities when they are published.
Secrets
- Secrets live in a secrets manager hosted in the European Union, never in the code. The ones a deployment needs are sealed before they reach the deployment repository.
- A secret scanner checks every commit before it is made.
Vulnerability scanning
- The code is scanned for vulnerabilities every week, with static analysis.
- The services exposed on the internet are scanned every week for known vulnerabilities and misconfigurations.
- The infrastructure code is checked every week against security best practices.
Smart contracts
Every deployment or upgrade of a contract in production goes through automated gates first. The deployed code must match the reviewed source, the storage layout must stay compatible with the version it replaces, and the result is verified on the blockchain before the new version of the platform takes traffic. A downgrade is refused, and production is deployed only from the reviewed main branch.
Monitoring
- API requests are recorded in an audit log: who made them, with which credential, for which organization.
- Alerts reach the team on errors and on availability.
- Monitors on the blockchain side watch Keyban's own operating balances and unusual spending patterns.
Operations
- A new version of the platform is deployed next to the running one, and takes traffic only once automated tests pass on it.
- Incidents follow written runbooks, classified by severity.
Compliance
- Keyban is working toward SOC 2 and ISO 27001, with Vanta.
- A data processing agreement, under article 28 of the GDPR, is an annex of the terms of service, together with the list of sub-processors.
Report a vulnerability
Write to security@keyban.io.
Related
- Security model: what the design defends against, and what it does not cover.
- Agent wallet security: the keys, the credentials and the layers a payment goes through.
- Treasury security: the treasury signers and their recovery.
- Permissions and roles: who can do what.