Skip to content
Latest

Security

Use project tokens for automation and user accounts for interactive work. Project and organization settings control who can view or change data.

API tokens

Project API tokens are for CI, uploads, and CLI automation. They:

  • work within one project
  • are hashed for storage
  • can have an expiration date
  • have their usage tracked

You can only copy a token when it’s created. If you lose it, create a replacement.

User auth

Sign in with a user account for interactive work.

Passwords are hashed with bcrypt. OAuth secrets are encrypted before storage.

Connected agent apps

When hosted MCP is enabled, connect through your browser and choose organizations and permissions. The app acts as you within your current role. Reading, commenting, and recording review decisions each need their own permission.

Open Connected apps from account security to check permissions or disconnect an app. MCP needs a sign-in even for public projects, and uses its own OAuth credentials, separate from CLI login and project tokens.

Project visibility

Projects can be private or public.

Private projects require access. Public projects share read-only build content; changing data still requires authentication and permission.

Public-property rules can also share specific screenshots based on their metadata.

Permissions

Choose the right credential for the task:

  • Use a user account for review actions and settings.
  • Use a project token for automation within that project.

A project token cannot perform every action available to a signed-in user.

Transport and application security

The app validates tokens, rate-limits requests, and verifies webhook signatures. Cloud screenshots are also checked for supported formats, file size, dimensions, and whether the image can be decoded. See the screenshot requirements for those limits.

Security hygiene

  • store tokens in your CI secret manager
  • do not commit tokens to git
  • rotate unused or long-lived tokens
  • give public access only where you actually want it

Next steps