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
URLand, for extra domains of the same service, addURLs 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.
- Ask whoever created it to add the credential to a group you belong to — see Who sees what in Vault.
- Managers can check who reaches what in Sharing or on the Access screen.
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 clickingSalvar 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
Envcredential, asKEY=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.
- Create a new token and revoke the old one in Access tokens.
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.
- Ask a team administrator to adjust your Vault role in Manage members.
- See the role table in Who sees what in Vault.
"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) orAções(actions) to reduce the result and export in parts. See Audit log.