احراز هویت
روش ورود کاربران، پنل‌های مدیریت و افزونه‌ی ضد هرزنامه.
روش افزودن هر یک: مؤلفه‌ها.
یا MAS یا ارائه‌دهنده‌ی گذرواژه، نه هر دو. با MAS، همه‌ی ورودها را MAS انجام می‌دهد، بنابراین ارائه‌دهندگان گذرواژه‌ی خودِ Synapse (REST auth، Shared Secret Auth، LDAP auth و Matrix Corporal که به دو مورد از آن‌ها نیاز دارد) نمی‌توانند کار کنند. اگر هر دو انتخاب شده باشند، Review از استقرار جلوگیری می‌کند. پس از نصب سرور نیز نمی‌توان MAS را فعال یا غیرفعال کرد، بنابراین پیش از نخستین استقرار تصمیم بگیرید.
سرویس احراز هویت ماتریکس (MAS)
فقط Synapse. ورود و حساب‌ها را بر عهده می‌گیرد: صفحه‌ی ورود، نشست‌ها و ثبت‌نام. Element X، برنامه‌ی جدید Element برای تلفن همراه، به آن نیاز دارد. همه‌ی پیش‌تنظیم‌های Synapse آن را انتخاب می‌کنند.
تنظیمات: ندارد.
پس از استقرار: برنامه‌ها کاربران را به صفحه‌ی ورودی روی
matrix.example.org می‌فرستند و سپس بازمی‌گردانند. حساب‌ها را با Manage ›
Add a user (a) اضافه کنید. برای اینکه کاربران خودشان ثبت‌نام کنند، Manage
› Open registration (g) یک توکن ثبت‌نام می‌سازد؛ آن را به افرادی که
می‌خواهید بدهید و هر زمان خواستید ثبت‌نام را دوباره ببندید.
نکته: پس از فعال شدن MAS، غیرفعال کردن آن بدون قفل شدن حساب همه ممکن نیست؛
فعال کردن آن روی سروری که از پیش کاربر دارد نیز به یک مهاجرت نیاز دارد
(syn2mas در پلی‌بوک). interzone از هر دو جلوگیری می‌کند.
مستندات پلی‌بوک
دابل پاپت (Appservice Double Puppet)
برای بریج‌ها. بدون آن، پیامی که خودتان در برنامه‌ی تلگرام می‌فرستید، در اتاق ماتریکس از طرف یک «کاربر تلگرام» جایگزین نمایش داده می‌شود، نه از طرف شما. با آن، به نام خودتان نمایش داده می‌شود و وضعیت خوانده شدن پیام‌ها نیز همگام می‌شود.
تنظیمات: ندارد. پس از استقرار: کاری لازم نیست؛ هر بریجی که از آن پشتیبانی کند، از آن استفاده می‌کند. مستندات پلی‌بوک
پنل مدیریت Ketesa
فقط Synapse. یک پنل مدیریت در مرورگر: کاربران (ساخت، بازنشانی گذرواژه، غیرفعال‌سازی)، اتاق‌ها، فایل‌ها، گزارش‌ها و نشست‌ها.
تنظیمات: ندارد. زیردامنه‌ی جداگانه‌ای نیز ندارد.
پس از استقرار: نشانی https://matrix.example.org/synapse-admin را باز کنید
و با حساب مدیر وارد شوید. تنها مدیران سرور می‌توانند از آن استفاده کنند؛ برای
مدیر کردن یک کاربر از Manage › Manage users (m) استفاده کنید.
مستندات پلی‌بوک
پنل Element Admin
برنامه‌ی وب مدیریتی خودِ Element. جدیدتر از Ketesa است، امکانات کمتری دارد و برای سرورهای دارای MAS طراحی شده است.
رکورد DNS: admin.element.example.org.
پس از استقرار: نشانی https://admin.element.example.org را باز کنید و با
حساب مدیر وارد شوید.
مستندات پلی‌بوک
ارائه‌دهنده‌ی گذرواژه‌ی REST auth
فقط Synapse، نه همراه با MAS. نام کاربری و گذرواژه را با یک سرویس وب که خودتان اجرا می‌کنید بررسی می‌کند، برای زمانی که حساب‌های شما در سامانه‌ی دیگری نگهداری می‌شوند.
تنظیمات: نشانی سرویس شما (Endpoint URL). این سرویس باید از پروتکل REST auth پشتیبانی کند. مستندات پلی‌بوک
رمز مشترک (Shared Secret Auth)
فقط Synapse، نه همراه با MAS. به برنامه‌ای که یک رمز را می‌داند اجازه می‌دهد به جای هر کاربری وارد شود. برخی بریج‌های قدیمی و Matrix Corporal از آن استفاده می‌کنند؛ بریج‌های امروزی به جای آن از دابل پاپت بهره می‌برند.
تنظیمات: رمز مشترک (Shared secret): به‌طور خودکار ساخته می‌شود؛ ctrl+r
آن را نشان می‌دهد.
مستندات پلی‌بوک
ارائه‌دهنده‌ی گذرواژه‌ی LDAP
فقط Synapse، نه همراه با MAS. کاربران با حساب خود در یک دایرکتوری LDAP (Active Directory، OpenLDAP و…) وارد می‌شوند و حساب ماتریکس آن‌ها در نخستین ورود ساخته می‌شود.
تنظیمات:
- نشانی‌ها (LDAP URIs): برای نمونه
ldaps://ldap.example.org:636؛ اگر بیش از یکی است، با ویرگول جدا کنید. - گزینه‌ی Use StartTLS: برای نشانی‌های
ldap://فعال؛ برایldaps://غیرفعال. - مسیر Base DN: محل حساب‌ها، برای نمونه
ou=users,dc=example,dc=org. - فیلدهای UID / Mail / Name attribute: کدام ویژگی‌های LDAP نام کاربری،
ایمیل و نام نمایشی را در خود دارند. مقادیر پیش‌فرض (
uid،mail،cn) برای OpenLDAP مناسب‌اند؛ Active Directory برای نام کاربری ازsAMAccountNameاستفاده می‌کند. - فیلدهای Bind DN و Bind password: حسابی که اجازه‌ی جستجو در دایرکتوری را دارد، اگر دایرکتوری جستجوی ناشناس را نمی‌پذیرد. مستندات پلی‌بوک
ضد هرزنامه‌ی ساده (Synapse Simple Antispam)
فقط Synapse. دعوت‌هایی را که از سرورهای فهرست‌شده می‌آیند، که منبع رایج دعوت‌های هرزنامه‌اند، نادیده می‌گیرد.
تنظیمات: سرورهای مسدود (Blocked homeservers): نام آن‌ها، جدا شده با
ویرگول، برای نمونه spam.example.com, badserver.net.
مستندات پلی‌بوک
سرویس تأیید کاربر (User Verification Service)
به یک سرور جیتسی اجازه می‌دهد بررسی کند که هر کسی وارد تماس می‌شود، واقعاً عضو اتاق ماتریکسی است که تماس به آن تعلق دارد.
تنظیمات:
- توکن دسترسی یک ربات (Access token of a bot user): با Manage › Add a
user (
a) یک حساب برای آن بسازید، در Element با آن وارد شوید و توکن آن را از Settings › Help & About › Advanced › Access Token کپی کنید. از آن نشست خارج نشوید. - توکن Auth token: به‌طور خودکار ساخته می‌شود.
پس از استقرار: برای اینکه جیتسی خودِ پلی‌بوک از آن استفاده کند، ورود ماتریکس جیتسی باید فعال باشد: بخش ماتریکس مستندات جیتسی را ببینید و آن خطوط را در Settings زیر Advanced وارد کنید. مستندات پلی‌بوک