SSD Nodes Learn Hosting plans →

Vaultwarden பாதுகாப்பானதா? பாதுகாப்பு மேம்பாட்டு வழிகாட்டி

Vaultwarden உங்கள் தரவை குறியாக்கம் செய்தாலும், account metadata மற்றும் admin token பாதுகாப்பில் கவனமாக இருக்க வேண்டும். உங்கள் server-ஐ பாதுகாக்க வேண்டிய முறைகளை இங்கே அறியுங்கள்.

Vaultwarden பாதுகாப்பானதா? சுருக்கமான பதில்

Vaultwarden மிக முக்கியமான இடத்தில் பாதுகாப்பாக உள்ளது, ஏனெனில் ஒவ்வொரு vault உருப்படியும் server-ஐ அடைவதற்கு முன்பே உங்கள் சாதனத்திலேயே குறியாக்கப்படுகிறது (encrypted). Server-ஆனது குறியாக்கம் செய்யப்பட்ட vault உள்ளடக்கங்களையும், plain text வடிவிலான account metadata-வையும் சேமிக்கிறது. முழு database-ஐயும் நகலெடுப்பவர், அதன் உள்ளடக்கத்தைப் படிக்க vault-ன் encryption keys-ஐ வைத்திருக்க வேண்டும்; ஆனால், account மின்னஞ்சல் முகவரிகளையும் password குறிப்புகளையும் அவர்களால் உடனடியாகப் பெற முடியும்.

இந்த பதில் பல விஷயங்களை உள்ளடக்கியது, ஆனால் நீங்கள் சரியாக உள்ளமைக்காத (configure) பகுதிகளே பாதுகாப்புச் சிக்கல்களை உருவாக்குகின்றன. ஊகிக்கக்கூடிய token-க்கு பின்னால் உள்ள admin panel, இணையம் முழுமைக்கும் திறக்கப்பட்ட container port, plain text வடிவிலான config.json, அதே server-ன் home directory-ல் இருக்கும் backup tarball போன்றவை இதற்கு உதாரணம். இவை எதுவும் cryptography தொடர்பான சிக்கல்கள் அல்ல. இவை அனைத்தும் self-hosted vaults திருடப்படுவதற்கான காரணங்களாகும்.

கீழே உள்ள அனைத்தும் ஏற்கனவே சரியாக நிறுவப்பட்ட ஒரு அமைப்பை அடிப்படையாகக் கொண்டவை. உங்களிடம் இன்னும் அத்தகைய அமைப்பு இல்லையென்றால், முதலில் the Vaultwarden install guide for a VPS மூலம் அதை நிறுவிவிட்டு, பின்னர் இந்த வரிசைப்படி தொடரவும்.

சர்வர் உண்மையில் எதைச் சேமிக்கிறது

Vaultwarden, Bitwarden-ன் தரவு மாதிரியை (data model) செயல்படுத்துகிறது. ஒரு vault item-ன் பெயர், பயனர் பெயர், கடவுச்சொல், குறிப்புகள் மற்றும் URIs ஆகியவை, எந்தவொரு கோரிக்கையும் அனுப்பப்படுவதற்கு முன்பே, client-ல் தோராயமாக உருவாக்கப்பட்ட ஒரு item key மூலம் குறியாக்கம் (encrypt) செய்யப்படுகின்றன. அந்த key, பயனர் அல்லது நிறுவனத்தின் symmetric key மூலம் பாதுகாக்கப்படுகிறது; பயனர் கடவுச்சொல்லிலிருந்து பெறப்பட்ட key, பயனரின் symmetric key-ஐப் பாதுகாக்கிறது. இணைக்கப்பட்ட கோப்புகளின் (attachments) உள்ளடக்கங்கள், item key மூலம் பாதுகாக்கப்பட்ட ஒரு தனி attachment key-ஐப் பயன்படுத்துகின்றன. சர்வர், அதனுடன் இணைக்கப்பட்ட ஒரு UUID (universally unique identifier) கொண்ட தெளிவற்ற (opaque) தரவைப் பெறுகிறது.

சில விஷயங்கள் ciphertext-ஆக இருப்பதில்லை, அவை எவை என்பதை நீங்கள் துல்லியமாகத் தெரிந்து கொள்ள வேண்டும்:

  • உங்கள் கணக்கு மின்னஞ்சல் முகவரி மற்றும் master password hint, இவை plaintext-ஆக இருக்கும்.
  • உங்கள் KDF (key derivation function) அமைப்புகள் மற்றும் salt, ஏனெனில் அடுத்த முறை login செய்யும்போது key-ஐ மீண்டும் உருவாக்க client-க்கு இவை தேவை.
  • client அனுப்பும் master password hash-ன் சர்வர்-பக்க hash, இது login-ஐ உறுதிப்படுத்தப் பயன்படுகிறது.
  • Metadata: நிறுவன உறுப்பினர் விவரங்கள், சாதனப் பெயர்கள், கடைசி login நேரங்கள்.
  • Authenticator-அடிப்படையிலான two-factor login-க்கான TOTP secret. இது twofactor அட்டவணையில் குறியாக்கம் செய்யப்படாமல் (unencrypted) இருக்கும், ஏனெனில் உங்களுடைய குறியீட்டுடன் ஒப்பிடுவதற்கு, எதிர்பார்க்கப்படும் குறியீட்டை சர்வர் கணக்கிட வேண்டும். இது ஒரு vault item-க்குள் நீங்கள் சேமிக்கும் TOTP (time-based one-time password) secret-க்கு சமமானது அல்ல; அது மற்ற புலங்களைப் போலவே குறியாக்கம் செய்யப்படுகிறது.

தரவு கோப்புறை (data folder) சிறியது. Docker நிறுவலில், நீங்கள் /data-ல் எதை mount செய்தீர்களோ அதுவே அது.

sudo ls -l /vw-data/

db.sqlite3 கிட்டத்தட்ட அனைத்து நிலைகளையும் (state) கொண்டுள்ளது. attachments/, database அட்டவணைகளுக்கு வெளியே, UUID கோப்புறைகளின் கீழ் பதிவேற்றப்பட்ட கோப்புகளைக் கொண்டுள்ளது. sends/, Send இணைப்புகளைக் கொண்டுள்ளது மற்றும் இது தற்காலிகமானது. icon_cache/ என்பது தேவையற்றது (throwaway). rsa_key.pem மற்றும் அதன் துணைக்கோப்புகள், login செய்த பயனர்களின் JWTs (JSON web tokens)-ஐ கையொப்பமிடுகின்றன (sign), எனவே அந்த private key-ன் நகலைப் பயன்படுத்தி ஒரு vault login session-ஐ போலியாக உருவாக்க முடியும். config.json, admin பக்கம் வழியாகச் சேமிக்கப்பட்ட அமைப்புகளைக் கொண்டுள்ளது, இதில் SMTP நற்சான்றிதழ்கள் (credentials) plaintext-ஆகவும், கட்டமைக்கப்பட்ட admin token மதிப்பும் அடங்கும். கீழே உள்ள Argon2 வழிமுறைகளைப் பின்பற்றுவது, plaintext கடவுச்சொல்லுக்குப் பதிலாக admin token hash-ஐச் சேமிக்கும்.

எனவே, நடைமுறை அச்சுறுத்தல் மாதிரி (threat model) என்பது network cryptography அல்ல, filesystem அணுகல் ஆகும். அந்த ஒரு கோப்புறைக்கான வாசிப்பு அணுகல் (read access), ஒவ்வொரு பயனரின் மின்னஞ்சல் முகவரி, அவர்களின் login 2FA secrets, session-களைப் போலியாக உருவாக்கும் ஒரு key மற்றும் ஒவ்வொரு vault-ன் ஆஃப்லைன் நகல் ஆகியவற்றைத் தாக்குபவர்களுக்கு எளிதாகக் கொடுத்துவிடும். கீழே உள்ள ஒவ்வொரு படியும், அந்த கோப்புறைக்குள் மற்றவர்கள் நுழைவதைத் தடுப்பதற்காகவே உருவாக்கப்பட்டுள்ளது.

முதலில் admin token-ஐ சரிசெய்யவும்

/admin என்பது முழுமையான கட்டுப்பாட்டுப் பலகமாகும்: பயனர் பட்டியல், அழைப்புகள், நீக்கம் மற்றும் ஒவ்வொரு runtime அமைப்புகளையும் இது கொண்டுள்ளது. இது ஒரே ஒரு பகிரப்பட்ட ரகசியத்தால் (shared secret) மட்டுமே பாதுகாக்கப்படுகிறது. இதில் username கிடையாது. ஒவ்வொரு பயனருக்குமான two-factor authentication வசதியும் இல்லை.

பழைய வழிகாட்டிகள் openssl rand -base64 48 மூலம் ADMIN_TOKEN-ஐ உருவாக்கச் சொல்கின்றன. அது வேலை செய்யும், ஆனால் நீங்கள் அதை எங்கு configure செய்தாலும் அந்த ரகசியம் plaintext வடிவிலேயே இருக்கும். Vaultwarden ஒரு Argon2 PHC (password hashing competition) string-ஐயும் ஏற்கும், எனவே சேமிக்கப்படும் மதிப்பு hash வடிவில் இருக்கும். இயங்கிக்கொண்டிருக்கும் container-ல் ஒன்றை உருவாக்கவும்:

docker exec -it vaultwarden /vaultwarden hash

அல்லது இயங்கும் container-ஐத் தொடாமலேயே உருவாக்க:

docker run --rm -it vaultwarden/server /vaultwarden hash

இது கடவுச்சொல்லை இருமுறை கேட்கும், பின்னர் $argon2id$ என்று தொடங்கும் ஒரு வரியை அச்சிடும். Bare-metal நிறுவலில், ./vaultwarden hash-ஐ இயக்கவும். நீங்கள் argon2 CLI-ஐ நேரடியாகப் பயன்படுத்த விரும்பினால், OWASP-ன் குறைந்தபட்ச அளவுருக்களைப் பயன்படுத்தவும்:

echo -n 'MySecretPassword' | argon2 "$(openssl rand -base64 32)" -e -id -k 19456 -t 2 -p 1

இப்போது பலரை ஒரு மணிநேரம் வரை திணறடிக்கும் சிக்கல். ஒரு PHC string-ல் நிறைய $ குறியீடுகள் இருக்கும், Docker Compose அவற்றை $ variable interpolation-ஆகக் கருதும். அதை escape செய்யாமல் environment: block-ல் ஒட்டினால், container-க்குச் செல்லும் மதிப்பு சிதைந்துவிடும், இதனால் /admin நீங்கள் சரியாக உள்ளிடும் token-ஐயும் நிராகரிக்கும். இரண்டு பாதுகாப்பான வழிகள் உள்ளன. docker-compose.yml-ல், ஒவ்வொரு $-ஐயும் இரண்டு முறை இடவும்:

environment:
  ADMIN_TOKEN: $$argon2id$$v=19$$m=19456,t=2,p=1$$UUZxK1FZMkZoRHFQRlVrTXZvS0E3bHpNQW55c2dBN2NORzdsa0Nxd1JhND0$$cUoId+JBUsJutlG4rfDZayExfjq4TCt48aBc9qsc3UI

ஒரு .env கோப்பில், escape செய்யத் தேவையில்லை, ஆனால் single quotes-ஐப் பயன்படுத்தவும்:

ADMIN_TOKEN='$argon2id$v=19$m=65540,t=3,p=4$MmeKRnGK5RW5mJS7h3TOL89GrpLPXJPAtTK8FTqj9HM$DqsstvoSAETl9YhnsXbf43WeaUwJC6JhViIvuPoig78'

பின்னர் panel-க்கான rate limit-ஐ அமைத்து அதன் session காலத்தைக் குறைக்கவும்:

ADMIN_RATELIMIT_SECONDS=300
ADMIN_RATELIMIT_MAX_BURST=3
ADMIN_SESSION_LIFETIME=20

இது ஒரு client IP-க்கு மூன்று admin login முயற்சிகளை அனுமதிக்கும், பின்னர் ஒவ்வொரு ஐந்து நிமிடத்திற்கும் ஒரு முயற்சி என்ற விகிதத்தில் அனுமதி புதுப்பிக்கப்படும். கடவுச்சொல் சரிபார்ப்பிற்கு முன்பே limiter இயங்குவதால், சரியான மற்றும் தவறான கடவுச்சொற்கள் என இரண்டுமே கணக்கில் கொள்ளப்படும். வரம்பிற்கு மேல் வரும் கோரிக்கைகள் HTTP 429 பிழையையும் Too many requests, try again later.-ஐயும் பெறும். நீங்கள் panel-ஐப் பயன்படுத்தினாலும் இல்லாவிட்டாலும், login செய்த 20 நிமிடங்களுக்குப் பிறகு admin session முடிந்துவிடும், ஏனெனில் செயல்பாடு (activity) அதன் காலத்தை நீட்டிக்காது.

இவை அனைத்தையும் விட சிறந்தது: அந்தப் பக்கத்தை அணைத்துவிடுவது. SMTP-ஐ configure செய்யவும், முதல் பயனர்களை அழைக்கவும் மட்டுமே பெரும்பாலான instances-க்கு இது தேவைப்படுகிறது, அதன் பிறகு தேவைப்படாது. இதை முடக்க, ADMIN_TOKEN அல்லது DISABLE_ADMIN_TOKEN எதையும் அமைக்க வேண்டாம், config.json-லிருந்து ஏதேனும் "admin_token" key இருந்தால் அதை நீக்கிவிட்டு, container-ஐ மீண்டும் உருவாக்கவும். கோப்பிலிருந்து key-ஐ நீக்குவது முக்கியம், ஏனெனில் admin பக்கம் அமைப்புகளை அங்கேயே எழுதும், மேலும் config.json-ல் உள்ளதே இறுதியானதாகக் கருதப்படும். variable-ஐ மட்டும் நீக்கினால், அந்தப் பக்கம் திறந்தே இருக்கும்.

யாராவது domain-ஐக் கண்டறிவதற்கு முன்பே பதிவுகளை மூடிவிடுதல்

SIGNUPS_ALLOWED=false
SIGNUPS_VERIFY=true
SHOW_PASSWORD_HINT=false

SIGNUPS_ALLOWED இயல்பாக true என்று இருக்கும். அதை அப்படியே விட்டால், உங்கள் domain-க்கு வரும் எவரும் கணக்கை உருவாக்க முடியும், மேலும் அவர்களின் தரவு உங்களுடைய அதே db.sqlite3-ல் சேமிக்கப்படும். இதை false என்று மாற்றி, admin பக்கத்திலிருந்து அழைப்பிதழ்கள் மூலம் நபர்களைச் சேர்க்கவும்; SMTP அழைப்பிதழ் மின்னஞ்சலை அனுப்பும், அது இல்லையெனில் server அந்த முகவரிக்கான அழைப்பை மட்டும் பதிவு செய்யும். INVITATIONS_ALLOWED என்பதும் இயல்பாக true என்று இருக்கும், இது நிறுவன நிர்வாகிகளை மற்றவர்களை அழைக்க அனுமதிக்கிறது. நீங்கள் பயனர்களை நம்பினால் இது சரி, ஆனால் ஒரே ஒரு பயனர் மட்டுமே உள்ள instance-ல் இது false என்று இருக்க வேண்டும். குறிப்பிட்ட domain-கள் மட்டுமே பதிவு செய்ய வேண்டும் என்றால், SIGNUPS_DOMAINS_WHITELIST=example.com என்பது open signup-ஐ விடக் குறுகிய கட்டுப்பாட்டைக் கொண்டது, ஆனால் அழைப்பிதழ் முறையை விட மிகவும் பலவீனமானது.

SHOW_PASSWORD_HINT இயல்பாக false என்று இருக்கும், அதை அப்படியே வைத்திருப்பது நல்லது. இது செயல்பாட்டில் இருந்து, SMTP அமைக்கப்படாமல் இருந்தால், login படிவத்தில் சரியான மின்னஞ்சல் முகவரியை உள்ளிட்டால், அந்தக் கணக்கின் master password குறிப்பு (hint) காட்டப்படும். இது குறிப்பை வெளிப்படுத்துவதுடன், அந்த மின்னஞ்சல் முகவரி பயன்பாட்டில் இருப்பதையும் உறுதிப்படுத்திவிடும்.

உங்கள் instance ஏதேனும் ஒரு காலத்திற்குப் பதிவுகளுக்குத் திறந்திருந்தால், admin பக்கத்தைத் திறந்து பயனர் பட்டியலைச் சரிபார்க்கவும். அதன் பிறகு மட்டுமே நீங்கள் மட்டுமே அந்த instance-ல் பயனர் என்று கருதவும்.

நீங்கள் வெளியிட விரும்பாத port

Docker image-ஆனது container-க்குள் port 80-ல் இயங்குகிறது. Bare-metal நிறுவலின் default மதிப்பு ROCKET_PORT=8000 ஆகும். ஆவணப்படுத்தப்பட்ட run கட்டளை அதை இவ்வாறு வெளியிடுகிறது:

--publish 127.0.0.1:8000:80

127.0.0.1: முன்னொட்டுதான் (prefix) இதன் முழு நோக்கமும். அதற்குப் பதிலாக -p 8000:80 என்று எழுதினால், Docker 0.0.0.0-ஐ பிணைக்கும் (bind). இது nat அட்டவணையில் DNAT (destination network address translation) விதிகளை எழுதுவதன் மூலம் நடைபெறுகிறது. அந்த விதிகள் ufw நிர்வகிக்கும் filter சங்கிலிகளுக்கு (chains) முன்பே மதிப்பீடு செய்யப்படுகின்றன. எனவே, அந்த port இணையத்திற்குத் தடையின்றி பதிலளிக்கும்போதும், ufw status அந்த port மறுக்கப்பட்டதாகவே காட்டும். இதன் முழுமையான செயல்பாட்டை Docker ports ufw-ஐத் தவிர்க்கும் முறை குறித்த வழிகாட்டி-யில் படிப்பது பயனுள்ளது.

எது உண்மையில் listen செய்கிறது என்பதைச் சரிபார்க்கவும்:

sudo ss -tlnp | grep 8000

சரியான முடிவு என்பது 127.0.0.1:8000-ல் பிணைக்கப்பட்ட ஒரு வரியாகும். 0.0.0.0:8000-ல் பிணைக்கப்பட்ட வரி இருந்தால், vault நேரடியாக வெளிப்படுத்தப்பட்டுள்ளது என்று பொருள். Mapping-ஐச் சரிசெய்துவிட்டு, container-ஐ மீண்டும் உருவாக்கவும். ஏனெனில், container உருவாக்கப்படும்போதே port binding நிலைநிறுத்தப்பட்டுவிடும், docker compose restart அதை மாற்றாது:

docker compose up -d --force-recreate

பழைய வழிகாட்டிகளில் இன்னும் ஒரு port உள்ளது: 3012, இது தனித்த WebSocket port ஆகும். Vaultwarden 1.31.0 பதிப்பில் இதற்கான ஆதரவு நீக்கப்பட்டுவிட்டது, ஏனெனில் அறிவிப்புத் தரவுப் போக்குவரத்து (notification traffic) முதன்மை HTTP port-க்கு மாற்றப்பட்டது. WEBSOCKET_ENABLED மற்றும் WEBSOCKET_PORT ஆகியவை 1.29.0 பதிப்பிலிருந்தே deprecated செய்யப்பட்டுள்ளன, அவை புறக்கணிக்கப்படுகின்றன. தற்போதைய switch ENABLE_WEBSOCKET ஆகும், இதன் default மதிப்பு true ஆகும். உங்கள் firewall அல்லது compose கோப்பில் இன்னும் 3012 திறந்திருந்தால், அதை மூடிவிடவும்.

Rocket-ல் அல்லாமல், ஒரு reverse proxy-ல் TLS-ஐ முடிவுக்குக் கொண்டுவருதல்

Vaultwarden தனது web framework-ஆன Rocket மூலம் TLS (transport layer security)-ஐ வழங்க முடியும். ஆனால், production சூழலில் அவ்வாறு செய்ய வேண்டாம் என்று இந்தத் திட்டம் அறிவுறுத்துகிறது. Rocket-ன் உள்ளமைக்கப்பட்ட TLS-ல் முறையான SNI (server name indication) ஆதரவு இல்லை. இதனால்தான், உங்கள் instance-ஐ எப்போதும் hostname மூலமாகவே அணுக வேண்டும் என்றும், வெறும் IP முகவரி மூலம் அணுகக்கூடாது என்றும் பாதுகாப்பு ஆலோசனைகள் வழங்கப்படுகின்றன. பொது IP வரம்புகள் தொடர்ந்து ஸ்கேன் செய்யப்படுகின்றன; IP முகவரியில் பதிலளிக்கும் ஒரு 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 தலைப்புகள் (headers) WebSocket handshake-ஐ /notifications/hub-க்குக் கொண்டு செல்கின்றன. இவற்றை நீக்கினால் vault வேலை செய்யும், ஆனால் WebSocket அறிவிப்புகள் browser மற்றும் desktop வாடிக்கையாளர்களைச் சென்றடையாது; mobile வாடிக்கையாளர்கள் தனித்தனியாக உள்ளமைக்கப்பட்ட 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-IP

IP_HEADER ஏற்கனவே X-Real-IP என இயல்புநிலையாக உள்ளது, எனவே proxy அந்தத் தலைப்பைச் சரியாக அமைப்பதை உறுதி செய்வது மட்டுமே உங்கள் வேலை. Vaultwarden, IP_HEADER_TRUSTED_PROXIES-ல் பட்டியலிடப்பட்ட முகவரிகளிலிருந்து மட்டுமே இந்தத் தலைப்பை ஏற்கும். இதன் இயல்புநிலை local ஆகும்: இது எந்தவொரு non-global முகவரியையும் குறிக்கும், இது ஒரே host அல்லது ஒரே container network-ல் உள்ள proxy-க்கு பொருந்தும். பொது முகவரியிலிருந்து இணையும் ஒரு proxy-ஐ அங்கு சேர்க்க வேண்டும். தலைப்பு விடுபட்டாலோ அல்லது நம்பகத்தன்மையற்ற முகவரியிலிருந்து வந்தாலோ, ஒவ்வொரு log வரியும் மற்றும் ஒவ்வொரு login rate limit-ம் proxy-ன் சொந்த முகவரியையே பார்க்கும். இதன் பொருள், ஒரு தாக்குதல் நடத்துபவரின் தோல்விகள் அந்த instance-ல் உள்ள அனைத்து பயனர்களுக்கும் எதிராகக் கணக்கிடப்படும். நீங்கள் IP_HEADER=X-Forwarded-For-ஐப் பயன்படுத்தினால், 1.37.4 பதிப்பானது நம்பகமான proxy அல்லாத வலதுபுற முகவரியை எடுத்துக்கொள்ளும், எனவே nginx-க்கு முன்னால் உள்ள CDN உட்பட சங்கிலியில் உள்ள ஒவ்வொரு 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), அல்லது அந்த log-கள் உங்கள் கட்டுப்பாட்டில் இல்லாத இடங்களுக்கு அனுப்பப்படாமல் இருப்பதை உறுதி செய்யவும்.

Login endpoint-ல் brute force தாக்குதலைத் தடுத்தல்

Rate limits இயல்பாகவே செயல்பாட்டில் உள்ளன (LOGIN_RATELIMIT_SECONDS=60, LOGIN_RATELIMIT_MAX_BURST=10). இவை தாக்குதல் நடத்துபவரின் வேகத்தைக் குறைக்கும், ஆனால் முழுமையாகத் தடுக்காது. fail2ban இதைச் சிறப்பாகச் செய்யும், ஆனால் அதற்கு Vaultwarden-ன் தோல்வியுற்ற login முயற்சிகளைப் படிக்கக்கூடிய ஒரு கோப்பு தேவை. Docker-ல் இதற்கான எளிய வழி ஒரு log கோப்பைப் பயன்படுத்துவதாகும், ஆனால் Vaultwarden இயல்பாகவே log கோப்பை உருவாக்குவதில்லை:

LOG_FILE=/data/vaultwarden.log
LOG_LEVEL=info
EXTENDED_LOGGING=true

தோல்வியுற்ற கடவுச்சொல் முயற்சி பின்வரும் வடிவத்தில் ஒரு வரியை உருவாக்கும், உங்கள் filter இந்த string-ஐத்தான் கண்டறிய வேண்டும்:

[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 = 14400

Vaultwarden ஒரு container-ஆக இல்லாமல் systemd service-ஆக இயங்கினால், நீங்கள் LOG_FILE-ஐத் தவிர்க்கலாம்: திட்டத்தின் fail2ban wiki-ல் கூறப்பட்டுள்ளபடி, logpath-க்கு பதிலாக journalmatch-ஐப் பயன்படுத்தி, backend = systemd மூலம் journal-ஐப் படிக்கலாம்.

நீங்கள் admin பக்கத்தை வைத்திருந்தால், ^.*Invalid admin token\. IP: <ADDR>.*$-ஐ failregex-ஆகக் கொண்ட இரண்டாவது jail-ஐச் சேர்க்கவும். ஏனெனில், admin தோல்விகள் வேறுபட்ட செய்தியுடன் log செய்யப்படுகின்றன, அவற்றை login filter கண்டறிய முடியாது. பின்னர் உங்கள் பணியைச் சரிபார்க்கவும்:

sudo systemctl restart fail2ban
sudo fail2ban-client status vaultwarden

சரியாகச் செயல்படும் jail, உங்கள் log கோப்பை File list-ன் கீழ் பட்டியலிட்டு, Currently failed: 0-ஐக் காட்டும். வேறொரு network-லிருந்து தவறான கடவுச்சொல்லை மூன்று முறை உள்ளிடவும்; அப்போது counter உயரும், பின்னர் அந்த முகவரி Banned IP list-ன் கீழ் தோன்றும். counter உயரவில்லை என்றால், அதற்கு வழக்கமான காரணம் logpath ஆகும்: இது container-க்குள் இருக்கும் /data/... பாதையாக இருக்கக்கூடாது, host-ல் உள்ள கோப்பின் பாதையாகவே இருக்க வேண்டும். இரண்டாவது பொதுவான காரணம், X-Real-IP விடுபட்டிருப்பது அல்லது நம்பகத்தன்மையற்றதாக இருப்பது; இது ஒவ்வொரு தடையையும் உங்கள் proxy-ஐயே குறிவைக்கச் செய்யும். நீங்கள் ஏற்கனவே இயக்கி இருக்க வேண்டிய SSH jail உட்பட, மீதமுள்ள அமைப்புகள் Ubuntu 24.04-க்கான fail2ban வழிகாட்டியில் உள்ளன.

Master password-தான் முழு அமைப்பின் பாதுகாப்பு

Client-side encryption என்பது, பயனர் வைத்திருக்கும் symmetric key-ஐ master password பாதுகாக்கிறது என்று பொருள். ஒரு attacker database-ஐ நகல் எடுத்துவிட்டால், அதில் உள்ள குறுகிய master password-ஐ எதாலும் பாதுகாக்க முடியாது. ஏனெனில், அவர்கள் அந்த நகலைத் தங்கள் சொந்த வன்பொருளைப் பயன்படுத்தி offline-ல் எவ்வளவு வேகமாக வேண்டுமானாலும் crack செய்ய முடியும். எந்தவொரு server அமைப்பும் attacker-ன் சொந்த கணினியைச் சென்றடையாது.

PASSWORD_ITERATIONS=600000-ஐத் தவறாகப் புரிந்துகொள்வது எளிது. இது client அனுப்பும் login hash-க்கு server-ல் செய்யப்படும் hash iterations-ஐ மட்டுமே தீர்மானிக்கிறது. திட்டத்தின் configuration template-ன் படி, மாற்றப்பட்ட மதிப்பு பயனர் அடுத்த முறை login செய்யும்போது அமலுக்கு வரும். இது client-side KDF-ஐ மாற்றாது; vault-க்கு எதிரான offline தாக்குதலின் கடினத்தன்மையை முடிவு செய்வது இந்த KDF அமைப்புகள்தான். இது ஒவ்வொரு கணக்கிற்கும் தனிப்பட்டது. இதை web vault-ல் உள்ள Settings, Security, Keys பகுதிக்குச் சென்று மாற்ற வேண்டும்; இது key-ஐ மீண்டும் encrypt செய்யும். Bitwarden ஆவணங்களின்படி, 2026.2.1 பதிப்பிற்குப் பிந்தைய அதன் clients, 600,000 iterations-க்குக் குறைவாக உள்ள PBKDF2 அமைப்புகளை பயனர் login செய்யும்போது அல்லது master password மூலம் unlock செய்யும்போது தானாகவே உயர்த்துகின்றன. 10 October 2026 நிலவரப்படி, இந்தச் செயல்பாடு Vaultwarden server-ல் உறுதிப்படுத்தப்படவில்லை, மேலும் இது Argon2id அமைப்புகளை ஒருபோதும் மாற்றாது. எனவே, பல ஆண்டுகளுக்கு முன்பு கணக்கு தொடங்கியவர்கள் இன்னும் பழைய, குறைவான KDF அமைப்பிலேயே இருக்கலாம். இதைச் சரிபார்த்து அவர்களுக்குத் தெரிவிக்கவும், ஏனெனில் server-ஆல் இதை அவர்களுக்காகச் செய்ய முடியாது.

அதன்பிறகு, ஒவ்வொரு கணக்கிற்கும் two-factor authentication-ஐ இயக்கவும். இது ciphertext-ஐப் பாதுகாக்காது, ஏனெனில் இது vault encryption-ல் பங்கேற்பதில்லை. ஆனால், திருடப்பட்ட password மட்டும் login செய்து நகலை sync செய்வதற்குப் போதுமானதாக இருக்காது என்பதை இது உறுதி செய்கிறது. Email அமைக்கப்பட்டிருந்தால், REQUIRE_DEVICE_EMAIL=true புதிய சாதனத்தில் login செய்வதற்கான மின்னஞ்சலை கட்டாயமாக்குகிறது: மின்னஞ்சல் அனுப்பத் தவறினால், login தோல்வியடையும். Mail service முற்றிலும் முடக்கப்பட்டிருந்தால், இந்த அமைப்பு புதிய சாதனத்தில் login செய்வதைத் தடுக்காது.

Backups-ல் தான் self-hosted vaults தவறு செய்கின்றன

அதே VPS-ல் உள்ள home directory-ல் வைக்கப்படும் தரவு கோப்புறையின் tar czf, மேலே செய்த அனைத்து பாதுகாப்பு நடவடிக்கைகளையும் பயனற்றதாக்கிவிடும். அந்த archive-ல் ஒவ்வொரு பயனரின் ciphertext-உம் உள்ள db.sqlite3, login sessions-ஐ உருவாக்க உதவும் rsa_key.pem, மற்றும் admin token மதிப்பு மற்றும் SMTP password உள்ள config.json ஆகியவை இருக்கும். Argon2 வழிமுறைகளைப் பின்பற்றுவது admin password-ன் hash-ஐ மட்டுமே சேமிக்கும்; ஆனால் SMTP password plaintext-ஆகவே இருக்கும். அந்த ஒரு கோப்பை அணுக முடிந்தால், account metadata, server secrets மற்றும் encrypted vault தரவுகள் அனைத்தும் வெளிப்பட்டுவிடும்.

இதற்கு இரண்டு விதிகள் உள்ளன. Archive-ஐ அந்த server-லிருந்து வெளியே எடுத்துவிடவும். வெளியேற்றும் முன்பே அதை encrypt செய்யவும்.

இதில் துல்லியத்தன்மை சார்ந்த ஒரு சிக்கலும் உள்ளது. Service இயங்கிக்கொண்டிருக்கும்போது cp மூலம் db.sqlite3-ஐ நகலெடுத்தால், அது முழுமையடையாத கோப்பாக மாறக்கூடும்; அதைத் திறக்க முடியாது. இதை restore செய்யும்போது மட்டுமே நீங்கள் அறிவீர்கள். அதற்குப் பதிலாக SQLite-ன் சொந்த snapshot வசதியைப் பயன்படுத்தவும்:

sqlite3 /vw-data/db.sqlite3 ".backup '/tmp/vw-db-backup.sqlite3'"

Restore செய்யும் முறை, அதாவது யாரும் சோதித்துப் பார்க்காத அந்தப் பகுதி, the Vaultwarden backup and restore guide-ல் விளக்கப்பட்டுள்ளது.

Hosted Bitwarden-க்கு மாற்றாக நீங்கள் எதை இழக்கிறீர்கள்

நேர்மையான கணக்கீடு. Bitwarden-ன் hosted சேவையை, அதை முழுநேர வேலையாகக் கொண்ட நிபுணர்கள் இயக்குகிறார்கள்; மேலும், அங்கீகரிக்கப்பட்ட மூன்றாம் தரப்பு தணிக்கைகளும் (audits) வெளியிடப்படுகின்றன. நீங்களே self-host செய்யும்போது, அந்தப் பொறுப்பு உங்கள் வசம் வருகிறது.

Vaultwarden பாதுகாப்புத் திருத்தங்களை (security fixes) சாதாரண releases-ஆக வெளியிடுகிறது, இவை அடிக்கடி வரும். திட்டத்தின் release feed-ஐ 2 November 2026 அன்று சரிபார்த்தபோது, தற்போதைய release 1.37.5 ஆகும், இது 1 November 2026 அன்று வெளியிடப்பட்டது. அதன் குறிப்புகள் இரண்டு Medium பாதுகாப்பு ஆலோசனைகளை உள்ளடக்கியுள்ளன, மேலும் அவற்றை உடனடியாக update செய்யுமாறு கடுமையாகப் பரிந்துரைக்கின்றன. two-step login முறைகளை இயக்க அல்லது முடக்க web vault 2026.7.1 அல்லது அதற்குப் புதிய பதிப்பும், emergency access மூலம் கணக்கைக் கையாள 2026.9.0 அல்லது அதற்குப் புதிய பதிப்பும் அவசியம். இதற்கு முந்தைய release, 1.37.4, 5 October 2026 அன்று வெளியிடப்பட்டது; இது ஏழு பாதுகாப்பு ஆலோசனைகளை உள்ளடக்கியது, அதில் மிகக் கடுமையானது High என மதிப்பிடப்பட்டது. 24 July 2026 அன்று வந்த 1.37.0-க்குப் பிறகு இது நான்காவது release ஆகும்: 1.37.1 ஜூலை 29-லும், 1.37.2 ஆகஸ்ட் 22-லும் (clients version 2026.8.0 மற்றும் அதற்குப் புதிய பதிப்புகளுக்குத் தேவை), 1.37.3 செப்டம்பர் 13-லும் வந்தன. 1.37.3 பதிப்பானது, credentials அல்லது 2FA மாறும்போது 2FA remember tokens-ஐ ரத்து செய்கிறது மற்றும் prelogin மற்றும் auth request endpoints-க்கு rate limit விதிக்கிறது. நீங்கள் முழுமையாக நம்பாத admins-ஐக் கொண்ட organisations-ஐ நிர்வகித்தால், update செய்த பிறகு ஒவ்வொரு organisation-ன் API key-ஐயும் மாற்றுமாறு 1.37.4 குறிப்புகள் பரிந்துரைக்கின்றன. 1.37.4 பதிப்பானது X-Forwarded-For-லிருந்து எந்த முகவரி வாசிக்கப்பட வேண்டும் என்பதையும் மாற்றுகிறது, இது மேலே உள்ள reverse proxy பகுதியில் விவரிக்கப்பட்டுள்ளது. நீங்கள் ஒரு வருடம் முன்பு அமைத்துவிட்டு மறந்த ஒரு instance, ஒரு வருடப் பழைய code-ஐ இயக்குகிறது. latest tag மட்டும் உதவாது: நீங்கள் docker compose pull-ஐ இயக்கி container-ஐ மீண்டும் உருவாக்கும் வரை, இயங்கும் container அது தொடங்கியபோது இருந்த image-ஐயே வைத்திருக்கும். host packages-க்காக Ubuntu-வில் unattended upgrades வசதியைச் செயல்படுத்தவும், container update-ஐ நீங்கள் தவறாமல் கவனிக்கும் ஒரு calendar reminder-ல் குறித்து வைக்கவும்.

ஒரு நேர்மையான வாசகர் எடுக்க வேண்டிய முடிவு: இங்குள்ள cryptography என்பது Bitwarden-ன் வடிவமைப்பு, அது பாதுகாப்பானது; ஆனால் செயல்பாட்டு ஆபத்து (operational risk) முழுமையாக உங்கள் வசம் மாறுகிறது. நீங்கள் அதைச் சரியாகப் patch செய்து, வேறொரு இடத்தில் backup எடுத்தால், உங்கள் கட்டுப்பாட்டில் உள்ள VPS-ல் இயங்கும் Vaultwarden instance உங்கள் கடவுச்சொற்களைச் சேமிக்க ஒரு தகுதியான இடமாகும். இந்த இரண்டு பழக்கங்களும் உங்களுக்குச் சாத்தியமில்லை என்றால், hosted சேவைக்குக் கட்டணம் செலுத்திவிட்டு, உங்கள் கவனத்தை வேறு விஷயங்களில் செலுத்துங்கள். அம்ச வாரியான ஒப்பீடு Vaultwarden மற்றும் self-hosted Bitwarden ஒப்பீடு பகுதியில் உள்ளது.

Container-க்கு அடியில் உள்ள host-ஐ பலப்படுத்துதல்

Vaultwarden என்பது Linux box-ல் இயங்கும் ஒரு process ஆகும். application எவ்வாறு கட்டமைக்கப்பட்டிருந்தாலும், அந்த box-ன் root பயனர் /vw-data-ஐ வாசிக்க முடியும். உங்கள் compose file-ல் user: "1000:1000"-ஐப் பயன்படுத்தி, container-ஐ privileged அல்லாத பயனராக இயக்கவும். இதற்கேற்ப data folder-ன் உரிமையையும் மாற்றவும். container எதையும் எழுதாத கோப்புகளை :ro மூலம் read-only முறையில் mount செய்யவும். அதன் பிறகு, முன் கதவை மூடவும்: SSH hardening on a VPS என்பது key-only login மற்றும் password authentication-ஐ முடக்குவது பற்றி விளக்குகிறது. மேலே உள்ள அனைத்தையும் மீறி வரும் சாதாரண தாக்குதல்களைத் தடுக்க இதுவே வழி.

FAQ

Vaultwarden database-ஐ யாராவது திருடினால், அவர்கள் எனது கடவுச்சொற்களைப் படிக்க முடியுமா?

நேரடியாக முடியாது. ஒவ்வொரு vault உருப்படியும் client-ல் ஒரு தற்செயலாக உருவாக்கப்பட்ட key மூலம் குறியாக்கம் (encrypt) செய்யப்படுகிறது; இது பயனர் அல்லது நிறுவனத்தின் symmetric key மூலம் பாதுகாக்கப்படுகிறது. பயனர் கடவுச்சொல்லிலிருந்து பெறப்பட்ட key, பயனரின் symmetric key-ஐப் பாதுகாக்கிறது. db.sqlite3-ல் குறியாக்கம் செய்யப்பட்ட vault உள்ளடக்கங்களும், அதனுடன் plain text வடிவிலான கணக்கு மெட்டாடேட்டாக்களும் உள்ளன. அவர்கள் உடனடியாகப் பெறுவது ஒவ்வொரு கணக்கின் மின்னஞ்சல் முகவரி, கடவுச்சொல் குறிப்பு (password hint), KDF அமைப்புகள், login மற்றும் device மெட்டாடேட்டா, மற்றும் twofactor அட்டவணையில் உள்ள login TOTP ரகசியங்கள் மட்டுமே. இவை குறியாக்கம் செய்யப்படாமல் சேமிக்கப்படுகின்றன, ஏனெனில் server எதிர்பார்க்கப்படும் குறியீட்டைக் கணக்கிட வேண்டும். அவர்கள் vault ciphertext-ஐத் தங்களுக்குத் தேவையான காலம் வரை offline-ல் வைத்துத் தாக்க முடியும் என்பதால், master password-ன் நீளமே பாதுகாப்பைத் தீர்மானிக்கும் முக்கிய காரணியாகும்.

நான் ADMIN_TOKEN-ஐப் பயன்படுத்த வேண்டுமா அல்லது admin பக்கத்தை முழுமையாக முடக்க வேண்டுமா?

உங்களால் முடிந்தால் அதை முடக்கிவிடுங்கள், ஏனெனில் பெரும்பாலான instances-க்கு SMTP-ஐ உள்ளமைக்கவும் பயனர்களை அழைக்கவும் மட்டுமே அது தேவைப்படுகிறது, அதன் பிறகு அது தேவைப்படுவதில்லை. அதை முடக்க, ADMIN_TOKEN அல்லது DISABLE_ADMIN_TOKEN ஆகிய இரண்டையும் அமைக்காதீர்கள், config.json-லிருந்து ஏதேனும் "admin_token" key இருந்தால் அதை நீக்கிவிட்டு, container-ஐ மீண்டும் உருவாக்குங்கள். environment variable-ஐ மட்டும் நீக்குவது போதாது, ஏனெனில் admin பக்கத்தால் எழுதப்பட்ட அமைப்புகள் config.json-ல் சேமிக்கப்பட்டு, முன்னுரிமை பெறுகின்றன. நீங்கள் அந்தப் பக்கத்தை வைத்திருந்தால், token-ஐ plain text random string-ஆக வைக்காமல், vaultwarden hash மூலம் உருவாக்கப்பட்ட Argon2 hash-ஆகச் சேமித்து, ADMIN_RATELIMIT_MAX_BURST=3-ஐ அமைக்கவும்.

எனது ADMIN_TOKEN சரியாக உள்ளது, ஆனால் /admin அதை நிராகரிக்கிறது. என்ன தவறு?

இது பெரும்பாலும் $ interpolation காரணமாகவே நிகழ்கிறது. ஒரு Argon2 PHC string பல $ எழுத்துகளைக் கொண்டுள்ளது. Docker Compose அவற்றை docker-compose.yml environment: தொகுதியின் உள்ளே variables-ஆக விரிவுபடுத்துவதால், உங்கள் கோப்பு சரியாகத் தெரிந்தாலும், container சிதைந்த மதிப்பையே பெறுகிறது. compose கோப்பில் உள்ள ஒவ்வொரு $-ஐயும் $$-ஆக மாற்றவும், அல்லது அந்த மதிப்பை ஒற்றை மேற்கோள் குறிகளுக்குள் (single quotes) உள்ள ஒரு .env கோப்பிற்கு மாற்றவும்; அங்கு escaping தேவையில்லை. அதன் பிறகு container-ஐ மீண்டும் உருவாக்குங்கள், ஏனெனில் restart செய்வதன் மூலம் environment மாற்றங்கள் எடுத்துக்கொள்ளப்படாது.

அறிவிப்புகளுக்கு (notifications) நான் இன்னும் port 3012-ஐத் திறக்க வேண்டுமா?

இல்லை. Vaultwarden 1.31.0 பதிப்பில் port 3012-ல் WebSocket traffic-க்கான ஆதரவு நீக்கப்பட்டுவிட்டது, ஏனெனில் அறிவிப்புகள் பிரதான HTTP port-க்கு மாற்றப்பட்டுவிட்டன. WEBSOCKET_ENABLED மற்றும் WEBSOCKET_PORT ஆகியவை 1.29.0 பதிப்பிலிருந்து deprecated செய்யப்பட்டுவிட்டன (அவை இன்னும் உள்ளன, ஆனால் கவனத்தில் கொள்ளப்படுவதில்லை). தற்போதைய அமைப்பு ENABLE_WEBSOCKET ஆகும், இது இயல்பாகவே true என இருக்கும். firewall-ல் 3012-ஐ மூடிவிட்டு, உங்கள் compose கோப்பிலிருந்து அதை நீக்கவும். பின்னர், உங்கள் reverse proxy Upgrade மற்றும் Connection headers-ஐ forward செய்வதை உறுதிப்படுத்தவும், ஏனெனில் browser மற்றும் desktop WebSocket அறிவிப்புகள் இவற்றைச் சார்ந்தே இயங்குகின்றன. மொபைல் clients தனித்தனியாக உள்ளமைக்கப்பட்ட push அறிவிப்புகளைப் பயன்படுத்துகின்றன.

இந்தக் கட்டுரை பயனுள்ளதாக இருந்ததா?