لنفرض أن لديك مجموعة عيادات أسنان صغيرة بثلاثة فروع، ومهندساً واحداً يعمل معكم بدوام جزئي، وعلى سيرفر واحد أداتان كتبهما مطور سابق: جدول المناوبات والتعليمات الذي يفتحه كل الموظفين كل صباح، ولوحة إدارة الحجوزات التي فيها أسماء المرضى وأرقامهم ومواعيدهم، ولا يجب أن يفتحها إلا مدير العمليات ومساعدته. والأداة الأولى بلا حسابات أصلاً، فمن يعرف الرابط يفتحها، والثانية بكلمة مرور واحدة مكتوبة على ورقة في مكتب الاستقبال، وقد استخدمها موظف استقبال سابق بعد مغادرته بأسبوعين ليبحث عن رقم مريضة، ولم يعرف أحد ذلك إلا بالصدفة. وفي دليل كل الطرق لحماية صفحة أو أداة داخلية رأينا أن أفضل درجة لهذه الحالة هي Proxy يعرف هوية المستخدم عبر Forward Auth، وجربنا ذلك هناك مع Authelia بقاعدة واحدة وعامل واحد.
وفي هذا الدليل سوف نكمل الطريق مع العيادات خطوة خطوة: نثبت Authelia كما يثبت في بيئة الإنتاج Production، ونضع خلفه الأداتين بسياستين مختلفتين، ونفرض على لوحة الحجوزات المصادقة الثنائية 2FA برمز TOTP، ثم نجرب ما حدث فعلاً في مختبرنا عندما أضفنا قاعدة «للتسهيل»، وعندما أرسل طلب ترويسات مزورة، وعندما ترك موظف الشاشة مفتوحة وذهب إلى مريض.
وسوف نناقش في هذا المقال ما يلي:
- ما هو Authelia، وما الذي يميزه عن مزودات الهوية الكبيرة، ومتى لا يناسبك.
- كيف يعمل Forward Auth من الداخل: الطلب الفرعي، والترويسات التي يقرؤها Authelia، والردود الثلاثة.
- تثبيته مع Redis وCaddy باستخدام Docker Compose، والأسرار Secrets في ملفات منفصلة.
- قواعد الوصول Access Control: عامل واحد للفريق، وعاملان للإدارة، والرفض لكل ما عدا ذلك، وتجربة القاعدة الواسعة التي فتحت لوحة الحجوزات.
- ترويسات Remote-User: تجربة طلب مزور وصل إلى التطبيق، وكيف أغلقناه.
- تسجيل جهاز TOTP خطوة خطوة، ولماذا يطلب Authelia رمزاً يصل بالبريد قبل ذلك.
- الحماية من التخمين Regulation، والجلسات Sessions ومؤقتاتها، والعربية في الواجهة.
- الموارد المقيسة، والنسخ الاحتياطي والاستعادة، والتحديث، والمشكلات الشائعة، وقائمة تحقق قبل الإطلاق.
وإذا كنت تقارن بين الأدوات فهذه الأدلة تشرح البدائل والمفاهيم التي نبني عليها:
دليلكل الطرق لحماية صفحة أو أداة داخليةمن إخفاء الأداة عن الإنترنت إلى تسجيل الدخول داخلها، متى تكفي كل طريقة، وأين تفشل، وكيف تجمع بينها.
دليلكيف تحمي أي تطبيق ويب بصفحة دخول authentik عبر Forward Authكيف تضع صفحة دخول authentik مع المصادقة الثنائية أمام أي أداة داخلية دون أن تعدل في التطبيق نفسه.
دليلتثبيت Keycloak مزود الهوية IdP الأشهر في المؤسساتنثبت Keycloak مع PostgreSQL، ونربط به تطبيقاً عبر OIDC، ونفرض المصادقة الثنائية على الجميع، ونقيس ما يحتاجه من ذاكرة.
دليلالدخول دون كلمة مرور: شرح Passkeys وWebAuthnلماذا لا تحميك رموز SMS وTOTP من التصيد الحديث، وكيف تحل Passkeys المشكلة بمفتاح خاص لا يغادر جهازك.ما هو Authelia؟
Authelia خادم مصادقة Authentication Server مكتوب بلغة Go، برخصة Apache 2.0، ويعمل في Container واحد حجم الـ Image فيه 110 MB. ووظيفته الأساسية أن يجيب الـ Reverse Proxy عن سؤال واحد في كل طلب: هل يسمح لهذا الطلب بالمرور أم لا؟ فإذا كانت للمتصفح جلسة صالحة وتسمح القواعد بالطلب مرره الـ Proxy إلى التطبيق ومعه اسم المستخدم ومجموعاته في ترويسات Headers، وإلا حوله إلى بوابة الدخول، وهذا ما يسمى Forward Auth. ويستطيع Authelia أيضاً أن يعمل مزود OpenID Connect للتطبيقات التي تدعمه، ولكن قوته الحقيقية في الحماية عبر الـ Proxy.
والفرق بينه وبين authentik أو Keycloak أنه لا يملك لوحة إدارة للمستخدمين، فالمستخدمون في ملف YAML أو في LDAP، والقواعد في ملف إعداد، وكل تعديل يمر عبر ملف تحفظه في Git. وهذا مناسب جداً لمن يدير سيرفراته بالملفات، وغير مناسب إطلاقاً لمؤسسة تريد أن يضيف موظف الموارد البشرية الحسابات من المتصفح.
والمشروع نشط، فقد صدر منه 13 إصداراً في 2026 حتى الآن، وآخرها 4.39.28 في 17 سبتمبر 2026، ونشر في صفحة التنبيهات الأمنية ثلاثة تنبيهات في 2026 درجتها منخفضة ومتوسطة، آخرها في مايو عن قاعدة وصول قد لا تطابق النطاق في حالة حدية لأن الاسم لم يوحد Canonicalization.
والشكل التالي يبين ما يحدث في كل طلب إلى تطبيق محمي، والقواعد التي سوف نكتبها:

كيف يعمل Forward Auth من الداخل؟
قبل أن نثبت أي شيء يجب أن نفهم ما يحدث في كل طلب، والسبب أن كل خطأ رأيناه في المختبر لاحقاً يعود إلى نقطة في هذه السلسلة. عندما تفتح مساعدة مدير العمليات لوحة الحجوزات، لا يذهب طلبها إلى اللوحة مباشرة، وإنما يحدث ما يلي بالترتيب:
- يصل الطلب إلى Caddy على العنوان
admin.example.com، ومعه كوكي الجلسة إن كان موجوداً. - قبل أن يمرره Caddy إلى اللوحة، يرسل طلباً فرعياً Subrequest إلى Authelia على المسار
/api/authz/forward-auth، ويضيف إليه ترويسات تصف الطلب الأصلي:X-Forwarded-MethodوX-Forwarded-ProtoوX-Forwarded-HostوX-Forwarded-UriوX-Forwarded-For، ومعها الكوكي نفسه. - يبني Authelia من هذه الترويسات العنوان الكامل للطلب الأصلي، ويقرأ الجلسة من الكوكي، ثم يمر على القواعد بالترتيب حتى يجد أول قاعدة تطابق، ويقارن ما تطلبه القاعدة بما حققه المستخدم في جلسته.
- يرد Authelia بأحد ثلاثة: 200 ومعه ترويسات
Remote-UserوRemote-GroupsوRemote-EmailوRemote-Name، أو 302 إلى بوابة الدخول إذا لم توجد جلسة أو كان العامل الثاني ناقصاً، أو 403 إذا كانت القواعد ترفض هذا المستخدم. - إذا كان الرد 200 ينسخ Caddy الترويسات المذكورة في
copy_headersإلى الطلب الأصلي ويمرره إلى اللوحة، وإلا أعاد رد Authelia كما هو إلى المتصفح.
وفي هذه السلسلة ثلاث نقاط حساسة لاحظها من الآن: الأولى أن Authelia لا يرى الطلب الأصلي، وإنما يرى ما يقوله الـ Proxy عنه في ترويسات X-Forwarded-*، لذلك يجب أن تأتي هذه الترويسات من الـ Proxy وحده، ولا يكون Authelia مكشوفاً لأحد غيره. والثانية أن التطبيق يثق بترويسات Remote-* لأنه يظن أن الـ Proxy هو من كتبها، وسوف نرى في قسم مستقل ماذا يحدث عندما لا يكون ذلك صحيحاً. والثالثة أن كل طلب، حتى طلب صورة أو ملف CSS، يمر بهذه الخطوات الخمس، وهي سريعة لأن Authelia يقرأ الجلسة من Redis ولا يحسب أي هاش، ولكنها تعني أن توقف Authelia يوقف كل الأدوات التي خلفه.
ولكل Proxy مسار خاص به في Authelia، كما يشرح دليل التفويض عبر الـ Proxy: /api/authz/forward-auth لـ Caddy وTraefik، و/api/authz/auth-request لوحدة auth_request في Nginx، وهي التي استخدمناها في دليل الطرق السبع، و/api/authz/ext-authz لـ Envoy. والفرق بينها في شكل الطلب الفرعي والرد الذي ينتظره كل Proxy، أما القواعد والجلسات فواحدة.
المتطلبات
- سيرفر Linux صغير يكفي، فقد استهلك Authelia في حالة الخمول بين 60 و99 MiB من الذاكرة RAM، ووصل إلى 232 MiB بعد سلسلة من عمليات الدخول، والسبب أن هاش كلمات المرور argon2id يحجز 64 MiB في كل عملية تحقق، وأما Redis فاستهلك 6 MiB وCaddy أقل من 26 MiB.
- نطاق رئيسي Root Domain مثل
example.comتكون كل التطبيقات المحمية تحته، والسبب أن كوكي Cookie الجلسة يكتب على هذا النطاق حتى يراه كل تطبيق، وبالتالي لا يستطيع Authelia حماية تطبيقين على نطاقين مختلفين بنفس الجلسة. - بوابة الدخول على HTTPS دائماً، حيث يرفض Authelia أن يكون
authelia_urlبـ HTTP. - حساب SMTP، وهو هنا إلزامي فعلياً، والسبب أن Authelia يرسل رمزاً بالبريد قبل أن يسمح للمستخدم بتسجيل جهاز المصادقة، كما سيأتي.
وفي المختبر استخدمنا أسماء تحت lab.localhost، لأن المتصفحات توجه أي اسم ينتهي بـ .localhost إلى الجهاز نفسه، فلا نحتاج إلى DNS، واستخدمنا شهادة داخلية من Caddy عبر tls internal على المنفذ 18818.
التثبيت
الأسرار في ملفات منفصلة
يحتاج Authelia إلى ثلاثة أسرار: مفتاح الجلسات، ومفتاح تشفير قاعدة البيانات Storage Encryption Key الذي تشفر به أسرار TOTP، ومفتاح روابط استعادة كلمة المرور. ولا تكتبها في ملف الإعداد، وإنما في ملفات تقرؤها الحاوية عبر متغيرات تنتهي بـ _FILE، والسبب أن ملف الإعداد سوف تحفظه في Git وتشاركه، أما الأسرار فلا:
sudo mkdir -p /opt/authelia/{config,secrets}
cd /opt/authelia
for f in session_secret storage_encryption_key jwt_secret; do openssl rand -hex 32 > secrets/$f; done
chmod 600 secrets/*storage_encryption_key يستطيع أن يستخرج أسرار TOTP لكل المستخدمين بأمر واحد هو authelia storage user totp export uri، وقد فعلنا ذلك على نسخة احتياطية مستعادة فظهر رابط otpauth:// كاملاً. لذلك احفظ المفتاح بعيداً عن النسخة الاحتياطية Backup لقاعدة البيانات، وإذا فقدته فلن تفتح النسخة وسوف يعيد كل المستخدمين تسجيل أجهزتهم.ملف المستخدمين وهاش كلمات المرور
نولد هاش كلمة المرور بأداة Authelia نفسها، وهي تستخدم argon2id افتراضياً:
docker run --rm authelia/authelia:4.39.28 authelia crypto hash generate argon2 --password 'كلمة-مرور-قوية'Digest: $argon2id$v=19$m=65536,t=3,p=4$...ثم نضع الهاش في config/users.yml، وفيه مستخدمان: alice في مجموعتي admins وdev، وbob في dev فقط:
users:
alice:
displayname: 'Alice Admin'
password: '$argon2id$v=19$m=65536,t=3,p=4$...'
email: '[email protected]'
groups: ['admins', 'dev']
bob:
displayname: 'Bob Dev'
password: '$argon2id$v=19$m=65536,t=3,p=4$...'
email: '[email protected]'
groups: ['dev']ولاحظ أن القيم m=65536,t=3,p=4 تعني 64 MiB من الذاكرة وثلاث دورات وأربعة خيوط Threads لكل عملية تحقق، وهذا مقصود حتى يكون تخمين كلمات المرور مكلفاً على المخترق، ولكنه مكلف عليك أيضاً، فعلى سيرفر مشغول بأعمال أخرى وصل زمن الدخول الواحد إلى عدة ثوان في تجربتنا، لذلك لا تضع Authelia على سيرفر معالجه مشغول دائماً.
ثمن argon2id: لماذا ارتفعت الذاكرة بعد عمليات الدخول؟
لاحظنا في قسم الموارد أن Authelia كان في الخمول بين 60 و99 MiB، ثم وصل إلى 232 MiB بعد سلسلة من عمليات الدخول، والسبب في القيم التي رأيتها في الهاش: m=65536 تعني أن كل عملية تحقق من كلمة مرور تحجز 64 MiB من الذاكرة، وt=3 ثلاث دورات عليها، وp=4 أربعة خيوط. وهذا التصميم مقصود في توصيات Authelia لكلمات المرور، لأن المخترق الذي يسرق ملف المستخدمين يدفع نفس الثمن عند كل تخمين، فيصبح تخمين ملايين الكلمات على بطاقة رسوميات مكلفاً جداً. ولكن الوجه الآخر أن السيرفر يدفع هذا الثمن عند كل دخول حقيقي، فعشرون موظفاً يدخلون في نفس الدقيقة صباح الأحد يعني أكثر من 1 GB لحظياً، ومهاجم يرسل مئات طلبات الدخول في الثانية بأسماء مختلفة يستطيع أن يستهلك ذاكرة السيرفر، والسبب أن الحماية من التخمين في Authelia تحسب لكل مستخدم، ولا تمنع سيلاً من الأسماء المختلفة. لذلك لا تخفض قيم argon2id لتوفير الذاكرة، وإنما ضع أمام مسار الدخول /api/firstfactor حداً لعدد الطلبات Rate Limit في الـ Proxy، وضع حداً للذاكرة على الـ Container حتى لا يأخذ معه بقية الخدمات على السيرفر.
ملف الإعداد configuration.yml
server:
address: 'tcp://:9091/'
log:
level: 'info'
totp:
issuer: 'example.com'
authentication_backend:
file:
path: '/config/users.yml'
access_control:
default_policy: 'deny'
rules:
- domain: 'admin.lab.localhost'
subject: 'group:admins'
policy: 'two_factor'
- domain: 'app.lab.localhost'
subject:
- 'group:dev'
- 'group:admins'
policy: 'one_factor'
session:
redis:
host: 'redis'
port: 6379
cookies:
- domain: 'lab.localhost'
authelia_url: 'https://auth.lab.localhost:18818'
default_redirection_url: 'https://app.lab.localhost:18818'
regulation:
max_retries: 3
find_time: '2 minutes'
ban_time: '5 minutes'
storage:
local:
path: '/data/db.sqlite3'
notifier:
filesystem:
filename: '/data/notification.txt'في الإعداد أعلاه لاحظ التالي:
default_policy: 'deny'يرفض كل ما لم تذكره القواعد، وهذا هو الإعداد الصحيح الوحيد، والسبب أنك عندما تضيف تطبيقاً جديداً خلف الـ Proxy وتنسى قاعدته فسوف يرفض بدل أن يفتح للجميع. والقواعد تقرأ من الأعلى، وأول قاعدة تطابق الطلب هي التي تطبق.two_factorعلى لوحة الإدارة وone_factorعلى أداة الفريق، فلا تزعج الجميع برمز TOTP في كل مرة، وإنما تطلبه حيث يكون الضرر كبيراً.session.redisيحفظ الجلسات في Redis بدل ذاكرة Authelia، والتفصيل في قسم الجلسات.notifier.filesystemيكتب الرسائل في ملف بدل البريد، وهو للتجربة فقط، وفي بيئة الإنتاج تستخدم SMTP كما في القسم الخاص به.- التخزين في SQLite يكفي لنسخة واحدة من Authelia، فإذا أردت أكثر من نسخة فانتقل إلى PostgreSQL.
ملف docker-compose.yml
services:
authelia:
image: authelia/authelia:4.39.28
restart: unless-stopped
environment:
AUTHELIA_SESSION_SECRET_FILE: /secrets/session_secret
AUTHELIA_STORAGE_ENCRYPTION_KEY_FILE: /secrets/storage_encryption_key
AUTHELIA_IDENTITY_VALIDATION_RESET_PASSWORD_JWT_SECRET_FILE: /secrets/jwt_secret
volumes:
- ./config:/config
- ./secrets:/secrets:ro
- data:/data
redis:
image: redis:8.2.2-alpine
restart: unless-stopped
command: redis-server --save 60 1
volumes:
- redis:/data
caddy:
image: caddy:2.10.2-alpine
restart: unless-stopped
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
ports:
- "127.0.0.1:18818:443"
whoami:
image: node:22.23.4-alpine
restart: unless-stopped
command: node /app/server.js
volumes:
- ./whoami:/app:ro
volumes:
redis:
data:
caddy_data:ولاحظ أن Authelia لا ينشر أي منفذ، فلا يصل إليه أحد إلا عبر Caddy، وأن الـ Image الرسمية فيها فحص صحة Health Check جاهز، فتظهر الخدمة بحالة healthy دون أن تضيفه. والخدمة whoami تطبيق صغير بـ Node.js يطبع الترويسات التي تصله، حتى نرى ما يعطيه Authelia للتطبيق:
// Echoes the request line and the Remote-* headers that the proxy adds after Authelia allows the request.
require('node:http').createServer((req, res) => {
const h = Object.fromEntries(Object.entries(req.headers).filter(([k]) => k.startsWith('remote-')));
res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
res.end(`${req.method} ${req.headers.host}${req.url}\n` + Object.entries(h).map(([k, v]) => `${k}: ${v}`).join('\n') + '\n');
}).listen(3000);ملف Caddyfile
نتبع دليل Authelia لـ Caddy، حيث يمرر Caddy بوابة الدخول كما هي، ويضع أمام التطبيقين الأمر forward_auth:
auth.lab.localhost {
tls internal
reverse_proxy authelia:9091
}
app.lab.localhost, admin.lab.localhost {
tls internal
forward_auth authelia:9091 {
uri /api/authz/forward-auth
copy_headers Remote-User Remote-Groups Remote-Email Remote-Name
}
reverse_proxy whoami:3000
}والأمر copy_headers مهم من ناحية الأمان، والسبب أن Caddy يأخذ هذه الترويسات من رد Authelia ويكتبها فوق أي ترويسة بنفس الاسم أرسلها المتصفح، فلا يستطيع مستخدم أن يرسل Remote-User: alice بنفسه. وفي بيئة الإنتاج تحذف tls internal فيصدر Caddy شهادة حقيقية، وتغير الأسماء إلى نطاقك.
التشغيل
docker compose up -d
docker compose logs authelialevel=info msg="Authelia v4.39.28 is starting"
level=info msg="Storage schema migration from 0 to 29 is being attempted"
level=info msg="Storage schema migration from 0 to 29 is complete"
level=info msg="Startup complete"
level=info msg="Listening for non-TLS connections on '[::]:9091' path '/'" server=main service=serverوكان التشغيل الأول كله في ثلاث ثوان، ومنه إنشاء جداول قاعدة البيانات. والآن نجرب الطلب دون جلسة:
curl -sk -o /dev/null -w '%{http_code} %{redirect_url}\n' https://app.lab.localhost:18818/302 https://auth.lab.localhost:18818/?rd=https%3A%2F%2Fapp.lab.localhost%3A18818%2F&rm=GETلم يصل الطلب إلى التطبيق، وإنما حوله Caddy إلى بوابة الدخول ومعه عنوان العودة في المعامل rd.
الفريق: عامل واحد
نبدأ بجدول المناوبات، وهو الأداة التي يفتحها كل موظفي العيادات كل صباح، فلا نريد أن نطلب منهم رمزاً في كل مرة، وإنما نريد أن نعرف من فتح الجدول ومتى، وأن يتوقف دخول من يغادر فور تعطيل حسابه. وفي المختبر يمثل bob موظفاً عادياً في مجموعة dev، وتمثل alice مدير العمليات في المجموعتين.
عند فتح التطبيق في المتصفح ظهرت بوابة الدخول بالعربية، لأن Authelia يختار اللغة من إعدادات المتصفح:

ودخل bob بكلمة مروره فوصل إلى التطبيق، وهذا ما طبعه التطبيق:
GET app.lab.localhost:18818/
remote-email: [email protected]
remote-groups: dev
remote-name: Bob Dev
remote-user: bobثم فتح bob لوحة الإدارة بنفس الجلسة فكان الرد 403 Forbidden، والسبب أن القاعدة الأولى تطلب مجموعة admins، ولا تنطبق عليه القاعدة الثانية لأنها لنطاق آخر، فوصل إلى default_policy وهي الرفض، وفي السجل:
level=info msg="Access to 'https://admin.lab.localhost:18818/' is forbidden to user 'bob'" method=GET path=/api/authz/forward-authوهذا السطر هو ما تحتاجه عند التدقيق Audit: من حاول الوصول إلى ماذا، ولماذا رفض.
ماذا لو أرسل أحد ترويسة Remote-User بنفسه؟
بعد شهر طلب مزود خدمة المراقبة عند العيادات أن يفحص صفحة /health في جدول المناوبات كل دقيقة، والفاحص لا يستطيع أن يسجل الدخول، فأضفنا في أول القواعد قاعدة تسمح بهذا المسار دون دخول، وهي policy: 'bypass' مع resources: ['^/health$']. ثم جربنا السؤال الذي يجب أن يسأله كل من يثق بترويسات Remote-*: ماذا يحدث إذا أرسل المهاجم هذه الترويسات بنفسه؟
curl -sk -H 'Remote-User: alice' -H 'Remote-Groups: admins' https://app.lab.localhost:18818/
curl -sk -H 'Remote-User: alice' -H 'Remote-Groups: admins' https://app.lab.localhost:18818/health
curl -sk -b bob.jar -H 'Remote-User: alice' -H 'Remote-Groups: admins' https://app.lab.localhost:18818/والنتائج الثلاث كانت مختلفة:
- دون جلسة على المسار
/كان الرد 302 إلى بوابة الدخول، فالترويسة المزورة لا تعطي جلسة. - bob بجلسته وصل إلى التطبيق باسمه هو، فقد كتب Caddy ترويسات Authelia فوق المزورة:
remote-user: bobوremote-groups: dev. - أما على المسار
/healthدون أي جلسة فوصل الطلب إلى التطبيق ومعه الترويسات المزورة كما هي:
GET app.lab.localhost:18818/health
remote-groups: admins
remote-user: aliceوالسبب أن Authelia في قاعدة bypass يرد 200 دون أي ترويسات Remote-*، لأنه لا يوجد مستخدم أصلاً، وcopy_headers في Caddy ينسخ ما يجده في رد Authelia فقط، ولا يحذف ما أرسله المتصفح. وهذا لا يضر صفحة /health نفسها، ولكن إذا كان التطبيق يقرأ Remote-User في كل مساراته، وفيه مسار مسموح دون دخول يقبل فعلاً، مثل نموذج أو واجهة برمجية، فسوف يعامل الطلب على أنه من alice في مجموعة admins. والشكل التالي يلخص التجربة:

والإصلاح أن يحذف Caddy كل ترويسة تبدأ بـ Remote- من الطلب القادم قبل أي شيء، ثم يضيف ما يأتي من Authelia فقط. وفي المحاولة الأولى وضعنا request_header -Remote-User مباشرة في موقع Caddy، فاختفت الترويسات المزورة، ولكن اختفت معها ترويسات bob الصحيحة أيضاً، والسبب أن Caddy يرتب التوجيهات Directives بترتيب ثابت خاص به، وليس بترتيب كتابتها، فنفذ الحذف بعد أن نسخ ترويسات Authelia. والحل أن نضع التوجيهات داخل route الذي يلزم Caddy بالترتيب المكتوب:
app.lab.localhost, admin.lab.localhost {
tls internal
route {
request_header -Remote-*
forward_auth authelia:9091 {
uri /api/authz/forward-auth
copy_headers Remote-User Remote-Groups Remote-Email Remote-Name
}
reverse_proxy whoami:3000
}
}وبعد هذا التعديل أعدنا الطلبات نفسها، فوصل /health إلى التطبيق دون أي ترويسة Remote-*، ووصل bob باسمه رغم أنه أرسل اسم alice:
== /health spoofed
GET app.lab.localhost:18818/health
== bob spoofed
GET app.lab.localhost:18818/
remote-email: [email protected]
remote-groups: dev
remote-name: Bob Dev
remote-user: bobوالقاعدة من هذه التجربة أن ثقة التطبيق بترويسات الهوية مشروطة بشرطين: أن لا يصل إليه أي طلب إلا عبر الـ Proxy، وأن يحذف الـ Proxy هذه الترويسات من كل طلب قادم قبل أن يضيفها بنفسه، سواء كان المسار محمياً أم لا.
الإدارة: عاملان وتسجيل جهاز TOTP
عندما دخلت alice إلى لوحة الإدارة بكلمة مرورها قبلها Authelia في الخطوة الأولى، ولكنه لم يحولها إلى اللوحة، وكتب في السجل https://admin.lab.localhost:18818/ requires 2FA, cannot be redirected yet، وعرض عليها صفحة العامل الثاني، وفيها رابط لتسجيل أول جهاز لأنها لم تسجل أي جهاز بعد:

لماذا يطلب رمزاً بالبريد قبل تسجيل الجهاز؟
عند الضغط على «إضافة» لم يعرض Authelia رمز QR مباشرة، وإنما فتح نافذة «التحقق من الهوية» وأرسل رمزاً من ثمانية أحرف إلى بريد المستخدم. وقد يتساءل البعض: لماذا هذه الخطوة وقد أدخلت كلمة المرور قبل ثوان؟ والإجابة أن كلمة المرور وحدها قد تكون مسروقة، فلو سمح Authelia لمن يعرفها بتسجيل جهازه هو، لصار المخترق صاحب العامل الثاني أيضاً، وبالتالي يطلب Authelia إثباتاً من قناة ثانية هي البريد، وهذا ما يسميه الجلسة المرتفعة Elevated Session.

وفي المختبر وصلت الرسالة إلى الملف /data/notification.txt، وهذا جزء منها:
Subject: Confirm your identity
A ONE-TIME CODE HAS BEEN GENERATED TO COMPLETE A REQUESTED ACTION
Hi Alice Admin,
This notification has been sent to you in order to verify your identity to change security details for your account at lab.localhost.
----------------------------------------
WKKT6EHP
----------------------------------------
If you did not initiate the process your credentials may have been compromised and you should:
1. Revoke this code using the provided links belowوبعد إدخال الرمز ظهر معالج التسجيل بثلاث خطوات: الخيارات (SHA1 وستة أرقام وثلاثون ثانية)، ثم رمز QR، ثم إدخال أول رمز من التطبيق للتأكيد:


ثم عادت alice إلى صفحة العامل الثاني، فأدخلنا رمزاً خاطئاً عمداً فظهرت رسالة «كلمة المرور لمرة واحدة قد تكون خاطئة»، ثم الرمز الصحيح فوصلت إلى اللوحة:

GET admin.lab.localhost:18818/
remote-email: [email protected]
remote-groups: admins,dev
remote-name: Alice Admin
remote-user: aliceماذا يحدث إذا كرر المستخدم طلب الرمز؟
أثناء التجربة طلبنا رمز التحقق عدة مرات في دقائق قليلة، فظهرت في الواجهة رسالة «Failed to generate the One-Time Code. Please try again»، وفي السجل:
level=warning msg="Rate Limit Exceeded" bucket=1 delay=106.320172943 method=POST path=/api/user/session/elevationوهذا حد افتراضي لعدد الطلبات على هذه النقطة، والسبب أن كل طلب يرسل بريداً، فلو لم يوجد الحد لاستطاع أي شخص يعرف كلمة مرور موظف أن يغرق بريده. والرقم delay هو عدد الثواني المتبقية، فإذا اتصل بك موظف بهذه الرسالة فاطلب منه الانتظار دقيقتين، ولا تعد تشغيل Authelia لتجاوزه رغم أن ذلك يصفر العداد، لأنه يصفر معه الحماية.
القواعد بالتفصيل، والقاعدة التي فتحت لوحة الحجوزات
كل قاعدة في قسم access_control مجموعة شروط، وكلها يجب أن تتحقق حتى تطابق القاعدة الطلب، وأهمها: domain أو domain_regex للنطاق، وresources لتعبيرات منتظمة Regular Expressions على المسار، وsubject للمستخدم أو المجموعة، وnetworks لعناوين IP المصدر، وmethods لنوع الطلب مثل GET وPOST، ثم policy وهي النتيجة: bypass أو one_factor أو two_factor أو deny. ويمر Authelia على القواعد من الأعلى إلى الأسفل، وأول قاعدة تطابق هي التي تطبق ويتوقف البحث، وإذا لم تطابق أي قاعدة طبق default_policy.
وفي العيادات طلب أحد الأطباء أن يفتح كل الأدوات الداخلية دون أن يطلب منه رمز في كل مرة، فأضاف المهندس في أول القائمة قاعدة واسعة تبدو بريئة:
- domain: '*.lab.localhost'
subject: 'group:dev'
policy: 'one_factor'ثم سجل bob، وهو في مجموعة dev فقط، ودخل إلى لوحة الإدارة:
== bob -> admin with the wildcard rule first
GET admin.lab.localhost:18818/
remote-email: [email protected]
remote-groups: dev
remote-name: Bob Dev
remote-user: bob
200
== alice (dev+admins) -> admin with one factor only
200أي أن القاعدة الواسعة فتحت لوحة الحجوزات لكل مجموعة dev، وأسقطت العامل الثاني عن alice لأنها في dev أيضاً، ولم تطبق قاعدة two_factor أبداً لأن القاعدة الأولى طابقت قبلها، بل إن صفحة /health صارت ترد 302 لأن الفاحص المجهول لم يعد يصل إلى قاعدة bypass. ولم يكتب Authelia أي تحذير في السجل، لأن الإعداد صحيح من ناحية الصيغة، وإنما خاطئ في المعنى. والأداة التي تكشف هذا قبل النشر موجودة داخل Authelia نفسه، وهي الأمر access-control check-policy الذي يقول لك أي قاعدة سوف تطبق على طلب معين:
docker compose exec authelia authelia access-control check-policy --config /config/configuration.yml \
--url 'https://admin.lab.localhost:18818/' --username bob --groups dev --verbosePerforming policy check for request to 'https://admin.lab.localhost:18818/' method 'GET' username 'bob' groups 'dev'.
# Domain Resource Query Method Network Subject
* 1 hit hit hit hit hit hit
2 miss miss hit hit hit hit
3 hit hit hit hit hit miss
4 miss hit hit hit hit hit
The policy 'one_factor' from rule #1 will be applied to this request.والجدول يقرأ كما يلي: كل سطر قاعدة، وكل عمود شرط، وhit يعني أن الشرط تحقق، والنجمة على القاعدة التي طبقت. وبعد أن أعدنا الترتيب الصحيح كان المخرج لنفس الطلب:
# Domain Resource Query Method Network Subject
1 miss miss hit hit hit hit
2 hit hit hit hit hit miss
3 miss hit hit hit hit hit
The policy 'deny' from the default policy will be applied to this request as no rules matched the request.ولـ alice: The policy 'two_factor' from rule #2 will be applied to this request.، وهذا ما نريده بالضبط. والشكل التالي يضع الترتيبين جنباً إلى جنب:

والقاعدة العملية: رتب القواعد من الأضيق إلى الأوسع، فالاستثناءات مثل bypass لمسار محدد أولاً، ثم الأدوات الحساسة بـ two_factor، ثم الأدوات العامة، واجعل deny هو الافتراضي، ولا تنشر أي تعديل على القواعد قبل أن تشغل check-policy لمستخدم يجب أن يدخل ولمستخدم يجب أن يرفض، واحفظ هذه الأوامر في ملف بجانب الإعداد حتى تعيدها مع كل تعديل.
الحماية من التخمين Regulation
وفي العيادات ظهرت الحاجة إلى هذا الإعداد في الأسبوع الأول بطريقة غير متوقعة: موظفة استقبال جديدة أخطأت في كلمة مرورها ثلاث مرات صباحاً، ثم لم تستطع الدخول حتى بالكلمة الصحيحة، واتصلت بالمهندس تقول إن «النظام معطل». وهذا بالضبط ما يجب أن يحدث، ولكن المهم أن يعرف المسؤول ما الذي حدث وكيف يرفعه، لأن الرسالة التي يراها الموظف لا تقول إن حسابه موقوف.
الإعداد regulation يوقف المستخدم بعد ثلاث محاولات خاطئة خلال دقيقتين لمدة خمس دقائق. وجربنا ذلك بأربع كلمات خاطئة ثم الكلمة الصحيحة:
for p in w1 w2 w3 w4 'كلمة-المرور-الصحيحة'; do
curl -sk -H 'Content-Type: application/json' \
-d "{\"username\":\"bob\",\"password\":\"$p\",\"keepMeLoggedIn\":false}" \
https://auth.lab.localhost:18818/api/firstfactor; echo
done{"status":"KO","message":"Authentication failed. Check your credentials."}
{"status":"KO","message":"Authentication failed. Check your credentials."}
{"status":"KO","message":"Authentication failed. Check your credentials."}
{"status":"KO","message":"Authentication failed. Check your credentials."}
{"status":"KO","message":"Authentication failed. Check your credentials."}الرد الخامس، وهو بكلمة المرور الصحيحة، مثل الردود السابقة تماماً، فلا يعرف المهاجم أن الحساب توقف، أما السجل فيقول الحقيقة:
level=error msg="Unsuccessful 1FA authentication attempt by user 'bob'"
level=error msg="Unsuccessful 1FA authentication attempt by user 'bob' and they are banned until 9:27:32PM on October 25 2026 (+00:00)"وإذا كان الموظف هو من أخطأ فعلاً فترفع الإيقاف من سطر الأوامر:
docker compose exec authelia authelia storage bans user list --config /config/configuration.yml
docker compose exec authelia authelia storage bans user revoke bob --config /config/configuration.ymlID Username Expires Source Reason
1 bob 2026-10-25 21:27:32 regulation Exceeding Maximum Retries
ID Username Result Information
1 bob SUCCESS N/Aالجلسات بعد إعادة التشغيل: لماذا Redis؟
بدأنا التجربة دون Redis، فكانت الجلسات في ذاكرة Authelia، ثم سجلنا الدخول بـ curl وأعدنا تشغيل Authelia وطلبنا التطبيق بنفس الكوكي، فتغير الرد من 200 إلى 302، أي أن كل المستخدمين خرجوا. وبعد إضافة Redis كررنا نفس الخطوات فبقي الرد 200 بعد إعادة التشغيل:
{"status":"OK"}
before: 200
after restart: 200وقد يبدو خروج الجميع عند إعادة التشغيل أمراً بسيطاً، ولكن كل تحديث لـ Authelia إعادة تشغيل، وكل تعديل في ملف المستخدمين أو القواعد كذلك، فإذا كان فريقك يدخل برمز TOTP فسوف يدخله الجميع من جديد مع كل تعديل صغير. لذلك أضف Redis من البداية، فهو يستهلك بضعة ميجابايت فقط.
الشاشة المفتوحة في الاستقبال: مؤقتات الجلسة
في العيادات مشكلة أخرى لا تحلها كلمات المرور: موظفة الاستقبال تفتح لوحة الحجوزات، ثم تذهب إلى مريض، فتبقى الشاشة مفتوحة أمام كل من يمر. وفي Authelia ثلاثة مؤقتات تحدد متى تنتهي الجلسة، كما في توثيق الجلسات: inactivity وهو مدة الخمول دون أي طلب وقيمته الافتراضية 5 دقائق، وexpiration وهو العمر الأقصى للجلسة مهما كان النشاط وقيمته الافتراضية ساعة، وremember_me وهو العمر عندما يختار المستخدم «تذكر لي» وقيمته الافتراضية شهر. والكوكي نفسه مكتوب على النطاق الرئيسي، فيصل إلى كل الأدوات تحته، والشكل التالي يجمع ذلك:

وجربنا مؤقت الخمول بقيمة دقيقة واحدة حتى لا ننتظر طويلاً، فأضفنا inactivity: '1 minute' تحت session، ثم سجل bob وطلب الأداة ثلاث مرات:
{"status":"OK"}
16:36:44
now: 200
after 40s (activity resets timer): 200
16:38:40
after 75s idle: 302 https://auth.lab.localhost:18818/?rd=https%3A%2F%2Fapp.lab.localhost%3A18818%2F&rm=GETالطلب بعد 40 ثانية نجح وأعاد عداد الخمول إلى الصفر، ثم بعد 75 ثانية بلا أي طلب انتهت الجلسة وعادت بوابة الدخول. ولاحظ أن «النشاط» عند Authelia هو طلب يمر عبر الـ Proxy، فالصفحة التي تحدث نفسها في الخلفية كل دقيقة تبقي الجلسة حية إلى الأبد ما دامت مفتوحة، لذلك لا يحمي مؤقت الخمول من الشاشة المفتوحة على لوحة تحدث نفسها، وإنما يحميه expiration الذي ينهي الجلسة بعد مدة ثابتة مهما كان النشاط. ولأدوات مثل لوحة الحجوزات اجعل الخمول قصيراً، 5 أو 10 دقائق، والعمر ساعة أو ساعتين، وعطل «تذكر لي» بالقيمة remember_me: -1 كما يشرح التوثيق، لأن شهراً كاملاً على جهاز مشترك في الاستقبال يعني أن كل من يجلس على الجهاز هو موظفة الاستقبال.
العربية في الواجهة
في Authelia ترجمة عربية ar-SA ضمن أكثر من 60 لغة، وتظهر تلقائياً لمن لغة متصفحه العربية، ولكن هناك ثلاث ملاحظات قبل أن تعتمد عليها:
- الاتجاه بقي من اليسار إلى اليمين LTR، فالنص عربي ولكن الحقول ومربع «تذكر لي» على اليسار.
- بعض النصوص بقيت بالإنجليزية، مثل «Hi Alice Admin» و«SWITCH USER» و«One-Time Code».
- بعض الترجمات حرفية، مثل «مؤلف جوجل» بدل Google Authenticator، و«كلمة المرور لمرة واحدة» بدل رمز التحقق.
فإذا كانت بوابة الدخول ستعرض على موظفين لا يقرؤون الإنجليزية فراجع الشاشات معهم قبل الإطلاق، أو اعرض عليهم الإنجليزية مع دليل مصور قصير.
عندما تكبر العيادات: LDAP ومزود OIDC
ملف users.yml مناسب لعشرة أو عشرين شخصاً، ولكن بعد افتتاح الفرع الرابع صار في العيادات أكثر من خمسين موظفاً، وكل إضافة أو تعطيل تعني أن يعدل المهندس الملف ويعيد تشغيل Authelia، وهذا ما ذكرناه في الجلسات: كل إعادة تشغيل دون Redis تخرج الجميع. والخطوة الطبيعية هنا أن ينقل المستخدمون إلى دليل مستخدمين Directory يتحدث LDAP، فيقرأ منه Authelia الأسماء والمجموعات وكلمات المرور، ويضيف المسؤول الموظفين من واجهة الدليل دون أن يلمس Authelia. وللفرق الصغيرة والمتوسطة دليل خفيف مثل LLDAP أو Kanidm، وقد شرحناهما في دليل Kanidm وLLDAP.
والخطوة الثانية تظهر عندما تضيف العيادات أداة تعرف OIDC أصلاً، مثل نظام تذاكر أو Grafana، فبدل أن تحميها من الخارج بـ Forward Auth، تستطيع أن تجعل Authelia نفسه مزود OpenID Connect لها، فتدخل الأداة وهي تعرف المستخدم ومجموعاته من التوكن، وتحتفظ بصلاحياتها الداخلية مثل مدير ومشاهد. ولكن انتبه إلى أن Authelia يبقى بلا واجهة لإدارة المستخدمين، فإذا وصلت إلى مرحلة تحتاج فيها الموارد البشرية إلى إضافة الموظفين بنفسها، أو تحتاج إلى SAML لنظام قديم، فقد تجاوزت ما صمم له، وهنا ارجع إلى مقارنة أدوات الهوية لترى أي أداة تناسب الحجم الجديد، وفيها قياس Authelia بجانب الأدوات الأخرى على نفس السيرفر.
ما يتغير في بيئة الإنتاج
إرسال البريد عبر SMTP
نستبدل قسم notifier بإعداد SMTP، وكلمة المرور في ملف سر مثل بقية الأسرار عبر المتغير AUTHELIA_NOTIFIER_SMTP_PASSWORD_FILE:
notifier:
smtp:
address: 'submission://smtp.example.com:587'
username: '[email protected]'
sender: 'Authelia <[email protected]>'ولم نرسل بريداً حقيقياً في المختبر، لذلك جرب الإعداد بنفسك، فإذا كان المنفذ محجوباً أو البيانات خاطئة فسوف يرفض Authelia الإقلاع ويكتب السبب في السجل، والسبب أنه يفحص اتصال SMTP عند التشغيل.
النطاقات
نغير في configuration.yml النطاق في الكوكي إلى example.com، وauthelia_url إلى https://auth.example.com، وأسماء القواعد إلى app.example.com وadmin.example.com، وكذلك في Caddyfile مع حذف tls internal. وإذا كبر عدد المستخدمين أو كان في الشركة دليل مستخدمين Directory فانقل authentication_backend من الملف إلى LDAP.
التحقق من النجاح
docker compose psيعرضautheliaبحالةhealthy.- طلب التطبيق دون جلسة يعيد 302 إلى
auth.example.comومعهrd. - مستخدم من خارج المجموعات يحصل على 403، ويظهر سطر
is forbidden to userفي السجل. - لوحة الإدارة تطلب رمز TOTP بعد كلمة المرور، ورسالة التحقق تصل إلى البريد.
- بعد إعادة تشغيل Authelia يبقى المستخدم داخلاً، أي أن Redis يعمل.
- لا يوجد منفذ منشور لـ Authelia، والطريق الوحيد إليه عبر Caddy.
النسخ الاحتياطي Backup والاستعادة Restore
ما تحتاج إلى نسخه: مجلد config (الإعداد وملف المستخدمين)، ومجلد secrets في مكان منفصل، والـ Volume الذي فيه قاعدة SQLite وأجهزة TOTP وWebAuthn وسجل الدخول. ونوقف Authelia أثناء نسخ قاعدة SQLite حتى لا ننسخها في منتصف كتابة، ونستخدم الـ Image نفسها لأنها تضم الأمر tar:
docker compose stop authelia
docker run --rm --entrypoint sh -v authelia_data:/data:ro -v "$PWD":/backup authelia/authelia:4.39.28 \
-c 'tar czf /backup/authelia-data.tgz -C /data .'
docker compose start autheliaوكان حجم النسخة 14 KB. وللتأكد أنها تصلح استعدناها في Volume جديد، ثم شغلنا عليها أمر تصدير TOTP مع مفتاح التشفير، فظهر جهاز alice كاملاً، وهذا يثبت أن النسخة ومعها المفتاح كافيتان، وأن النسخة دون المفتاح لا فائدة منها:
otpauth://totp/example.com:alice?algorithm=SHA1&digits=6&issuer=example.com&period=30&secret=...
Successfully exported 1 TOTP configurations as TOTP URI's and printed them to the consoleالتحديث Upgrade إلى إصدار أحدث
- اقرأ ملاحظات الإصدار في GitHub، وخاصة عند الانتقال بين إصدارات فرعية مثل 4.38 إلى 4.39، والسبب أن بعض الإصدارات تغير أسماء خيارات الإعداد، وAuthelia يرفض الإقلاع إذا وجد خياراً قديماً أزيل.
- خذ نسخة احتياطية كما في القسم السابق.
- غير الوسم في ملف Compose، ثم
docker compose pull authelia && docker compose up -d authelia. - تابع السجل حتى
Startup complete، وإذا كانت هناك ترحيلات Migrations لقاعدة البيانات فسوف تراها فيه، ثم جرب الدخول بحساب فيه TOTP.
مشكلات شائعة وحلولها
Authelia لا يقلع ويشكو من authelia_url
العنوان يجب أن يبدأ بـ https://، وأن يكون تحت النطاق المكتوب في domain نفسه، فإذا كان الكوكي على example.com والبوابة على login.other.com فلن يقبله.
حلقة تحويل Redirect Loop بين التطبيق والبوابة
الكوكي لا يصل إلى التطبيق، وغالباً لأن التطبيق ليس تحت النطاق المكتوب في session.cookies.domain، أو لأنك تفتحه عبر HTTP، والكوكي مكتوب بالخاصية Secure فلا يرسله المتصفح إلا عبر HTTPS.
403 لمستخدم يجب أن يدخل
راجع ترتيب القواعد ومجموعات المستخدم في users.yml، وتذكر أن أول قاعدة تطابق النطاق تطبق، وأن تعديل ملف المستخدمين يحتاج إلى أن يقرأه Authelia من جديد، والسجل يكتب لكل رفض اسم المستخدم والعنوان.
«Failed to generate the One-Time Code»
إما أن البريد لم يرسل، فتجد الخطأ في السجل، وإما أن المستخدم تجاوز حد الطلبات فتجد Rate Limit Exceeded ومعه عدد ثواني الانتظار.
الدخول بطيء أو يظهر «database is locked»
الهاش argon2id يحتاج إلى معالج وذاكرة، فعلى سيرفر مشغول قد يستغرق الدخول ثوان، وقد ظهر لنا في هذه الحالة خطأ database is locked مرة واحدة من SQLite. فإذا كان السيرفر مشتركاً مع أعمال ثقيلة فخصص لـ Authelia معالجاً كافياً، وإذا كان المستخدمون كثيرين فانقل التخزين إلى PostgreSQL.
قائمة تحقق قبل أن تحمي أداة حقيقية
جمعنا في الجدول التالي كل ما وجدناه في المختبر، بالترتيب الذي نقترح أن تراجعه قبل أن تضع لوحة فيها بيانات مرضى أو عملاء خلف Authelia:
| البند | كيف تتحقق منه |
|---|---|
| الأداة لا تصل إليها الطلبات إلا عبر الـ Proxy | لا يوجد منفذ منشور لها، والطلب المباشر إلى عنوانها الداخلي من خارج الشبكة يفشل |
الـ Proxy يحذف ترويسات Remote-* القادمة قبل forward_auth | طلب مزور على مسار bypass يصل إلى التطبيق دون أي ترويسة Remote-* |
default_policy: 'deny' والقواعد من الأضيق إلى الأوسع | check-policy لمستخدم يجب أن يرفض يعطي deny |
الأدوات الحساسة بـ two_factor | check-policy لمدير يعطي two_factor من القاعدة الصحيحة |
| Redis للجلسات | إعادة تشغيل Authelia لا تخرج المستخدمين |
| مؤقتات الجلسة مناسبة للأجهزة المشتركة | inactivity قصير، وremember_me معطل للأدوات الحساسة |
| SMTP يعمل | رسالة الرمز تصل عند تسجيل جهاز TOTP |
| الحماية من التخمين مفعلة ويعرف المسؤول كيف يرفع الإيقاف | الأمر authelia storage bans user list |
| مفتاح التشفير في مكان منفصل عن النسخة الاحتياطية | استعادة تجريبية بالمفتاح تخرج أجهزة TOTP |
كم تدفع لو اخترت خدمة تجارية؟
أقرب خدمة تجارية لما يفعله Authelia هي Cloudflare Access، وبحسب صفحتها بتاريخ 25 أكتوبر 2026 فهي مجانية للفرق الأقل من 50 مستخدماً، ثم 7 دولارات لكل مستخدم شهرياً تدفع سنوياً، وتشترط أن يمر الطلب عبر شبكة Cloudflare. أما Authelia فلا يكلف إلا السيرفر الذي يعمل عليه، ويبقى كل شيء عندك، ولكنك أنت من يحدثه ويراقبه.
الخلاصة
وصلنا لنهاية الموضوع، وأهم ما فيه:
- Authelia يحمي التطبيقات عبر الـ Reverse Proxy بخدمة واحدة خفيفة استهلكت أقل من 100 MiB في الخمول، ويناسب من يدير سيرفراته بالملفات، ولا يناسب من يحتاج إلى لوحة إدارة للمستخدمين.
- ابدأ بـ
default_policy: 'deny'، واطلبtwo_factorحيث يكون الضرر كبيراً فقط. - تسجيل جهاز TOTP يحتاج إلى رمز يصل بالبريد، لذلك فإعداد SMTP شرط للإنتاج وليس إضافة.
- أضف Redis حتى لا يخرج الجميع مع كل إعادة تشغيل، واحفظ مفتاح التشفير Encryption بعيداً عن نسخة قاعدة البيانات.
- الترجمة العربية موجودة ولكن الاتجاه LTR وبعض النصوص إنجليزية، فراجعها قبل عرضها على الموظفين.
- القاعدة الأولى التي تطابق هي التي تطبق: قاعدة واسعة في أعلى القائمة فتحت لوحة الإدارة لمجموعة كاملة وأسقطت العامل الثاني، فرتب القواعد من الأضيق إلى الأوسع واختبر كل تعديل بالأمر
check-policy. - على مسار
bypassوصلت ترويساتRemote-Userالمزورة إلى التطبيق، فاجعل الـ Proxy يحذف كل ترويسةRemote-*قادمة داخلrouteقبل أن يسأل Authelia. - مؤقت الخمول أنهى الجلسة بعد 75 ثانية بلا طلب في تجربتنا، ولكن الصفحة التي تحدث نفسها تبقي الجلسة حية، فاعتمد على
expirationالقصير وعطل «تذكر لي» للأجهزة المشتركة. - كل دخول يحجز 64 MiB بسبب argon2id، فضع حداً لطلبات الدخول في الـ Proxy وحداً للذاكرة على الـ Container بدل أن تخفض قيم الهاش.
وقد قارنا Authelia مع authentik وKeycloak وZITADEL وPocket ID، وقسناها على نفس السيرفر، في مقالة المقارنة، وحماية أي أداة بالطريقة نفسها مع authentik في دليل Forward Auth.
سجل التحديثات
- أكتوبر 2026: كتابة الدليل واختباره على Authelia 4.39.28 مع Caddy 2.10.2 وRedis 8.2.2.
- أكتوبر 2026: توسيع الدليل بقصة العيادات، وشرح Forward Auth من الداخل، وتجارب جديدة على نفس الإصدارات: ترتيب القواعد مع
check-policy، والترويسات المزورة على مسارbypassوإصلاحها في Caddy، ومؤقت الخمول، وثمن argon2id، والانتقال إلى LDAP، وقائمة تحقق.