Security#

Agents Frame holds decisions about your deploys, money and files, so the defaults are conservative.

Keys#

  • Hashed at rest. An API key secret is shown once when you create it. We store only its SHA-256 hash, so we cannot show it again, and a database leak does not reveal usable keys.
  • Scoped. write, board, delegate and admin are strictly nested and the prefix of every key tells you which one it is. Give an agent the smallest scope it needs; most only need write.
  • Bound to a project. A write key sees and changes only its own project's cards.
  • IP allowlists. Set allowed_ips (CIDR) on a key and requests from other addresses get 401 unauthorized. The address checked is CF-Connecting-IP.
  • Expiry and revocation. Keys can expire; revoking one takes effect on the next request.
  • Every automatic decision is visible. Rules and delegate keys record who answered and why on the card.

Approvals#

Mark risky cards with require_unlock: true to require Face ID, Touch ID or the device passcode before the answer is sent. Add ttl with on_expire: "deny" so that an unanswered approval fails closed. Responding to a card that was already answered returns 409 conflict, so a late duplicate tap cannot change the result.

Webhooks#

Webhook deliveries are signed with HMAC-SHA256 over the timestamp and the raw body. Verify the signature and the timestamp before trusting an event; see Webhooks for code in TypeScript and Python. The secret is shown once when you set the webhook URL.

Notifications#

Push payloads contain the card title and an id, nothing else: the body, media and your answer are fetched by the app after you unlock the device. A notification service extension loads the poster image on the device. Notifications are sent through Apple Push Notification service.

Transport and storage#

All traffic uses HTTPS (TLS 1.2 or newer). Data is stored on Cloudflare (D1, Durable Objects and R2) in encrypted storage. Media URLs are signed and expire after 7 days; they are refreshed whenever the card is read. Web client sessions use bearer tokens stored in the browser; sign out to revoke them.

Your data#

  • Export: GET /me/export or Settings, Account, Export returns every card, event, metric, board and rule as JSON.
  • Delete: DELETE /me or Settings, Account, Delete account removes the account and all data, as required by the App Store.
  • Retention: cards and metric points are kept for your plan's history (30 days Free, 1 year Pro), media for the plan's period; older data is deleted.
  • No tracking: the apps and this site contain no advertising or cross-app tracking SDKs. See the privacy policy.

Reporting a vulnerability#

Email security@agentsframe.com with details and, if you can, steps to reproduce. We acknowledge reports within 3 business days, keep you updated, and credit researchers who want it. Please do not test against other people's accounts or run denial-of-service tests.