Vaultwarden సురక్షితమేనా? భద్రతను పెంచే మార్గాలు
Vaultwarden క్లయింట్ సైడ్ ఎన్క్రిప్షన్ వాడినా, అడ్మిన్ టోకెన్ మరియు బ్యాకప్ ఫైల్స్ ద్వారా ముప్పు ఉంటుంది. మీ సర్వర్ డేటాను సురక్షితంగా ఉంచేందుకు అవసరమైన జాగ్రత్తలు ఇక్కడ ఉన్నాయి.
Vaultwarden సురక్షితమేనా? క్లుప్త సమాధానం
Vaultwarden అత్యంత కీలకమైన చోట సురక్షితంగా ఉంటుంది, ఎందుకంటే ప్రతి vault అంశం సర్వర్కు చేరకముందే మీ పరికరంలోనే ఎన్క్రిప్ట్ చేయబడుతుంది. సర్వర్ ఎన్క్రిప్ట్ చేయబడిన vault కంటెంట్ను, ప్లెయిన్టెక్స్ట్ అకౌంట్ మెటాడేటాతో పాటు నిల్వ చేస్తుంది. ఒకవేళ ఎవరైనా మొత్తం డేటాబేస్ను కాపీ చేసినా, కంటెంట్ను చదవడానికి వారికి vault యొక్క ఎన్క్రిప్షన్ కీలు అవసరమవుతాయి, కానీ వారికి అకౌంట్ ఈమెయిల్ అడ్రస్లు మరియు పాస్వర్డ్ హింట్లు వెంటనే లభిస్తాయి.
ఈ సమాధానం చాలా విషయాలను కవర్ చేస్తుంది, కానీ మీరు కాన్ఫిగర్ చేసే భాగాల్లోనే లోపాలు తలెత్తుతాయి. ఊహించదగిన టోకెన్ వెనుక ఉన్న అడ్మిన్ ప్యానెల్, ఇంటర్నెట్ మొత్తానికి పబ్లిష్ చేయబడిన కంటైనర్ పోర్ట్, ప్లెయిన్టెక్స్ట్ config.json, అదే బాక్స్లోని హోమ్ డైరెక్టరీలో ఉన్న బ్యాకప్ tarball వంటివి ప్రమాదకరం. ఇవేవీ క్రిప్టోగ్రఫీ సమస్యలు కావు. ఇవన్నీ self-hosted vaultలు ఖాళీ అవ్వడానికి గల కారణాలు.
కింద ఉన్నవన్నీ పని చేస్తున్న ఇన్స్టాలేషన్ ఉందని భావిస్తాయి. మీకు ఇంకా ఇన్స్టాలేషన్ లేకపోతే, ముందుగా VPS కోసం Vaultwarden ఇన్స్టాలేషన్ గైడ్ ఉపయోగించి సెటప్ చేయండి, ఆపై తిరిగి వచ్చి ఈ జాబితాను వరుసగా పూర్తి చేయండి.
సర్వర్ వాస్తవానికి ఏమి నిల్వ చేస్తుంది
Vaultwarden అనేది Bitwarden యొక్క డేటా మోడల్ను అమలు చేస్తుంది. ఒక vault ఐటమ్ పేరు, వినియోగదారు పేరు, పాస్వర్డ్, నోట్స్ మరియు URIs క్లయింట్ వైపున, ఏదైనా అభ్యర్థన పంపే ముందే, యాదృచ్ఛికంగా రూపొందించబడిన ఐటమ్ కీతో ఎన్క్రిప్ట్ చేయబడతాయి. ఆ కీని వినియోగదారు లేదా సంస్థ యొక్క సిమెట్రిక్ కీ రక్షిస్తుంది; పాస్వర్డ్ ద్వారా పొందిన కీ, వినియోగదారు యొక్క సిమెట్రిక్ కీని రక్షిస్తుంది. అటాచ్మెంట్ ఫైల్ కంటెంట్స్, ఐటమ్ కీ ద్వారా రక్షించబడే ప్రత్యేకమైన అటాచ్మెంట్ కీని ఉపయోగిస్తాయి. సర్వర్ ఒక UUID (universally unique identifier) జత చేయబడిన అస్పష్టమైన (opaque) డేటాను మాత్రమే స్వీకరిస్తుంది.
కొన్ని అంశాలు సైఫర్టెక్స్ట్ (ciphertext) రూపంలో ఉండవు, అవి ఏమిటో మీరు ఖచ్చితంగా తెలుసుకోవాలి:
- మీ ఖాతా ఈమెయిల్ చిరునామా మరియు మాస్టర్ పాస్వర్డ్ హింట్, ఇవి ప్లెయిన్టెక్స్ట్లో ఉంటాయి.
- మీ KDF (key derivation function) సెట్టింగ్లు మరియు సాల్ట్, ఎందుకంటే తదుపరి లాగిన్ సమయంలో కీని తిరిగి నిర్మించడానికి క్లయింట్కు ఇవి అవసరం.
- క్లయింట్ పంపే మాస్టర్ పాస్వర్డ్ హ్యాష్ యొక్క సర్వర్-సైడ్ హ్యాష్, ఇది లాగిన్ ప్రామాణీకరణ కోసం ఉపయోగించబడుతుంది.
- మెటాడేటా: సంస్థ సభ్యత్వం, పరికరాల పేర్లు, చివరి లాగిన్ సమయాలు.
- అథెంటికేటర్ ఆధారిత టూ-ఫ్యాక్టర్ లాగిన్ కోసం TOTP సీక్రెట్. ఇది
twofactorటేబుల్లో ఎన్క్రిప్షన్ లేకుండా ఉంటుంది, ఎందుకంటే మీరు పంపే కోడ్తో పోల్చడానికి సర్వర్ ఆశించిన కోడ్ను లెక్కించాల్సి ఉంటుంది. ఇది మీరు vault ఐటమ్లో నిల్వ చేసే TOTP (time-based one-time password) సీక్రెట్ వంటిది కాదు, అది ఇతర ఫీల్డ్ల మాదిరిగానే ఎన్క్రిప్ట్ చేయబడుతుంది.
డేటా ఫోల్డర్ పరిమాణం చిన్నదిగా ఉంటుంది. Docker ఇన్స్టాలేషన్లో మీరు /data వద్ద మౌంట్ చేసిన ఫోల్డర్ ఏదైతే అదే డేటా ఫోల్డర్ అవుతుంది.
sudo ls -l /vw-data/db.sqlite3 దాదాపు అన్ని స్థితిని (state) కలిగి ఉంటుంది. attachments/ అప్లోడ్ చేసిన ఫైళ్లను డేటాబేస్ టేబుల్స్ వెలుపల, UUID డైరెక్టరీలలో ఉంచుతుంది. sends/ అనేది Send అటాచ్మెంట్లను కలిగి ఉంటుంది మరియు ఇది తాత్కాలికమైనది. icon_cache/ అనేది తొలగించదగినది. rsa_key.pem మరియు దాని అనుబంధ ఫైళ్లు లాగిన్ అయిన వినియోగదారుల JWTలను (JSON web tokens) సైన్ చేస్తాయి, కాబట్టి ఆ ప్రైవేట్ కీ కాపీని ఉపయోగించి vault లాగిన్ సెషన్ను ఫోర్జరీ చేయవచ్చు. config.json అడ్మిన్ పేజీ ద్వారా సేవ్ చేసిన సెట్టింగ్లను నిల్వ చేస్తుంది, ఇందులో SMTP క్రెడెన్షియల్స్ ప్లెయిన్టెక్స్ట్లో మరియు కాన్ఫిగర్ చేసిన అడ్మిన్ టోకెన్ విలువ ఉంటాయి. క్రింద ఉన్న Argon2 సూచనలను అనుసరించడం ద్వారా, ప్లెయిన్టెక్స్ట్ పాస్వర్డ్కు బదులుగా అడ్మిన్ టోకెన్ హ్యాష్ నిల్వ చేయబడుతుంది.
కాబట్టి, ఆచరణాత్మక ముప్పు నమూనా (threat model) అనేది నెట్వర్క్ క్రిప్టోగ్రఫీ కాదు, ఫైల్సిస్టమ్ యాక్సెస్. ఆ డైరెక్టరీకి రీడ్ యాక్సెస్ లభిస్తే, ప్రతి వినియోగదారు ఈమెయిల్ చిరునామా, వారి లాగిన్ 2FA సీక్రెట్స్, సెషన్లను ఫోర్జరీ చేసే కీ మరియు ప్రతి vault యొక్క ఆఫ్లైన్ కాపీ దొరుకుతాయి, వీటిని ఎవరైనా తీరికగా దాడి చేయడానికి ఉపయోగించవచ్చు. క్రింద ఉన్న ప్రతి దశ ఆ డైరెక్టరీలోకి ఇతరులు రాకుండా నిరోధించడానికి ఉద్దేశించబడింది.
ముందుగా అడ్మిన్ టోకెన్ను సరిచేయండి
/admin అనేది పూర్తి కంట్రోల్ ప్యానెల్: ఇందులో యూజర్ జాబితా, ఆహ్వానాలు, తొలగింపులు మరియు ప్రతి రన్టైమ్ సెట్టింగ్ ఉంటాయి. ఇది ఒకే షేర్డ్ సీక్రెట్ ద్వారా మాత్రమే రక్షించబడుతుంది. దీనికి యూజర్నేమ్ ఉండదు. ప్రతి యూజర్కు విడివిడిగా టూ-ఫ్యాక్టర్ అథెంటికేషన్ ఉండదు.
పాత గైడ్లు ADMIN_TOKEN ను openssl rand -base64 48 తో జనరేట్ చేయమని చెబుతాయి. అది పనిచేస్తుంది, కానీ మీరు ఎక్కడ కాన్ఫిగర్ చేసినా ఆ సీక్రెట్ ప్లెయిన్టెక్స్ట్ రూపంలోనే ఉంటుంది. Vaultwarden ఒక Argon2 PHC (password hashing competition) స్ట్రింగ్ను కూడా అంగీకరిస్తుంది, కాబట్టి నిల్వ చేయబడిన విలువ హ్యాష్ రూపంలో ఉంటుంది. రన్ అవుతున్న కంటైనర్ను ఉపయోగించి ఒకదాన్ని జనరేట్ చేయండి:
docker exec -it vaultwarden /vaultwarden hashలేదా రన్ అవుతున్న కంటైనర్తో సంబంధం లేకుండా:
docker run --rm -it vaultwarden/server /vaultwarden hashఇది పాస్వర్డ్ను రెండుసార్లు అడుగుతుంది, ఆపై $argon2id$ తో ప్రారంభమయ్యే ఒక లైన్ను ప్రింట్ చేస్తుంది. బేర్-మెటల్ ఇన్స్టాలేషన్లో, ./vaultwarden hash రన్ చేయండి. మీరు నేరుగా argon2 CLIని ఉపయోగించాలనుకుంటే, ప్రాజెక్ట్ డాక్యుమెంటేషన్లో OWASP కనీస పారామితులు ఇలా ఉన్నాయి:
echo -n 'MySecretPassword' | argon2 "$(openssl rand -base64 32)" -e -id -k 19456 -t 2 -p 1ఇప్పుడు చాలా మంది ఒక గంట సమయాన్ని వృథా చేసుకునే పొరపాటు గురించి తెలుసుకుందాం. PHC స్ట్రింగ్లో $ క్యారెక్టర్లు ఉంటాయి, మరియు Docker Compose లో $ అనేది వేరియబుల్ ఇంటర్పోలేషన్ కోసం ఉపయోగించబడుతుంది. దీన్ని ఎస్కేప్ చేయకుండా environment: బ్లాక్లో పేస్ట్ చేస్తే, కంటైనర్కు చేరే విలువ మారిపోతుంది, దీనివల్ల /admin మీరు ఇచ్చే సరైన టోకెన్ను కూడా తిరస్కరిస్తుంది. దీనికి రెండు సురక్షిత మార్గాలు ఉన్నాయి. docker-compose.yml లో, ప్రతి $ ను డబుల్ చేయండి:
environment:
ADMIN_TOKEN: $$argon2id$$v=19$$m=19456,t=2,p=1$$UUZxK1FZMkZoRHFQRlVrTXZvS0E3bHpNQW55c2dBN2NORzdsa0Nxd1JhND0$$cUoId+JBUsJutlG4rfDZayExfjq4TCt48aBc9qsc3UIఒక .env ఫైల్లో, ఎస్కేపింగ్ అవసరం లేదు, కానీ సింగిల్ కోట్స్ ఉపయోగించండి:
ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$MmeKRnGK5RW5mJS7h3TOL89GrpLPXJPAtTK8FTqj9HM$DqsstvoSAETl9YhnsXbf43WeaUwJC6JhViIvuPoig78'ఆ తర్వాత ప్యానెల్కు రేట్ లిమిట్ విధించి, దాని సెషన్ను తగ్గించండి:
ADMIN_RATELIMIT_SECONDS=300
ADMIN_RATELIMIT_MAX_BURST=3
ADMIN_SESSION_LIFETIME=20ఇది ప్రతి క్లయింట్ IPకి మూడు అడ్మిన్ లాగిన్ అభ్యర్థనలను అనుమతిస్తుంది, ఆపై ప్రతి ఐదు నిమిషాలకు ఒక అభ్యర్థన చొప్పున అనుమతిని పునరుద్ధరిస్తుంది. పాస్వర్డ్ చెక్ కంటే ముందే లిమిటర్ రన్ అవుతుంది కాబట్టి, సరైన మరియు తప్పు పాస్వర్డ్లు రెండూ లెక్కించబడతాయి. లిమిట్ దాటిన అభ్యర్థనలకు HTTP 429 మరియు Too many requests, try again later. వస్తుంది. మీరు ప్యానెల్ను ఉపయోగిస్తున్నా లేదా వాడకపోయినా, లాగిన్ అయిన 20 నిమిషాల తర్వాత అడ్మిన్ సెషన్ ముగుస్తుంది, ఎందుకంటే యాక్టివిటీ సెషన్ను పొడిగించదు.
వీటన్నింటికంటే ఉత్తమమైన మార్గం: ఈ పేజీని ఆపివేయడం. SMTPని కాన్ఫిగర్ చేయడానికి మరియు మొదటి యూజర్లను ఆహ్వానించడానికి మాత్రమే చాలా ఇన్స్టాన్స్లకు ఇది అవసరం, ఆ తర్వాత అవసరం ఉండదు. దీన్ని డిసేబుల్ చేయడానికి, ADMIN_TOKEN లేదా DISABLE_ADMIN_TOKEN సెట్ చేయవద్దు, config.json నుండి ఏదైనా "admin_token" కీని తొలగించండి, ఆపై కంటైనర్ను రీక్రియేట్ చేయండి. ఫైల్ నుండి కీని తొలగించడం ముఖ్యం, ఎందుకంటే అడ్మిన్ పేజీ సెట్టింగ్లను అక్కడ రాస్తుంది, మరియు config.json లో ఉన్నది ఎన్విరాన్మెంట్ వేరియబుల్ కంటే ప్రాధాన్యత కలిగి ఉంటుంది. కేవలం వేరియబుల్ను మాత్రమే తొలగిస్తే పేజీ అలాగే తెరిచి ఉంటుంది.
ఎవరైనా డొమైన్ను కనుగొనకముందే రిజిస్ట్రేషన్ను నిలిపివేయండి
SIGNUPS_ALLOWED=false
SIGNUPS_VERIFY=true
SHOW_PASSWORD_HINT=falseSIGNUPS_ALLOWED డిఫాల్ట్గా true కి సెట్ చేయబడి ఉంటుంది. దాన్ని అలాగే ఉంచితే, మీ డొమైన్ను సందర్శించే ఎవరైనా ఖాతాను సృష్టించుకోవచ్చు మరియు వారి డేటా మీ డేటా ఉన్న అదే db.sqlite3 లో నిల్వ చేయబడుతుంది. దీన్ని false కి మార్చి, అడ్మిన్ పేజీ నుండి ఆహ్వానాల ద్వారా వ్యక్తులను చేర్చుకోండి; SMTP ద్వారా ఆహ్వాన ఇమెయిల్ పంపబడుతుంది, ఒకవేళ SMTP లేకపోతే సర్వర్ ఆ ఇమెయిల్ చిరునామా కోసం ఆహ్వానాన్ని రికార్డ్ చేస్తుంది. INVITATIONS_ALLOWED కూడా డిఫాల్ట్గా true లో ఉంటుంది, ఇది సంస్థ అడ్మిన్లను ఇతరులను ఆహ్వానించడానికి అనుమతిస్తుంది. మీరు మీ వినియోగదారులను నమ్మినప్పుడు ఇది సరిపోతుంది, కానీ సింగిల్-యూజర్ ఇన్స్టాన్స్ అయితే దీన్ని false లో ఉంచాలి. ఒకవేళ నిర్దిష్ట డొమైన్ల నుండి మాత్రమే రిజిస్ట్రేషన్ జరగాలంటే, SIGNUPS_DOMAINS_WHITELIST=example.com అనేది ఓపెన్ సైన్-అప్ కంటే పరిమితమైనది, కానీ ఆహ్వాన పద్ధతి కంటే చాలా బలహీనమైనది.
SHOW_PASSWORD_HINT డిఫాల్ట్గా false లో ఉంటుంది మరియు అలాగే ఉంచాలి. ఇది ఆన్లో ఉండి, SMTP కాన్ఫిగర్ చేయబడకపోతే, లాగిన్ ఫారమ్లో సరైన ఇమెయిల్ చిరునామాను టైప్ చేసినప్పుడు ఆ ఖాతా యొక్క మాస్టర్ పాస్వర్డ్ హింట్ కనిపిస్తుంది. ఇది హింట్ను లీక్ చేయడమే కాకుండా, ఆ ఇమెయిల్ చిరునామా ఉనికిలో ఉందని కూడా నిర్ధారిస్తుంది.
మీ ఇన్స్టాన్స్ కొంతకాలం పాటు ఓపెన్ సైన్-అప్తో నడిచినట్లయితే, మీరు మాత్రమే ఆ ఖాతాలో ఉన్నారని భావించే ముందు, అడ్మిన్ పేజీని తెరిచి యూజర్ జాబితాను తనిఖీ చేయండి.
మీరు ప్రచురించాలనుకోని port
Docker image container లో port 80 పై listen చేస్తుంది. Bare-metal install డిఫాల్ట్గా ROCKET_PORT=8000 ను ఉపయోగిస్తుంది. Documentation లోని run command దీన్ని ఇలా publish చేస్తుంది:
--publish 127.0.0.1:8000:80127.0.0.1: prefixనే మొత్తం విషయానికి కారణం. దాని బదులుగా -p 8000:80 అని రాస్తే, Docker 0.0.0.0 ను bind చేస్తుంది. అలాగే nat table లో DNAT (destination network address translation) rules రాస్తుంది. ఈ rules ను ufw నిర్వహించే filter chains కంటే ముందుగా evaluate చేస్తారు. అందువల్ల ufw status ఆ port ను denied గా చూపించినా, ఆ port internet నుంచి వచ్చే అభ్యర్థనలకు స్పందిస్తుంది. ఈ పూర్తి విధానం గురించి ufw ను దాటే Docker ports guide లో చదవడం ఉపయోగకరం.
వాస్తవంగా ఏది listen చేస్తుందో పరిశీలించండి:
sudo ss -tlnp | grep 8000సరైన ఫలితంలో 127.0.0.1:8000 కు bind అయిన ఒకే ఒక line ఉంటుంది. 0.0.0.0:8000 కు bind అయిన line కనిపిస్తే vault నేరుగా exposed అయిందని అర్థం. Mapping ను సరిచేసి container ను మళ్లీ create చేయండి. ఎందుకంటే port binding container create చేసిన సమయంలో స్థిరపడుతుంది; docker compose restart దాన్ని మార్చదు:
docker compose up -d --force-recreateపాత guides లో కనిపించే మరో port 3012. ఇది ప్రత్యేక WebSocket port. Notification traffic ప్రధాన HTTP port పైకి మార్చబడినందున, Vaultwarden 1.31.0 లో దీనికి support తొలగించారు. WEBSOCKET_ENABLED మరియు WEBSOCKET_PORT ను 1.29.0 నుంచి deprecated చేశారు; అవి ignored అవుతాయి. ప్రస్తుత switch ENABLE_WEBSOCKET. దీని default విలువ true. మీ firewall లేదా compose file లో ఇంకా 3012 open చేసి ఉంటే, దాన్ని close చేయండి.
TLS termination ను Rocket లో కాకుండా reverse proxy వద్దే నిర్వహించండి
Vaultwarden తన web framework అయిన Rocket ద్వారా TLS (transport layer security) ను స్వయంగా అందించగలదు, కానీ production వాతావరణంలో అలా చేయవద్దని ప్రాజెక్ట్ సూచిస్తుంది. Rocket యొక్క అంతర్నిర్మిత TLS కు కఠినమైన SNI (server name indication) మద్దతు లేదు. అందుకే మీ instance ను ఎల్లప్పుడూ hostname ద్వారా మాత్రమే యాక్సెస్ చేయాలని, IP address ద్వారా ఎప్పుడూ యాక్సెస్ చేయకూడదని భద్రతా సలహాలు చెబుతున్నాయి. Public IP పరిధులు నిరంతరం స్కాన్ చేయబడుతుంటాయి; IP address ద్వారా స్పందించే vault సులభంగా గుర్తించబడుతుంది.
nginx server block లో ముఖ్యమైన భాగాలు ఇక్కడ ఉన్నాయి:
client_max_body_size 525M;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}nginx డిఫాల్ట్గా client_max_body_size ను 1m గా సెట్ చేస్తుంది, కాబట్టి ఈ పరిమితిని మార్చకపోతే అంతకంటే పెద్ద request bodies విఫలమవుతాయి. nginx క్లయింట్కు HTTP 413 ను పంపి, client intended to send too large body: ... bytes లో లాగ్ చేస్తుంది; తిరస్కరించబడిన upload Vaultwarden కు చేరదు. Upgrade మరియు Connection హెడర్లు WebSocket handshake ను /notifications/hub కి తీసుకువెళతాయి. వీటిని తొలగిస్తే vault పనిచేస్తుంది, కానీ WebSocket నోటిఫికేషన్లు బ్రౌజర్ మరియు డెస్క్టాప్ క్లయింట్లకు అందవు; మొబైల్ క్లయింట్లు విడిగా కాన్ఫిగర్ చేసిన push నోటిఫికేషన్లను ఉపయోగిస్తాయి.
Caddy మరింత క్లుప్తంగా ఉంటుంది మరియు సర్టిఫికేట్ను స్వయంగా పొందుతుంది:
vw.example.com {
reverse_proxy 127.0.0.1:8000 {
header_up X-Real-IP {remote_host}
}
}ఆ తర్వాత Vaultwarden కు ఈ విషయాన్ని తెలియజేయండి:
DOMAIN=https://vw.example.com
IP_HEADER=X-Real-IPIP_HEADER ఇప్పటికే డిఫాల్ట్గా X-Real-IP గా ఉంటుంది, కాబట్టి proxy ఆ హెడర్ను సెట్ చేస్తోందో లేదో చూసుకోవడం మీ బాధ్యత. Vaultwarden ఈ హెడర్ను IP_HEADER_TRUSTED_PROXIES లో పేర్కొన్న అడ్రస్ల నుండి మాత్రమే స్వీకరిస్తుంది, ఇది డిఫాల్ట్గా local గా ఉంటుంది: అంటే ఏవైనా non-global అడ్రస్లు, ఇవి ఒకే host లేదా ఒకే container network లో ఉన్న proxy కి సరిపోతాయి. Public address నుండి కనెక్ట్ అయ్యే proxy ని అక్కడ చేర్చాలి. హెడర్ లేకపోయినా లేదా నమ్మదగని అడ్రస్ నుండి వచ్చినా, ప్రతి log line మరియు login rate limit proxy యొక్క అడ్రస్నే చూపిస్తాయి. దీనివల్ల ఒక దాడి చేసే వ్యక్తి చేసిన తప్పులు instance లోని వినియోగదారులందరిపై ప్రభావం చూపుతాయి. మీరు IP_HEADER=X-Forwarded-For ఉపయోగిస్తుంటే, 1.37.4 వెర్షన్ నమ్మదగిన proxy కాని కుడివైపున ఉన్న చివరి అడ్రస్ను తీసుకుంటుంది, కాబట్టి nginx ముందున్న CDN తో సహా chain లోని ప్రతి proxy ని జాబితా చేయండి. DOMAIN ను కూడా సరైన https URL కి సెట్ చేయండి, ఎందుకంటే Vaultwarden ఆహ్వానాలు మరియు ఖాతా రికవరీ లింక్లను దీని ఆధారంగానే నిర్మిస్తుంది, మరియు WebAuthn సెక్యూరిటీ కీలు ఆ origin కే బంధించబడి ఉంటాయి.
చాలామంది గమనించని ఒక ముఖ్యమైన విషయం: WebSocket కనెక్షన్ session token ను query string లో /notifications/hub?access_token=[JWT] గా పంపుతుంది. ఇది మీ proxy access log లో స్పష్టంగా కనిపిస్తుంది. Log format లో access_token పారామీటర్ను redact చేయండి, లేదా ఆ లాగ్లు మీ నియంత్రణలో లేని చోటికి వెళ్లకుండా చూసుకోండి.
Login endpoint వద్ద brute force దాడులను నిరోధించడం
Rate limits డిఫాల్ట్గా ఆన్ చేయబడి ఉంటాయి (LOGIN_RATELIMIT_SECONDS=60, LOGIN_RATELIMIT_MAX_BURST=10). ఇవి దాడి చేసేవారి వేగాన్ని తగ్గిస్తాయి, కానీ పూర్తిగా ఆపలేవు. fail2ban దీనిని నిరోధించగలదు, అయితే దానికి Vaultwarden లో విఫలమైన లాగిన్ ప్రయత్నాల వివరాలు చదవగలిగే చోట ఉండాలి. Docker లో దీనికి సులభమైన మార్గం ఒక log file, కానీ Vaultwarden డిఫాల్ట్గా దానిని రాయదు:
LOG_FILE=/data/vaultwarden.log
LOG_LEVEL=info
EXTENDED_LOGGING=trueవిఫలమైన పాస్వర్డ్ లాగిన్ ప్రయత్నం ఈ క్రింది రూపంలో ఒక లైన్ను సృష్టిస్తుంది, మీ filter సరిపోల్చాల్సిన స్ట్రింగ్ ఇదే:
[2026-08-07 09:14:22.000][vaultwarden::api::identity][ERROR] Username or password is incorrect. Try again. IP: 203.0.113.10. Username: user@example.com.Filter ను /etc/fail2ban/filter.d/vaultwarden.local లో రాయండి:
[INCLUDES]
before = common.conf
[Definition]
failregex = ^.*?Username or password is incorrect\. Try again\. IP: <ADDR>\. Username:.*$
ignoreregex =మరియు jail ను /etc/fail2ban/jail.d/vaultwarden.local లో రాయండి:
[vaultwarden]
enabled = true
backend = pyinotify
port = 80,443
filter = vaultwarden
banaction = %(banaction_allports)s
logpath = /vw-data/vaultwarden.log
maxretry = 3
bantime = 14400
findtime = 14400Vaultwarden కంటైనర్లో కాకుండా systemd service గా నడుస్తుంటే, మీరు LOG_FILE ని దాటవేయవచ్చు: ప్రాజెక్ట్ యొక్క fail2ban wiki లో సూచించినట్లుగా, logpath కి బదులుగా backend = systemd మరియు Vaultwarden unit పై journalmatch ఉపయోగించి journal ను చదవవచ్చు.
మీరు admin page ను ఉంచినట్లయితే, failregex విలువ ^.*Invalid admin token\. IP: <ADDR>.*$ గా ఉండేలా రెండవ jail ను జోడించండి, ఎందుకంటే admin లాగిన్ విఫలమైనప్పుడు వేరే సందేశం నమోదవుతుంది మరియు సాధారణ login filter దానిని గుర్తించలేదు. ఆ తర్వాత మీ పనిని సరిచూసుకోండి:
sudo systemctl restart fail2ban
sudo fail2ban-client status vaultwardenసరిగ్గా పనిచేస్తున్న jail తన log file ను File list కింద చూపిస్తుంది మరియు Currently failed: 0 ని నివేదిస్తుంది. వేరే నెట్వర్క్ నుండి మూడుసార్లు తప్పు పాస్వర్డ్ ఎంటర్ చేయండి, అప్పుడు ఆ కౌంటర్ పెరుగుతుంది, ఆపై ఆ IP అడ్రస్ Banned IP list కింద కనిపిస్తుంది. కౌంటర్ అస్సలు పెరగకపోతే, సాధారణంగా logpath కారణం కావచ్చు: ఇది కంటైనర్ లోపల ఉన్న /data/... పాత్ కాకుండా, హోస్ట్ మెషీన్ పై ఉన్న ఫైల్ పాత్ అయి ఉండాలి. రెండవ సాధారణ కారణం X-Real-IP లేకపోవడం లేదా నమ్మదగినది కాకపోవడం, దీనివల్ల ప్రతి ban మీ స్వంత proxy నే లక్ష్యంగా చేసుకుంటుంది. మీరు ఇప్పటికే రన్ చేస్తున్న SSH jail తో సహా మిగిలిన సెటప్ వివరాలు Ubuntu 24.04 కోసం fail2ban గైడ్ లో ఉన్నాయి.
మాస్టర్ పాస్వర్డ్ ఇప్పటికీ మొత్తం సిస్టమ్కు కీలకం
క్లయింట్-సైడ్ ఎన్క్రిప్షన్ అంటే మాస్టర్ పాస్వర్డ్ వినియోగదారుని symmetric key ని రక్షిస్తుంది. ఒక దాడి చేసే వ్యక్తి డేటాబేస్ కాపీని పొందినప్పుడు, అందులో ఉన్న చిన్న మాస్టర్ పాస్వర్డ్ ఈ పోస్ట్లో పేర్కొన్న దేనివల్ల కూడా రక్షించబడదు. ఎందుకంటే వారు తమ హార్డ్వేర్ సామర్థ్యానికి అనుగుణంగా ఆ కాపీపై ఆఫ్లైన్లో దాడి చేస్తారు. సర్వర్ సెట్టింగ్లు ఏవీ దాడి చేసే వ్యక్తి సొంత మెషీన్పై ప్రభావం చూపవు.
PASSWORD_ITERATIONS=600000ని తప్పుగా అర్థం చేసుకోవడం సులభం. ఇది క్లయింట్ పంపే లాగిన్ హ్యాష్పై సర్వర్-సైడ్ హ్యాష్ కోసం iterations సంఖ్యను సెట్ చేస్తుంది. ప్రాజెక్ట్ కాన్ఫిగరేషన్ టెంప్లేట్ ప్రకారం, విలువను మార్చినప్పుడు అది వినియోగదారులు తదుపరిసారి లాగిన్ అయినప్పుడు వర్తిస్తుంది. ఇది క్లయింట్-సైడ్ KDFని మార్చదు; వాల్ట్పై ఆఫ్లైన్ దాడి ఎంత కష్టతరంగా ఉండాలో నిర్ణయించేది ఇదే. ఇది ప్రతి ఖాతాకు సంబంధించినది మరియు దీనిని వెబ్ వాల్ట్లోని Settings, Security, Keys విభాగంలో మార్చవచ్చు, ఇది కీని తిరిగి ఎన్క్రిప్ట్ చేస్తుంది. Bitwarden డాక్యుమెంటేషన్ ప్రకారం, 2026.2.1 వెర్షన్ నుండి దాని క్లయింట్లు 600,000 iterations కంటే తక్కువ ఉన్న PBKDF2 సెట్టింగ్ను వినియోగదారు లాగిన్ అయినప్పుడు లేదా మాస్టర్ పాస్వర్డ్తో అన్లాక్ చేసినప్పుడు స్వయంచాలకంగా పెంచుతాయి. 10 అక్టోబర్ 2026 నాటికి, ఈ ప్రవర్తన Vaultwarden సర్వర్పై నిర్ధారించబడలేదు మరియు ఇది Argon2id సెట్టింగ్లను ఎప్పటికీ మార్చదు. కాబట్టి, ఏళ్ల క్రితం సైన్ అప్ చేసిన వారు ఇంకా పాత, తక్కువ KDF సెట్టింగ్లోనే ఉండవచ్చు. దీనిని తనిఖీ చేసి వారికి తెలియజేయండి, ఎందుకంటే సర్వర్ వారి కోసం దీన్ని చేయలేదు.
ఆ తర్వాత, ప్రతి ఖాతాకు two-factor authenticationని ఎనేబుల్ చేయండి. ఇది ciphertextని రక్షించదు, ఎందుకంటే ఇది వాల్ట్ ఎన్క్రిప్షన్లో భాగం కాదు. అయితే, దొంగిలించబడిన పాస్వర్డ్తో లాగిన్ అవ్వకుండా మరియు కాపీని సింక్ చేయకుండా ఇది అడ్డుకుంటుంది. ఈమెయిల్ కాన్ఫిగర్ చేసినప్పుడు, REQUIRE_DEVICE_EMAIL=true కొత్త పరికరాల లాగిన్ ఈమెయిల్ను తప్పనిసరి చేస్తుంది: ఒకవేళ ఈమెయిల్ పంపడం విఫలమైతే, లాగిన్ కూడా విఫలమవుతుంది. మెయిల్ సర్వీస్ పూర్తిగా డిసేబుల్ చేయబడితే, ఈ సెట్టింగ్ కొత్త పరికరాల లాగిన్లను అడ్డుకోదు.
బ్యాకప్ల విషయంలోనే self-hosted వాల్ట్లు విఫలమవుతాయి
ఒకే VPS లోని home directory లో ఉంచిన డేటా ఫోల్డర్ యొక్క tar czf, పైన పేర్కొన్న అన్ని భద్రతా చర్యలను నిర్వీర్యం చేస్తుంది. ఆ ఆర్కైవ్లో ప్రతి వినియోగదారుని ciphertext ఉన్న db.sqlite3, లాగిన్ సెషన్లను ఫోర్జరీ చేయగల rsa_key.pem, మరియు కాన్ఫిగర్ చేసిన admin token విలువతో పాటు SMTP పాస్వర్డ్ ఉన్న config.json ఉంటాయి. Argon2 సూచనలను అనుసరించడం వల్ల admin పాస్వర్డ్ యొక్క hash మాత్రమే నిల్వ చేయబడుతుంది; కానీ SMTP పాస్వర్డ్ మాత్రం plaintext లోనే ఉంటుంది. ఆ ఒక్క ఫైల్కు read access ఉంటే చాలు, ఖాతా మెటాడేటా, సర్వర్ రహస్యాలు మరియు ఎన్క్రిప్ట్ చేసిన వాల్ట్ డేటా అన్నీ బయటపడతాయి.
దీనిని నివారించడానికి రెండు నియమాలు ఉన్నాయి. ఆర్కైవ్ను సర్వర్ నుండి బయటకు పంపండి. అది బయటకు వెళ్లే ముందే ఎన్క్రిప్ట్ చేయండి.
ఇక్కడ మరొక సమస్య కూడా ఉంది. సర్వీస్ రన్ అవుతున్నప్పుడు cp తో db.sqlite3 ని కాపీ చేయడం వల్ల, మధ్యలో ఆగిపోయిన (mid-write) ఫైల్ తయారయ్యే అవకాశం ఉంది. అటువంటి ఫైల్ ఓపెన్ అవ్వదు, ఇది మీరు restore చేసే వరకు తెలియదు. దానికి బదులుగా SQLite యొక్క సొంత snapshot ను ఉపయోగించండి:
sqlite3 /vw-data/db.sqlite3 ".backup '/tmp/vw-db-backup.sqlite3'"ఎవరూ పరీక్షించని మరొక ముఖ్యమైన అంశం restore చేయడం. దీని గురించి Vaultwarden బ్యాకప్ మరియు రీస్టోర్ గైడ్ లో వివరించబడింది.
Hosted Bitwarden తో పోలిస్తే మీరు కోల్పోయేవి
నిజాయితీగా చెప్పాలంటే, Bitwarden యొక్క hosted సేవను పూర్తికాలం అదే పనిగా నిర్వహించే నిపుణులు నడుపుతారు, మరియు దీనికి సంబంధించి ప్రచురించబడిన థర్డ్-పార్టీ ఆడిట్లు కూడా ఉన్నాయి. Self-hosting ఎంచుకున్నప్పుడు, ఆ బాధ్యతను మీరు మీ స్వంత patch నిర్వహణతో భర్తీ చేసుకుంటారు.
Vaultwarden భద్రతాపరమైన సవరణలను సాధారణ releases రూపంలో తరచుగా విడుదల చేస్తుంది. 2 November 2026 న ప్రాజెక్ట్ యొక్క release feed ను పరిశీలించగా, ప్రస్తుత release 1.37.5 అని, ఇది 1 November 2026 న ప్రచురించబడిందని తెలిసింది. దీని నోట్స్ రెండు Medium స్థాయి భద్రతా సలహాలను (security advisories) కవర్ చేస్తాయి మరియు వీలైనంత త్వరగా update చేయమని గట్టిగా సూచిస్తాయి. అలాగే, two-step login పద్ధతులను ఆన్ లేదా ఆఫ్ చేయడానికి web vault 2026.7.1 లేదా అంతకంటే కొత్త వెర్షన్, మరియు emergency access ద్వారా ఖాతాను స్వాధీనం చేసుకోవడానికి 2026.9.0 లేదా అంతకంటే కొత్త వెర్షన్ అవసరం. దీనికి ముందు వచ్చిన 1.37.4 release, 5 October 2026 న ప్రచురించబడింది. ఇది ఏడు భద్రతా సలహాలను కవర్ చేసింది, అందులో అత్యంత తీవ్రమైనది High గా రేట్ చేయబడింది. 24 July 2026 న వచ్చిన 1.37.0 తర్వాత ఇది నాలుగవ release: 1.37.1 జూలై 29న, 1.37.2 ఆగస్టు 22న (ఇది 2026.8.0 మరియు అంతకంటే కొత్త వెర్షన్ క్లయింట్లకు అవసరం), మరియు 1.37.3 సెప్టెంబర్ 13న విడుదలయ్యాయి. 1.37.3 వెర్షన్, credentials లేదా 2FA మారినప్పుడు 2FA remember tokens ను రద్దు చేస్తుంది మరియు prelogin, auth request endpoints కు rate limits ను విధిస్తుంది. మీరు పూర్తిగా నమ్మలేని అడ్మిన్లు ఉన్న సంస్థలను నిర్వహిస్తుంటే, 1.37.4 నోట్స్ ప్రకారం update చేసిన తర్వాత ప్రతి సంస్థ యొక్క API key ని మార్చడం (rotate చేయడం) మంచిది. 1.37.4 వెర్షన్, పైన పేర్కొన్న reverse proxy విభాగంలో వివరించిన X-Forwarded-For నుండి ఏ చిరునామాను చదవాలో కూడా మారుస్తుంది. మీరు ఒక సంవత్సరం క్రితం సెటప్ చేసి మర్చిపోయిన instance, ఏడాది పాత కోడ్తో నడుస్తూ ఉంటుంది. latest tag ఒక్కటే మీకు సహాయపడదు: మీరు docker compose pull రన్ చేసి container ను తిరిగి సృష్టించే వరకు, నడుస్తున్న container అది ప్రారంభమైన image తోనే ఉంటుంది. హోస్ట్ ప్యాకేజీల కోసం Ubuntu లో unattended upgrades ను అమర్చుకోండి, మరియు container update కోసం మీరు ఖచ్చితంగా చూసేలా ఒక calendar reminder ను సెట్ చేసుకోండి.
ఒక నిజాయితీ గల పాఠకుడు గ్రహించాల్సిన ముగింపు ఇది: ఇక్కడ ఉన్న cryptography అనేది Bitwarden యొక్క డిజైన్ మరియు అది పటిష్టంగా ఉంది, కానీ నిర్వహణకు సంబంధించిన రిస్క్ పూర్తిగా మీపైనే ఉంటుంది. మీరు దీన్ని క్రమం తప్పకుండా patch చేస్తూ, వేరే చోట backup తీసుకుంటే, మీరు నియంత్రించే VPS లోని Vaultwarden instance మీ పాస్వర్డ్లను దాచుకోవడానికి ఒక మంచి ప్రదేశం. ఈ రెండు అలవాట్లు మీకు లేకపోతే, hosted సేవ కోసం డబ్బు చెల్లించి, మీ దృష్టిని ఇతర విషయాలపై పెట్టండి. ఫీచర్ల వారీగా పోలిక Vaultwarden మరియు self-hosted Bitwarden మధ్య పోలిక లో ఉంది.
కంటైనర్ కింద ఉన్న host ను భద్రపరచండి
Vaultwarden అనేది Linux box పై నడిచే ఒక process. ఆ box పై ఉన్న root, అప్లికేషన్ను ఎలా configure చేసినా /vw-data ను చదవగలదు. మీ compose file లో user: "1000:1000" ఉపయోగించి కంటైనర్ను unprivileged user గా నడపండి. Data folder ownership కూడా దానికి సరిపోయేలా సెట్ చేయండి. కంటైనర్ రాయాల్సిన అవసరం లేని ప్రతిదాన్ని :ro తో read-only గా mount చేయండి. తరువాత ముందువైపు ప్రవేశాన్ని మూసివేయండి: VPS పై SSH భద్రతా బలోపేతంలో key-only login మరియు password authentication ను నిలిపివేయడం గురించి ఉంది. ఇవే పై భద్రతా చర్యలన్నింటినీ దాటే సాధారణ దాడులను నిరోధిస్తాయి.
FAQ
Vaultwarden డేటాబేస్ను ఎవరైనా దొంగిలిస్తే నా పాస్వర్డ్లను చదవగలరా?
నేరుగా చదవలేరు. ప్రతి vault అంశం క్లయింట్ వైపు ఒక యాదృచ్ఛిక కీతో ఎన్క్రిప్ట్ చేయబడుతుంది; ఇది వినియోగదారు లేదా సంస్థ యొక్క సిమెట్రిక్ కీ ద్వారా రక్షించబడుతుంది. పాస్వర్డ్ ద్వారా పొందిన కీ, వినియోగదారు యొక్క సిమెట్రిక్ కీని రక్షిస్తుంది. db.sqlite3 లో ఎన్క్రిప్ట్ చేయబడిన vault కంటెంట్తో పాటు ప్లెయిన్టెక్స్ట్ అకౌంట్ మెటాడేటా ఉంటాయి. వారికి వెంటనే లభించేవి: ప్రతి అకౌంట్ యొక్క ఈమెయిల్ అడ్రస్, పాస్వర్డ్ హింట్, KDF సెట్టింగ్లు, లాగిన్ మరియు డివైజ్ మెటాడేటా. అలాగే twofactor టేబుల్లోని లాగిన్ TOTP సీక్రెట్స్ కూడా వారికి దొరుకుతాయి, ఎందుకంటే సర్వర్ ఆశించిన కోడ్ను లెక్కించాల్సి ఉంటుంది కాబట్టి అవి ఎన్క్రిప్షన్ లేకుండా నిల్వ చేయబడతాయి. వారు vault సైఫర్టెక్స్ట్పై ఆఫ్లైన్లో ఎంత కాలమైనా దాడి చేయవచ్చు, అందుకే మాస్టర్ పాస్వర్డ్ పొడవు అనేది ఫలితాన్ని నిర్ణయించే కీలకమైన అంశం.
నేను ADMIN_TOKEN ను ఉపయోగించాలా లేదా అడ్మిన్ పేజీని పూర్తిగా డిసేబుల్ చేయాలా?
వీలైతే డిసేబుల్ చేయండి, ఎందుకంటే చాలా ఇన్స్టాన్స్లకు SMTP కాన్ఫిగర్ చేయడానికి మరియు వినియోగదారులను ఆహ్వానించడానికి మాత్రమే ఇది అవసరం, ఆ తర్వాత అవసరం ఉండదు. దీన్ని డిసేబుల్ చేయడానికి, ADMIN_TOKEN మరియు DISABLE_ADMIN_TOKEN రెండింటినీ సెట్ చేయవద్దు, config.json నుండి ఏదైనా "admin_token" కీని తొలగించి, ఆపై కంటైనర్ను మళ్లీ క్రియేట్ చేయండి. కేవలం ఎన్విరాన్మెంట్ వేరియబుల్ను తొలగిస్తే సరిపోదు, ఎందుకంటే అడ్మిన్ పేజీ ద్వారా రాసిన సెట్టింగ్లు config.json లో ఉంటాయి మరియు అవే ప్రాధాన్యతను కలిగి ఉంటాయి. ఒకవేళ మీరు పేజీని ఉంచాలనుకుంటే, టోకెన్ను ప్లెయిన్టెక్స్ట్ స్ట్రింగ్గా కాకుండా vaultwarden hash ద్వారా రూపొందించిన Argon2 హ్యాష్గా నిల్వ చేయండి మరియు ADMIN_RATELIMIT_MAX_BURST=3 ను సెట్ చేయండి.
నా ADMIN_TOKEN సరైనదే, కానీ /admin పేజీ దాన్ని తిరస్కరిస్తోంది. సమస్య ఏమిటి?
ఇది దాదాపు ఎప్పుడూ $ ఇంటర్పోలేషన్ వల్ల జరుగుతుంది. ఒక Argon2 PHC స్ట్రింగ్లో అనేక $ క్యారెక్టర్లు ఉంటాయి. Docker Compose వీటిని docker-compose.yml environment: బ్లాక్లోని వేరియబుల్స్గా విస్తరిస్తుంది, దీనివల్ల కంటైనర్కు తప్పు విలువ అందుతుంది (మీ ఫైల్లో అది సరిగ్గానే కనిపిస్తున్నప్పటికీ). కంపోజ్ ఫైల్లో ప్రతి $ ను $$ గా మార్చండి (డబుల్ చేయండి), లేదా ఆ విలువను సింగిల్ కోట్స్లో ఉన్న .env ఫైల్లోకి తరలించండి, అక్కడ ఎస్కేపింగ్ అవసరం ఉండదు. ఆ తర్వాత కంటైనర్ను మళ్లీ క్రియేట్ చేయండి, ఎందుకంటే కేవలం రీస్టార్ట్ చేస్తే ఎన్విరాన్మెంట్ మార్పులు అమలు కావు.
నోటిఫికేషన్ల కోసం నేను ఇంకా 3012 పోర్ట్ను ఓపెన్ చేయాలా?
అవసరం లేదు. Vaultwarden 1.31.0 వెర్షన్ నుండి 3012 పోర్ట్పై WebSocket ట్రాఫిక్ మద్దతును తొలగించారు, ఎందుకంటే నోటిఫికేషన్లు ప్రధాన HTTP పోర్ట్కు మారాయి. WEBSOCKET_ENABLED మరియు WEBSOCKET_PORT లు 1.29.0 నుండి నిలిపివేయబడ్డాయి (deprecated) మరియు వాటిని పట్టించుకోరు. ప్రస్తుత సెట్టింగ్ ENABLE_WEBSOCKET, ఇది డిఫాల్ట్గా true గా ఉంటుంది. ఫైర్వాల్లో 3012 పోర్ట్ను క్లోజ్ చేసి, మీ కంపోజ్ ఫైల్ నుండి దాన్ని తొలగించండి. ఆ తర్వాత మీ రివర్స్ ప్రాక్సీ Upgrade మరియు Connection హెడర్లను ఫార్వర్డ్ చేస్తోందని నిర్ధారించుకోండి, ఎందుకంటే బ్రౌజర్ మరియు డెస్క్టాప్ WebSocket నోటిఫికేషన్లు వీటిపైనే ఆధారపడి ఉంటాయి. మొబైల్ క్లయింట్లు విడిగా కాన్ఫిగర్ చేసిన పుష్ నోటిఫికేషన్లను ఉపయోగిస్తాయి.