REFERENCETroubleshooting

Troubleshoot Vault

The most common problems in Vault and how to fix each one.

"Link expirado ou já utilizado" (link expired or already used)

Cause: share links are single-use — the first access invalidates the link. URL previews in chat apps may have consumed the link before the recipient, and reloading the page counts as a new access.

  • Generate a new link on the credential: menu → Compartilhar (share) → Gerar link (generate link). See Share a credential.
  • Send the new link through a channel that doesn't generate URL previews and tell the person to copy the values on the first visit.
  • If you suspect someone else opened the link, check the Acesso por link (link access) event in the audit log and rotate the secret.

The extension doesn't fill a saved login

Cause: the credential isn't a Login or its URL doesn't match the open site. The extension only fills Login credentials whose URL matches the tab.

  • Confirm the credential's type is Login.
  • Check the credential's URL and, for extra domains of the same service, add URLs alternativas (alternative URLs) in the credential panel.
  • See Troubleshoot the extension for the remaining cases.

I can't find a credential

Cause: the credential is someone else's private credential, or it is in a group you're not part of. You only see what is yours or what is in your groups.

The Todas, Privadas, and Compartilhadas filters disappeared

Cause: the scope filters only appear in organization teams that have at least one shared credential. In a personal team, or while nothing has been shared, the list shows only your private credentials.

  • Share a credential with a group — the filters come back.
  • In a personal team there are no groups and no filters; this is the expected behavior.

"Insira uma URL válida" (enter a valid URL) when saving a Login

Cause: the URL field requires the full address, with the protocol. "exemplo.com" doesn't pass validation.

  • Include the protocol: https://exemplo.com.

I edited through the .env view and fields disappeared

Cause: bulk editing through the .env view replaces the entire set of fields — any key missing from the saved text is removed. The Confirmar alterações (confirm changes) dialog shows those removals as - lines before saving.

  • Recreate the removed fields with Adicionar campo (add field), using the values from the source system.
  • On the next bulk edit, review the - lines in the diff before clicking Salvar alterações (save changes). See Reveal, copy, and edit fields.

I deactivated a credential by accident

Cause: Desativar (deactivate) removes the credential from the list, and there is no trash bin or reactivation in the interface.

  • Create the credential again with the values from the source system.
  • If the value is lost, generate a new secret in the source system and register it — in practice, a rotation.

The CLI doesn't inject my variables

Cause: the secret isn't in an Env credential, or the CLI isn't connected to the vault. The CLI injects environment variables from Env credentials.

  • Store the variables in an Env credential, as KEY=value, one per line.
  • Confirm you can open the credential in Credentials — the CLI reaches the same as your account.
  • Confirm the CLI connection in Access tokens.

I lost the token before copying it — the CLI or the extension won't connect

Cause: an access token's value is displayed a single time, at creation. If you close the dialog without copying, you can't see it again.

I don't see Access, Audit log, Rotation, Sharing, or Offboarding

Cause: those screens are exclusive to Vault managers. For the other roles, they don't appear in the navigation.

"Restrinja a busca antes de exportar" (narrow the search before exporting) when exporting CSV

Cause: the audit log export has a row cap, and the current filters return too many events.

  • Apply Por usuário (by user) or Ações (actions) to reduce the result and export in parts. See Audit log.

Next