SSD Nodes Learn Hosting plans →
تعلیمی Matt Connorتحریر: Matt Connor

کیا Vaultwarden محفوظ ہے؟ سیکیورٹی کا مکمل جائزہ

Vaultwarden کلائنٹ سائیڈ انکرپشن استعمال کرتا ہے مگر میٹا ڈیٹا plaintext میں رکھتا ہے۔ اس کے سیکیورٹی رسک ایڈمن ٹوکن اور بیک اپ فائلز ہیں۔ جانیں اسے کیسے محفوظ بنائیں۔

کیا Vaultwarden محفوظ ہے؟ مختصر جواب

Vaultwarden اس ایک جگہ پر محفوظ ہے جو سب سے زیادہ اہمیت رکھتی ہے، کیونکہ ہر vault آئٹم سرور تک پہنچنے سے پہلے آپ کے ڈیوائس پر ہی انکرپٹ ہو جاتا ہے۔ سرور انکرپٹ شدہ vault کے مواد کو plaintext اکاؤنٹ میٹا ڈیٹا کے ساتھ اسٹور کرتا ہے۔ اگر کوئی پورے ڈیٹا بیس کی کاپی بھی کر لے، تب بھی اسے مواد پڑھنے کے لیے vault کی انکرپشن کیز درکار ہوں گی، لیکن اسے اکاؤنٹ کے ای میل ایڈریسز اور پاس ورڈ ہنٹس فوری طور پر مل جائیں گے۔

یہ جواب بہت سے پہلوؤں کا احاطہ کرتا ہے، اور جو حصے کمزور پڑتے ہیں وہ وہی ہیں جنہیں آپ خود configure کرتے ہیں۔ مثلاً ایک ایسا ایڈمن پینل جو آسانی سے اندازہ لگائے جانے والے ٹوکن کے پیچھے ہو، انٹرنیٹ پر پبلش کیا گیا کنٹینر پورٹ، plaintext config.json، یا اسی باکس کی ہوم ڈائریکٹری میں پڑا ہوا بیک اپ tarball۔ ان میں سے کوئی بھی کرپٹوگرافی کا مسئلہ نہیں ہے۔ یہ سب وہ وجوہات ہیں جن کی بنا پر self-hosted vaults خالی ہو جاتے ہیں۔

ذیل میں دی گئی ہر چیز ایک فعال انسٹالیشن کو فرض کرتی ہے۔ اگر آپ کے پاس ابھی تک انسٹالیشن موجود نہیں ہے، تو پہلے VPS کے لیے Vaultwarden انسٹالیشن گائیڈ کے ساتھ اسے سیٹ اپ کریں، اور پھر واپس آ کر اس فہرست پر ترتیب وار کام کریں۔

سرور اصل میں کیا اسٹور کرتا ہے

Vaultwarden، Bitwarden کے ڈیٹا ماڈل کو نافذ کرتا ہے۔ کسی بھی درخواست کے بھیجے جانے سے پہلے، کلائنٹ سائیڈ پر ایک رینڈم طریقے سے تیار کردہ آئٹم کی (item key) کے ذریعے والٹ آئٹم کا نام، صارف نام، پاس ورڈ، نوٹس اور URIs انکرپٹ کر دیے جاتے ہیں۔ اس کی (key) کو صارف یا آرگنائزیشن کی سمیٹرک کی (symmetric key) سے محفوظ کیا جاتا ہے؛ اور پاس ورڈ سے اخذ کردہ کی (password-derived key)، صارف کی سمیٹرک کی کو محفوظ رکھتی ہے۔ اٹیچمنٹ فائل کے مواد کے لیے ایک الگ اٹیچمنٹ کی (attachment key) استعمال ہوتی ہے جو آئٹم کی کے ذریعے محفوظ ہوتی ہے۔ سرور کو ایک UUID (universally unique identifier) کے ساتھ منسلک مبہم (opaque) ڈیٹا موصول ہوتا ہے۔

کچھ چیزیں سائفر ٹیکسٹ (ciphertext) نہیں ہوتیں، اور آپ کو معلوم ہونا چاہیے کہ وہ کیا ہیں:

  • آپ کا اکاؤنٹ ای میل ایڈریس اور ماسٹر پاس ورڈ ہنٹ، سادہ متن (plaintext) میں۔
  • آپ کی KDF (key derivation function) سیٹنگز اور سالٹ (salt)، کیونکہ کلائنٹ کو اگلی بار لاگ ان کرنے پر کی (key) دوبارہ بنانے کے لیے ان کی ضرورت ہوتی ہے۔
  • کلائنٹ کی طرف سے بھیجے گئے ماسٹر پاس ورڈ ہیش کا ایک سرور سائیڈ ہیش، جو لاگ ان کی تصدیق کے لیے استعمال ہوتا ہے۔
  • میٹا ڈیٹا: آرگنائزیشن کی رکنیت، ڈیوائس کے نام، آخری لاگ ان کے اوقات۔
  • مستند (authenticator) پر مبنی ٹو فیکٹر لاگ ان کے لیے TOTP سیکرٹ۔ یہ twofactor ٹیبل میں انکرپٹ ہوئے بغیر رہتا ہے، کیونکہ سرور کو آپ کے کوڈ کے ساتھ موازنہ کرنے کے لیے متوقع کوڈ خود کمپیوٹ کرنا ہوتا ہے۔ یہ اس TOTP (time-based one-time password) سیکرٹ سے مختلف ہے جسے آپ والٹ آئٹم کے اندر اسٹور کرتے ہیں، جو کسی بھی دوسرے فیلڈ کی طرح انکرپٹ ہوتا ہے۔

ڈیٹا فولڈر چھوٹا ہوتا ہے۔ Docker انسٹالیشن پر یہ وہی ہے جسے آپ نے /data پر ماؤنٹ کیا ہے۔

sudo ls -l /vw-data/

db.sqlite3 تقریباً تمام اسٹیٹ کو ہولڈ کرتا ہے۔ attachments/ ڈیٹا بیس ٹیبلز سے باہر، UUID ڈائریکٹریز کے تحت اپ لوڈ کردہ فائلیں رکھتا ہے۔ sends/ سینڈ (Send) اٹیچمنٹس کو رکھتا ہے اور یہ عارضی نوعیت کا ہوتا ہے۔ icon_cache/ کو ضائع کیا جا سکتا ہے۔ rsa_key.pem اور اس کے ساتھی لاگ ان صارفین کے JWTs (JSON web tokens) پر دستخط کرتے ہیں، لہذا اس پرائیویٹ کی (private key) کی ایک کاپی والٹ لاگ ان سیشن کو جعل سازی (forge) کرنے کے لیے استعمال کی جا سکتی ہے۔ config.json ایڈمن پیج کے ذریعے محفوظ کردہ سیٹنگز کو اسٹور کرتا ہے، بشمول سادہ متن میں SMTP اسناد اور کنفیگر کردہ ایڈمن ٹوکن کی ویلیو۔ نیچے دی گئی Argon2 ہدایات پر عمل کرنے سے سادہ متن والے پاس ورڈ کے بجائے ایڈمن ٹوکن کا ہیش اسٹور ہوتا ہے۔

لہذا، عملی خطرے کا ماڈل (threat model) فائل سسٹم تک رسائی ہے، نہ کہ نیٹ ورک کرپٹوگرافی۔ اس ایک ڈائریکٹری تک ریڈ (read) رسائی حاصل ہونے کا مطلب ہے ہر صارف کا ای میل ایڈریس، ان کے لاگ ان 2FA سیکرٹس، سیشنز کو جعل کرنے والی ایک کی (key)، اور ہر والٹ کی ایک آف لائن کاپی حاصل ہو جانا، جس پر اطمینان سے حملہ کیا جا سکتا ہے۔ نیچے دیے گئے ہر قدم کا مقصد لوگوں کو اس ڈائریکٹری سے دور رکھنا ہے۔

سب سے پہلے ایڈمن ٹوکن ٹھیک کریں

/admin ایک مکمل کنٹرول پینل ہے: صارف کی فہرست، دعوت نامے، ڈیلیٹ کرنے کے اختیارات، اور ہر رن ٹائم سیٹنگ۔ یہ ایک مشترکہ خفیہ کوڈ (shared secret) سے محفوظ ہے اور اس کے علاوہ کچھ نہیں۔ کوئی صارف نام نہیں۔ فی صارف کوئی ٹو-فیکٹر (2FA) نہیں۔

پرانی گائیڈز آپ کو openssl rand -base64 48 کے ساتھ ADMIN_TOKEN بنانے کا مشورہ دیتی ہیں۔ یہ کام تو کرتا ہے، لیکن جہاں بھی آپ اسے کنفیگر کرتے ہیں، وہاں یہ خفیہ کوڈ سادہ متن (plaintext) میں رہ جاتا ہے۔ Vaultwarden ایک Argon2 PHC (پاس ورڈ ہیشنگ کمپیٹیشن) سٹرنگ بھی قبول کرتا ہے، لہذا محفوظ شدہ قدر ایک ہیش ہوتی ہے۔ چلتے ہوئے کنٹینر کے اندر ایک ہیش بنائیں:

docker exec -it vaultwarden /vaultwarden hash

یا چلتے ہوئے کنٹینر کو چھوئے بغیر:

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 سٹرنگ $ کریکٹرز سے بھری ہوتی ہے، اور Docker Compose $ کو ویری ایبل انٹرپولیشن (variable interpolation) سمجھتا ہے۔ اگر آپ اسے بغیر اسکیپ (unescaped) کیے کسی 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 تین ایڈمن لاگ ان درخواستوں کی اجازت دیتا ہے، اور پھر ہر 5 منٹ میں ایک درخواست کی گنجائش بحال کرتا ہے۔ درست اور غلط دونوں پاس ورڈز اس میں شمار ہوتے ہیں، کیونکہ لمیٹر پاس ورڈ چیک ہونے سے پہلے کام کرتا ہے۔ حد سے زیادہ درخواستوں پر HTTP 429 ایرر اور Too many requests, try again later. موصول ہوتا ہے۔ ایڈمن سیشن لاگ ان کے 20 منٹ بعد ختم ہو جاتا ہے، چاہے آپ پینل استعمال کر رہے ہوں یا نہیں، کیونکہ سرگرمی اسے بڑھاتی نہیں ہے۔

اس سب سے بہتر طریقہ: اس صفحے کو بند کر دیں۔ زیادہ تر انسٹینسز کو اس کی ضرورت صرف ایک بار ہوتی ہے، SMTP کنفیگر کرنے اور پہلے صارفین کو مدعو کرنے کے لیے، اس کے بعد کبھی نہیں۔ اسے غیر فعال کرنے کے لیے، نہ تو ADMIN_TOKEN سیٹ کریں اور نہ ہی DISABLE_ADMIN_TOKEN، config.json سے کوئی بھی "admin_token" کی (key) ہٹا دیں، پھر کنٹینر کو دوبارہ بنائیں۔ فائل سے کی (key) کو ڈیلیٹ کرنا ضروری ہے کیونکہ ایڈمن صفحہ سیٹنگز وہیں لکھتا ہے، اور config.json میں موجود چیز انوائرمنٹ ویری ایبل پر فوقیت رکھتی ہے۔ صرف ویری ایبل ہٹانے سے صفحہ کھلا رہ سکتا ہے۔

رجسٹریشن بند کریں اس سے پہلے کہ کوئی ڈومین تلاش کر لے

SIGNUPS_ALLOWED=false
SIGNUPS_VERIFY=true
SHOW_PASSWORD_HINT=false

SIGNUPS_ALLOWED بائی ڈیفالٹ true پر ہوتا ہے۔ اسے اسی طرح رہنے دیں تو کوئی بھی آپ کے ڈومین پر پہنچ کر اکاؤنٹ بنا سکتا ہے، اور ان کا ڈیٹا آپ کے اپنے db.sqlite3 میں ہی محفوظ ہوگا۔ اسے false پر سیٹ کریں اور ایڈمن پیج سے دعوت نامے بھیج کر لوگوں کو شامل کریں؛ SMTP دعوت نامے کی ای میل پہنچاتا ہے، جبکہ اس کے بغیر سرور اس ایڈریس کے لیے دعوت نامہ ریکارڈ کر لیتا ہے۔ INVITATIONS_ALLOWED بھی بائی ڈیفالٹ true ہوتا ہے اور آرگنائزیشن ایڈمنز کو دوسروں کو مدعو کرنے کی اجازت دیتا ہے۔ جب آپ اپنے صارفین پر بھروسہ کرتے ہیں تو یہ ٹھیک ہے، اور سنگل یوزر انسٹینس پر اسے false ہونا چاہیے۔ اگر صرف مخصوص ڈومینز کو ہی رجسٹر ہونے کی اجازت دینی ہو، تو SIGNUPS_DOMAINS_WHITELIST=example.com اوپن سائن اپ سے زیادہ محدود ہے لیکن دعوت ناموں کے مقابلے میں بہت کمزور ہے۔

SHOW_PASSWORD_HINT بائی ڈیفالٹ false ہوتا ہے اور اسے وہیں رہنا چاہیے۔ اگر یہ آن ہو اور SMTP کنفیگر نہ ہو، تو لاگ ان فارم میں درست ای میل ایڈریس درج کرنے سے اس اکاؤنٹ کا ماسٹر پاس ورڈ ہنٹ ظاہر ہو جاتا ہے، جو ہنٹ کو لیک کرنے کے ساتھ ساتھ اس بات کی تصدیق بھی کرتا ہے کہ وہ ایڈریس موجود ہے۔

اگر آپ کا انسٹینس کچھ وقت کے لیے بھی اوپن سائن اپ کے ساتھ چلا ہے، تو ایڈمن پیج کھولیں اور یوزر لسٹ کو چیک کریں، یہ فرض کرنے سے پہلے کہ آپ ہی اس پر واحد اکاؤنٹ ہیں۔

وہ port جسے آپ publish کرنا نہیں چاہتے تھے

Docker image، container کے اندر port 80 پر listen کرتی ہے۔ Bare-metal install میں default port ROCKET_PORT=8000 ہے۔ دستاویزی run command اسے اس طرح publish کرتی ہے:

--publish 127.0.0.1:8000:80

127.0.0.1: prefix ہی اس configuration کا اصل مقصد ہے۔ اس کے بجائے -p 8000:80 لکھنے سے Docker 0.0.0.0 bind کرتا ہے، اور یہ کام nat table میں DNAT (destination network address translation) rules لکھ کر کیا جاتا ہے۔ ان rules کا جائزہ ufw کے زیرِ انتظام filter chains سے پہلے لیا جاتا ہے۔ اسی لیے ufw status port کو denied دکھاتا ہے، جبکہ وہ port انٹرنیٹ سے درخواستیں قبول کر رہا ہوتا ہے۔ مکمل طریقۂ کار Docker ports کے ufw کو bypass کرنے کی رہنمائی میں پڑھیں۔

حقیقت میں کون سا process listen کر رہا ہے، یہ چیک کریں:

sudo ss -tlnp | grep 8000

درست نتیجے میں 127.0.0.1:8000 پر bound ایک ہی line ہونی چاہیے۔ 0.0.0.0:8000 پر bound line کا مطلب ہے کہ vault براہِ راست exposed ہے۔ mapping درست کریں، پھر container دوبارہ بنائیں، کیونکہ port binding container بناتے وقت مقرر ہوتی ہے اور docker compose restart اسے تبدیل نہیں کرے گا:

docker compose up -d --force-recreate

پرانے guides میں ایک اور port بھی ملتا ہے: 3012، جو الگ WebSocket port تھا۔ Vaultwarden 1.31.0 میں اس کی support ختم کر دی گئی، کیونکہ notification traffic main HTTP port پر منتقل ہو گیا۔ WEBSOCKET_ENABLED اور WEBSOCKET_PORT کو 1.29.0 سے deprecated کیا جا چکا ہے اور انہیں نظرانداز کیا جاتا ہے۔ موجودہ switch ENABLE_WEBSOCKET ہے، جس کی default value true ہے۔ اگر آپ کا firewall یا compose file اب بھی 3012 کھولتا ہے تو اسے بند کر دیں۔

TLS کو Rocket کے بجائے reverse proxy پر terminate کریں

Vaultwarden اپنے web framework یعنی Rocket کے ذریعے خود TLS (transport layer security) فراہم کر سکتا ہے، لیکن پراجیکٹ کی ہدایت ہے کہ production میں ایسا نہ کیا جائے۔ Rocket کی بلٹ ان TLS میں سخت SNI (server name indication) سپورٹ کی کمی ہے، یہی وجہ ہے کہ سیکیورٹی کو سخت کرنے کے لیے یہ مشورہ دیا جاتا ہے کہ اپنی instance تک ہمیشہ hostname کے ذریعے پہنچیں، کبھی بھی براہ راست IP address استعمال نہ کریں۔ Public IP رینجز کو مسلسل اسکین کیا جاتا ہے، اور جو vault کسی IP address پر جواب دیتا ہے، وہ آسانی سے تلاش کر لیا جاتا ہے۔

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 تک ہوتی ہے، لہذا اگر اسے override نہ کیا جائے تو اس حد سے بڑی request bodies ناکام ہو جاتی ہیں۔ nginx کلائنٹ کو HTTP 413 واپس بھیجتا ہے اور client intended to send too large body: ... bytes لاگ کرتا ہے؛ مسترد شدہ اپ لوڈ Vaultwarden تک نہیں پہنچتی۔ Upgrade اور Connection ہیڈرز WebSocket ہینڈ شیک کو /notifications/hub تک پہنچاتے ہیں۔ اگر آپ انہیں ہٹا دیں تو vault کام تو کرے گا، لیکن WebSocket نوٹیفکیشنز براؤزر اور ڈیسک ٹاپ کلائنٹس تک پہنچنا بند ہو جائیں گے؛ موبائل کلائنٹس الگ سے کنفیگر شدہ push notifications استعمال کرتے ہیں۔

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 پر ڈیفالٹ ہوتا ہے، لہذا اصل کام یہ یقینی بنانا ہے کہ پراکسی درحقیقت یہ ہیڈر سیٹ کرے۔ Vaultwarden یہ ہیڈر صرف ان ایڈریسز سے قبول کرتا ہے جو IP_HEADER_TRUSTED_PROXIES میں درج ہوں، جس کی ڈیفالٹ ویلیو local ہے: یعنی کوئی بھی non-global ایڈریس، جس میں اسی ہوسٹ یا اسی کنٹینر نیٹ ورک پر موجود پراکسی شامل ہے۔ اگر پراکسی کسی public ایڈریس سے کنیکٹ ہوتی ہے تو اسے وہاں شامل کرنا ضروری ہے۔ اگر ہیڈر غائب ہو یا کسی غیر معتبر ایڈریس سے آئے، تو ہر لاگ لائن اور ہر لاگ ان ریٹ لمٹ پراکسی کا اپنا ایڈریس دیکھے گی، جس کا مطلب ہے کہ ایک حملہ آور کی ناکامیاں instance کے تمام صارفین کے کھاتے میں شمار ہوں گی۔ اگر آپ اس کے بجائے IP_HEADER=X-Forwarded-For استعمال کرتے ہیں، تو 1.37.4 ورژن سب سے دائیں جانب والا وہ ایڈریس لے گا جو trusted proxy نہیں ہے، لہذا چین میں موجود ہر پراکسی کو درج کریں، بشمول nginx کے آگے موجود CDN۔ DOMAIN کو بھی اصل https URL پر سیٹ کریں، کیونکہ Vaultwarden اسی سے دعوت نامے اور اکاؤنٹ ریکوری کے لنکس بناتا ہے، اور WebAuthn سیکیورٹی کیز اسی origin کے ساتھ منسلک ہوتی ہیں۔

ایک تفصیل جو لوگ نظر انداز کر دیتے ہیں: WebSocket کنکشن سیشن ٹوکن کو query string میں بطور /notifications/hub?access_token=[JWT] بھیجتا ہے۔ یہ آپ کے پراکسی ایکسس لاگ میں واضح (clear text) نظر آتا ہے۔ لاگ فارمیٹ میں access_token پیرامیٹر کو redact کریں، یا یقینی بنائیں کہ وہ لاگز کسی ایسی جگہ نہ بھیجے جائیں جہاں آپ کا کنٹرول نہ ہو۔

لاگ ان اینڈ پوائنٹ پر brute force کو روکنا

Rate limits پہلے سے فعال ہوتی ہیں (LOGIN_RATELIMIT_SECONDS=60، LOGIN_RATELIMIT_MAX_BURST=10)۔ یہ حملہ آور کی رفتار کم کرتی ہیں، لیکن اسے مکمل طور پر روکتی نہیں ہیں۔ fail2ban ایسا کر سکتا ہے، لیکن اسے Vaultwarden کی ناکام لاگ ان کوششوں تک رسائی درکار ہوتی ہے۔ Docker میں اس کا آسان طریقہ log file ہے، اور Vaultwarden بائی ڈیفالٹ کوئی log file نہیں بناتا:

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

پاس ورڈ کی ناکام کوشش اس شکل میں ایک لائن بناتی ہے، اور آپ کے filter کو اسی string کو match کرنا ہوگا:

[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 کنٹینر کے بجائے systemd سروس کے طور پر چل رہا ہو تو آپ LOG_FILE کو چھوڑ سکتے ہیں: پروجیکٹ کی fail2ban وکی میں backend = systemd اور Vaultwarden یونٹ پر journalmatch کا استعمال کرتے ہوئے logpath کی جگہ journal کو پڑھا جاتا ہے۔

اگر آپ نے ایڈمن پیج برقرار رکھا ہے، تو ایک دوسری jail شامل کریں جس کا failregex، ^.*Invalid admin token\. IP: <ADDR>.*$ ہو، کیونکہ ایڈمن کی ناکام کوششیں ایک مختلف پیغام کے ساتھ لاگ ہوتی ہیں اور لاگ ان فلٹر انہیں کبھی نہیں دیکھ پائے گا۔ پھر اپنے کام کی تصدیق کریں:

sudo systemctl restart fail2ban
sudo fail2ban-client status vaultwarden

ایک فعال jail آپ کی log file کو File list کے تحت لسٹ کرتی ہے اور Currently failed: 0 کی رپورٹ دیتی ہے۔ کسی دوسرے نیٹ ورک سے تین بار غلط پاس ورڈ درج کریں، کاؤنٹر بڑھ جائے گا، اور پھر وہ ایڈریس Banned IP list کے تحت ظاہر ہو جائے گا۔ اگر کاؤنٹر نہیں بڑھتا، تو اس کی عام وجہ logpath ہوتی ہے: یہ ہوسٹ پر فائل کا درست پاتھ ہونا چاہیے، نہ کہ کنٹینر کے اندر کا /data/... پاتھ۔ دوسری عام وجہ ایک غائب یا غیر معتبر X-Real-IP ہے، جس کی وجہ سے ہر پابندی آپ کے اپنے پراکسی کو نشانہ بناتی ہے۔ باقی سیٹ اپ، بشمول SSH jail جسے آپ کو پہلے سے چلانا چاہیے، Ubuntu 24.04 کے لیے fail2ban گائیڈ میں موجود ہے۔

ماسٹر پاس ورڈ اب بھی پورے سسٹم کی بنیاد ہے

کلائنٹ سائیڈ انکرپشن کا مطلب ہے کہ ماسٹر پاس ورڈ صارف کی سمیٹرک کی (symmetric key) کو محفوظ رکھتا ہے۔ اگر کسی حملہ آور نے ڈیٹا بیس کی کاپی حاصل کر لی ہو تو اس پوسٹ میں بیان کردہ کوئی بھی چیز مختصر ماسٹر پاس ورڈ کو تحفظ نہیں دیتی، کیونکہ حملہ آور اس کاپی پر آف لائن حملہ اپنی ہارڈویئر کی رفتار کے مطابق کر سکتا ہے۔ سرور کی کوئی بھی سیٹنگ حملہ آور کی اپنی مشین تک نہیں پہنچتی۔

PASSWORD_ITERATIONS=600000 کو غلط سمجھنا آسان ہے۔ یہ کلائنٹ کی طرف سے بھیجے گئے لاگ ان ہیش کے سرور سائیڈ ہیش کے لیے تکرار (iterations) کی تعداد طے کرتا ہے، اور پروجیکٹ کی کنفیگریشن ٹیمپلیٹ کے مطابق تبدیل شدہ ویلیو موجودہ صارفین پر ان کے اگلے لاگ ان کے وقت لاگو ہوتی ہے۔ یہ کلائنٹ سائیڈ KDF کو نہیں چھیڑتا، جو کہ وہ سیٹنگ ہے جس سے یہ طے ہوتا ہے کہ والٹ (vault) پر آف لائن حملہ کتنا مشکل ہوگا۔ یہ ہر اکاؤنٹ کی اپنی سیٹنگ ہے، اور اسے ویب والٹ میں Settings، Security، Keys کے تحت تبدیل کیا جاتا ہے، جو کی (key) کو دوبارہ انکرپٹ کرتا ہے۔ Bitwarden کی دستاویزات کے مطابق، 2026.2.1 کے بعد کے اس کے کلائنٹس 600,000 تکرار سے کم والی PBKDF2 سیٹنگ کو خودکار طور پر بڑھا دیتے ہیں جب صارف ماسٹر پاس ورڈ کے ساتھ لاگ ان یا ان لاک کرتا ہے۔ 10 اکتوبر 2026 تک، اس رویے کی Vaultwarden سرور پر تصدیق نہیں ہوئی ہے، اور یہ Argon2id سیٹنگز کو کبھی تبدیل نہیں کرتا۔ لہذا، جس نے برسوں پہلے سائن اپ کیا ہو، وہ اب بھی پرانی اور کم KDF سیٹنگ پر ہو سکتا ہے۔ اسے چیک کریں اور صارف کو بتائیں، کیونکہ سرور خود یہ کام نہیں کر سکتا۔

اس کے بعد ہر اکاؤنٹ کے لیے ٹو فیکٹر آتھنٹیکیشن (two-factor authentication) فعال کریں۔ یہ سائفر ٹیکسٹ (ciphertext) کو محفوظ نہیں کرتا، کیونکہ یہ والٹ انکرپشن میں شامل نہیں ہوتا۔ البتہ، یہ چوری شدہ پاس ورڈ کو لاگ ان کرنے اور کاپی سنک کرنے کے لیے کافی ہونے سے روکتا ہے۔ اگر ای میل کنفیگرڈ ہو تو REQUIRE_DEVICE_EMAIL=true نئے ڈیوائس کے لاگ ان ای میل کو لازمی بناتا ہے: اگر ای میل بھیجنا ناکام ہو جائے تو لاگ ان بھی ناکام ہو جاتا ہے۔ اگر میل سروس مکمل طور پر غیر فعال ہو، تو یہ سیٹنگ نئے ڈیوائس کے لاگ ان کو نہیں روکتی۔

بیک اپ وہ جگہ ہے جہاں self-hosted والٹس ناکام ہو جاتے ہیں

ڈیٹا فولڈر کا ایک tar czf، جسے اسی VPS پر ہوم ڈائریکٹری میں چھوڑ دیا جائے، اوپر اٹھائے گئے ہر قدم کو بے اثر کر دیتا ہے۔ اس آرکائیو میں db.sqlite3 موجود ہوتا ہے جس میں ہر صارف کا ciphertext ہوتا ہے، rsa_key.pem جو لاگ ان سیشنز کو جعلی بنا سکتا ہے، اور config.json جس میں کنفیگر شدہ ایڈمن ٹوکن ویلیو اور SMTP پاس ورڈ ہوتا ہے۔ Argon2 کی ہدایات پر عمل کرنے سے ایڈمن پاس ورڈ کا ہیش محفوظ ہوتا ہے؛ لیکن SMTP پاس ورڈ plaintext میں رہتا ہے۔ اس ایک فائل تک ریڈ ایکسس اکاؤنٹ میٹا ڈیٹا، سرور کے خفیہ راز اور انکرپٹڈ والٹ ڈیٹا کو ظاہر کر دیتی ہے۔

اس کے لیے دو اصول ہیں۔ آرکائیو کو سرور سے باہر منتقل کریں۔ اسے سرور سے باہر بھیجنے سے پہلے انکرپٹ کریں۔

یہاں درستگی کا ایک مسئلہ بھی ہے۔ سروس چلتے ہوئے cp کے ساتھ db.sqlite3 کو کاپی کرنے سے ایسی فائل بن سکتی ہے جو لکھے جانے کے عمل کے دوران ہو اور کھلے گی نہیں، اور آپ کو اس کا علم بحالی (restore) کے وقت تک نہیں ہوگا۔ اس کے بجائے SQLite کا اپنا اسنیپ شاٹ استعمال کریں:

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

بحالی کا مرحلہ، جسے کوئی بھی ٹیسٹ نہیں کرتا، Vaultwarden بیک اپ اور بحالی کی گائیڈ میں بیان کیا گیا ہے۔

Hosted Bitwarden کے مقابلے میں آپ کیا کھوتے ہیں

ایماندارانہ جائزہ۔ Bitwarden کی hosted سروس ایسے لوگ چلاتے ہیں جن کا کل وقتی کام ہی اسے چلانا ہے، اور اس کے تیسرے فریق (third-party) سے کروائے گئے آڈٹ بھی شائع ہوتے ہیں۔ Self-hosting میں آپ یہ سہولت چھوڑ کر اپنی پیچنگ (patching) کی ذمہ داری خود اٹھاتے ہیں۔

Vaultwarden سیکیورٹی فکسز کو عام releases کے طور پر جاری کرتا ہے، اور یہ اکثر آتے ہیں۔ 2 نومبر 2026 کو پروجیکٹ کی release feed پر چیک کرنے کے مطابق، موجودہ release 1.37.5 ہے، جو 1 نومبر 2026 کو شائع ہوئی۔ اس کے نوٹس میں دو Medium سیکیورٹی ایڈوائزریز شامل ہیں اور جلد از جلد اپ ڈیٹ کرنے کا مشورہ دیا گیا ہے۔ web vault 2026.7.1 اور اس سے نئے ورژنز کے لیے ٹو-اسٹیپ لاگ ان طریقوں کو آن یا آف کرنے کے لیے، اور 2026.9.0 اور اس سے نئے ورژنز کے لیے ایمرجنسی ایکسس کے ذریعے اکاؤنٹ سنبھالنے کے لیے یہ اپ ڈیٹ ضروری ہے۔ پچھلی release، 1.37.4، جو 5 اکتوبر 2026 کو شائع ہوئی، اس میں سات سیکیورٹی ایڈوائزریز شامل تھیں، جن میں سب سے سنگین کا درجہ High تھا۔ یہ 24 جولائی 2026 کو آنے والی 1.37.0 کے بعد چوتھی release تھی: 1.37.1 اس کے بعد 29 جولائی کو، 1.37.2، 22 اگست کو (جو کلائنٹس ورژن 2026.8.0 اور اس سے نئے کے لیے ضروری تھی)، اور 1.37.3، 13 ستمبر کو آئی، جس نے اسناد (credentials) یا 2FA تبدیل ہونے پر 2FA ریمیمبر ٹوکنز کو منسوخ کیا اور prelogin اور auth request اینڈ پوائنٹس پر ریٹ لمٹ لگائی۔ اگر آپ ایسی تنظیمیں چلاتے ہیں جن کے ایڈمنز پر آپ مکمل بھروسہ نہیں کرتے، تو 1.37.4 کے نوٹس اپ ڈیٹ کے بعد ہر تنظیم کی API key کو تبدیل (rotate) کرنے کا مشورہ بھی دیتے ہیں۔ 1.37.4 اس پتے کو بھی تبدیل کرتی ہے جو X-Forwarded-For سے پڑھا جاتا ہے، جس کا احاطہ اوپر reverse proxy سیکشن میں کیا گیا ہے۔ ایک instance جسے آپ نے ایک سال پہلے سیٹ اپ کیا اور بھول گئے، وہ ایک سال پرانا کوڈ چلا رہا ہے۔ latest ٹیگ اکیلے مدد نہیں کرتا: ایک چلتا ہوا کنٹینر اسی image کو برقرار رکھتا ہے جس سے وہ شروع ہوا تھا جب تک کہ آپ docker compose pull نہ چلائیں اور اسے دوبارہ نہ بنائیں۔ host پیکیجز کے لیے Ubuntu پر unattended upgrades کو نافذ کریں، اور کنٹینر اپ ڈیٹ کو ایسے کیلنڈر ریمائنڈر پر رکھیں جسے آپ واقعی پڑھیں گے۔

ایک ایماندار قاری کو یہ نتیجہ اخذ کرنا چاہیے: یہاں استعمال ہونے والی کرپٹوگرافی Bitwarden کا ڈیزائن ہے اور یہ مضبوط ہے، جبکہ آپریشنل رسک مکمل طور پر آپ پر منتقل ہو جاتا ہے۔ اگر آپ اسے پیچ کرتے ہیں اور اس کا بیک اپ کہیں اور رکھتے ہیں، تو آپ کے کنٹرول میں موجود VPS پر Vaultwarden کا instance آپ کے پاس ورڈز رکھنے کے لیے ایک مناسب جگہ ہے۔ اگر یہ دونوں عادات آپ نہیں اپنا سکتے، تو hosted سروس کے لیے ادائیگی کریں اور اپنی توجہ کہیں اور لگائیں۔ فیچر بہ فیچر موازنہ Vaultwarden کا self-hosted Bitwarden کے ساتھ موازنہ میں موجود ہے۔

کنٹینر کے نیچے موجود ہوسٹ کو محفوظ بنانا

Vaultwarden لینکس باکس پر ایک عمل (process) ہے، اور اس باکس پر موجود root صارف /vw-data کو پڑھ سکتا ہے، قطع نظر اس کے کہ ایپلیکیشن کی کنفیگریشن کیا ہے۔ کنٹینر کو ایک غیر مراعات یافتہ (unprivileged) صارف کے طور پر چلائیں، جس کے لیے اپنی compose فائل میں user: "1000:1000" کا استعمال کریں، ڈیٹا فولڈر کی ملکیت کو اس کے مطابق سیٹ کریں، اور جو کچھ کنٹینر لکھتا نہیں ہے اسے :ro کے ساتھ صرف پڑھنے کے لیے (read-only) ماؤنٹ کریں۔ اس کے بعد مرکزی دروازہ بند کریں: VPS پر SSH کو محفوظ بنانا میں صرف کی (key-only) لاگ ان اور پاس ورڈ تصدیق کو غیر فعال کرنے کا طریقہ بیان کیا گیا ہے، جو ان عام حملوں کو روکتا ہے جو مذکورہ بالا تمام حفاظتی اقدامات سے بچ نکلتے ہیں۔

FAQ

کیا کوئی Vaultwarden ڈیٹا بیس چوری ہونے پر میرے پاس ورڈز پڑھ سکتا ہے؟

براہ راست نہیں۔ ہر والٹ آئٹم کلائنٹ سائیڈ پر ایک تصادفی طور پر تیار کردہ کلید سے انکرپٹ ہوتا ہے، جو صارف یا آرگنائزیشن کی سمیٹرک کلید کے ذریعے محفوظ ہوتی ہے۔ پاس ورڈ سے اخذ کردہ کلید صارف کی سمیٹرک کلید کی حفاظت کرتی ہے۔ db.sqlite3 میں انکرپٹ شدہ والٹ مواد کے ساتھ ساتھ اکاؤنٹ کا پلین ٹیکسٹ میٹا ڈیٹا موجود ہوتا ہے۔ حملہ آور کو فوری طور پر ہر اکاؤنٹ کا ای میل ایڈریس، پاس ورڈ ہنٹ، KDF سیٹنگز، لاگ ان اور ڈیوائس کا میٹا ڈیٹا، اور twofactor ٹیبل میں موجود لاگ ان TOTP سیکریٹس مل جاتے ہیں، جو انکرپٹڈ نہیں ہوتے کیونکہ سرور کو متوقع کوڈ کا حساب لگانا ہوتا ہے۔ وہ والٹ کے سائفر ٹیکسٹ پر آف لائن جتنا چاہیں حملہ کر سکتے ہیں، اسی لیے ماسٹر پاس ورڈ کی لمبائی ہی وہ عدد ہے جو نتیجے کا تعین کرتی ہے۔

کیا مجھے 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 کے بعد سے ڈیپریکیٹ کر دیا گیا ہے اور انہیں نظر انداز کر دیا جاتا ہے۔ موجودہ سیٹنگ ENABLE_WEBSOCKET ہے، جو بائی ڈیفالٹ true ہوتی ہے۔ فائر وال میں 3012 کو بند کر دیں اور اسے اپنی کمپوز فائل سے حذف کر دیں، پھر یقینی بنائیں کہ آپ کا ریورس پراکسی Upgrade اور Connection ہیڈرز کو فارورڈ کر رہا ہے، کیونکہ براؤزر اور ڈیسک ٹاپ WebSocket نوٹیفکیشنز ان پر انحصار کرتے ہیں۔ موبائل کلائنٹس الگ سے کنفیگر شدہ پش نوٹیفکیشنز استعمال کرتے ہیں۔

کیا یہ مضمون مفید تھا؟