# Credentials Vault

{/* AUTO-SYNCED SOURCE: this page lives in apps/app/src/modules/credentials/docs/ and is mirrored into the docs app by `bun sync:module-docs`. Edit it in the module, not in apps/docs. */}
<Lead>
The **credentials vault (Zugangsdaten-Tresor)** is the encrypted home for every login your office relies on: portal accounts, API keys, PIN codes and secure notes. Instead of spreadsheets and sticky notes you get one central list with clear sharing rules, three confidentiality levels and a log of every access.
</Lead>

## What the vault is

The credentials vault is a **standard tool** of the platform: it comes pre-installed on every plan and costs **no credits** (details: [Cost and availability](/tools/zugangsdaten-tresor/kosten)). You find it in your workspace at `/tools/credentials`. It has its own sidebar with every area: entries, folders, vault check, groups, personal entries, shared links, access log and trash.

Every secret is encrypted before it is stored. Search only covers title, URL, username and tags, never the secret itself. Uninstalling the tool never deletes your data.

## What the vault can do

<FeatureGrid>
  <Feature icon="lock" title="Encrypted entries">
    Passwords, API keys, PIN codes and secure notes in one list. Each secret is encrypted before saving, and a built-in generator creates a strong password on demand.
  </Feature>
  <Feature icon="shield" title="Three confidentiality levels">
    From standard to sensitive (revealing requires a reason) to hyper-sensitive: zero-knowledge encryption in your browser with a personal master password.
  </Feature>
  <Feature icon="users" title="Team sharing">
    Grant access per member, per role or per group. Shares always grant read access, and the creator of an entry always stays in control of it.
  </Feature>
  <Feature icon="link" title="External links">
    Time-limited share links for outside partners (1 hour up to 7 days), revocable at any time, with every access counted and logged.
  </Feature>
  <Feature icon="key" title="Staff logins">
    Templates for services where each team member deposits their own login, with a progress indicator and optional escrow for the workspace owner.
  </Feature>
  <Feature icon="book" title="Access log">
    Who opened, copied or shared which entry, and the reason they gave. Visible on the entry itself and as a page of its own. Secrets never appear there.
  </Feature>
  <Feature icon="shield" title="Vault check">
    Finds weak and reused passwords, expired credentials, entries created by people who have left, and entries only one person can reach.
  </Feature>
  <Feature icon="key" title="Second factor of your portals">
    Store a service's second factor and the vault shows the confirmation code right next to the password. No more reaching for the phone.
  </Feature>
  <Feature icon="lock" title="Credentials on the property">
    Key-safe codes, WiFi and alarm systems can be attached to a property. They then also appear on the property page, where your colleague looks before a viewing anyway.
  </Feature>
</FeatureGrid>

## The three confidentiality levels

The vault's core concept: you decide per entry how strictly it is protected.

<DefinitionList>
  <DefItem term="Standard">
    Encrypted on the server. Revealing the secret needs no extra step but is always logged. The right level for everyday team logins.
  </DefItem>
  <DefItem term="Sensitive (Sensibel)">
    Like standard, but revealing requires you to state a reason (mandatory field). The reason goes into the audit log. A good fit for logins where your team wants to know why someone opened them.
  </DefItem>
  <DefItem term="Hyper-sensitive (Zero-knowledge)">
    Encryption happens directly in your browser, protected by a personal master password. The server never sees the plaintext or the key. These entries cannot be shared externally.
  </DefItem>
</DefinitionList>

<Warning title="Zero-knowledge means: no recovery">
For hyper-sensitive entries there is no recovery without your master password, not even by the platform operator. If you lose the master password, those entries are permanently unreadable. Standard and sensitive entries are not affected.
</Warning>

## Getting started

<Steps>
  <Step title="Open the vault">
    Open the **credentials vault** in your workspace at `/tools/credentials`. While the list is empty you will see the hint **Noch keine Einträge. Lege deinen ersten Zugang an.** (no entries yet, create your first login).
  </Step>
  <Step title="Create your first entry">
    Click **Neuer Eintrag** (new entry). Give it a title (for example "ImmoScout24 office account"), pick the type and enter the secret. For the password type you must also fill in an email or a username.
  </Step>
  <Step title="Choose visibility and confidentiality">
    Decide whether the entry is **Geteilt (Team)** (shared with the team) or **Persönlich** (personal), and pick a confidentiality level. Rule of thumb: standard for team logins, personal only for accounts that are truly yours alone.
  </Step>
  <Step title="Save and share if needed">
    After saving, the entry appears in the list. Use **Teilen** (share) to grant read access to specific members, roles or groups.
  </Step>
</Steps>

<Tip title="Bring your existing passwords">
You do not have to start from scratch: the **Import** dialog reads CSV files from browsers, 1Password, Bitwarden or Excel. The file is only read inside your browser. Details: [Managing entries](/tools/zugangsdaten-tresor/eintraege#import-from-csv).
</Tip>

## All topics in detail

<CardGrid>
  <Card title="Managing entries" href="/tools/zugangsdaten-tresor/eintraege">
    List and search, creating and editing entries, all field types, revealing with logging, deleting and CSV import.
  </Card>
  <Card title="Security" href="/tools/zugangsdaten-tresor/sicherheit">
    The three confidentiality levels in detail, the master password for zero-knowledge, vault 2FA and the team policies.
  </Card>
  <Card title="Sharing" href="/tools/zugangsdaten-tresor/teilen">
    Team shares (members, roles, groups), personal vs. shared entries and external share links with expiry and revocation.
  </Card>
  <Card title="Staff logins" href="/tools/zugangsdaten-tresor/mitarbeiter-zugaenge">
    Templates for services where everyone deposits their own login, including escrow and the progress indicator.
  </Card>
  <Card title="Audit and permissions" href="/tools/zugangsdaten-tresor/audit-und-berechtigungen">
    What gets logged, which webhook events exist and what each role may do in the vault.
  </Card>
  <Card title="Vault check and access log" href="/tools/zugangsdaten-tresor/check-und-protokoll">
    What the check finds, how to read the access log, how the trash works and what to do when someone leaves.
  </Card>
  <Card title="Emergency access" href="/tools/zugangsdaten-tresor/notfallzugriff">
    Name a person you trust who can take over your personal credentials in an emergency, with a waiting period and the right to object.
  </Card>
  <Card title="Cost and availability" href="/tools/zugangsdaten-tresor/kosten">
    Why the vault costs no credits, what every plan includes and how storage is counted.
  </Card>
  <Card title="Questions and answers" href="/tools/zugangsdaten-tresor/faq">
    Visibility, how entries are protected, automatic locking, moving over via CSV and offboarding.
  </Card>
  <Card title="Troubleshooting" href="/tools/zugangsdaten-tresor/troubleshooting">
    Answers to the most common issues: forgotten master password, 2FA codes, invisible entries, import duplicates.
  </Card>
</CardGrid>

## Frequently asked questions

Who sees what, how entries are protected, what happens when someone leaves the office and how to move over from another password manager: [Questions and answers](/tools/zugangsdaten-tresor/faq).
