سائن ان اور اکاؤنٹس

فیصلہ کریں کہ کون اکاؤنٹ بنا سکتا ہے اور لوگ کیسے سائن ان کرتے ہیں۔ Antimatter کے تمام سائن ان طریقے بغیر لائسنس کے کام کرتے ہیں، بشمولہ سنگل سائن آن اور ڈائریکٹریز۔

کون اکاؤنٹ بنا سکتا ہے

نصب کے فوراً بعد، سسٹم کنسول › تصدیق › سائن اپ چیک کریں۔ ڈیفالٹ سیٹنگز کے ساتھ، کسی بھی ایسی شخص کو اکاؤنٹ بنانے کی اجازت ہے جس کے پاس کمیونٹی کے لیے مدعو لنک ہو، لیکن بغیر مدعو کے کوئی سائن اپ نہیں کر سکتا۔

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

کمانڈ لائن سے: amctl user create (شامل کریں --system-admin یا --guest)، amctl user invite، amctl user deactivate، کسی کو سسٹم ایڈمنسٹریٹر بنانے کے لیے amctl roles system-admin <user>، اور اسے منسوخ کرنے کے لیے amctl roles member <user>۔

ای میل اور پاس ورڈ

سسٹم کنسول › تصدیق › ای میل میں:

سسٹم کنسول › تصدیق › پاس ورڈ میں:

12 یا اس سے زیادہ کی لمبائی سیکیورٹی کے لیے حروف کے قواعد سے زیادہ مؤثر ہے۔ کسی کے پاس ورڈ کو ری سیٹ کرنے کے لیے: سسٹم کنسول › صارفین کا انتظام › صارفین، یا amctl user change-password <user> --password <new>۔

ملٹی فیکٹر اتھنٹیکیشن

ملٹی فیکٹر اتھنٹیکیشن (MFA) پاس ورڈ کے ساتھ ایک اتھنٹیکٹر ایپ سے کوڈ شامل کرتا ہے۔ یہ ای میل یا AD/LDAP کے ذریعے سائن ان کرنے والے اکاؤنٹس پر لاگو ہوتا ہے؛ سنگل سائن ان کے ساتھ، اپنے آئی ڈینٹیٹی پرووائیڈر کی MFA استعمال کریں۔ سسٹم کنسول › تصدیق › MFA میں:

• Multi-factor Authentication فعال کریں (ServiceSettings.EnableMultifactorAuthentication, off): لوگ اپنے سیکیورٹی ترتیبات میں MFA کو آن کر سکتے ہیں۔
• ملٹی فیکٹر اتھنٹیکیشن کو لازمی بنائیں (ServiceSettings.EnforceMultifactorAuthentication, off): ہر کوئی اسے سیٹ اپ کرنا پڑے گا، سائن اپ کے وقت یا اگلے سائن ان پر۔

اگر کوئی اپنا ڈیوائس کھو دے: amctl user resetmfa <user>، یا سسٹم کنسول › صارفین کا انتظام › صارفین میں ان کی پیج سے اسے ری سیٹ کریں۔

سنگل سائن ان

Antimatter آپ کے آئی ڈینٹیٹی پرووائیڈر کے ذریعے لوگوں کو سائن ان کر سکتا ہے۔ پہلی بار سائن ان پر، یہ پرووائیڈر کے بھیجے ہوئے نام، ای میل اور یوزر نیم سے ان کا اکاؤنٹ بناتا ہے (اگر اکاؤنٹ کی تخلیق کی اجازت ہو)۔

OpenID Connect, GitLab, Google اور Entra ID

سسٹم کنسول › تصدیق › OpenID Connect پر جائیں، اور سروس فراہم کنندہ منتخب کریں کے تحت منتخب کریں: GitLab, Google Apps, Entra ID (Office 365) یا کسی دوسرے پرووائیڈر کے لیے OpenID Connect (دیگر) (Keycloak, Authentik, Zitadel, Okta, Auth0…)۔

1. اپنے پرووائیڈر میں، اپنے سائٹ URL کے لیے اس ری ڈائریکٹ URI کے ساتھ ویب ٹائپ کا ایک ایپلیکیشن (ایک "کلائنٹ") بنائیں:

   پرووائیڈر	ری ڈائریکٹ URI
   OpenID Connect (دیگر)	https://chat.example.com/signup/openid/complete
   GitLab	https://chat.example.com/signup/gitlab/complete
   Google	https://chat.example.com/signup/google/complete
   Entra ID	https://chat.example.com/signup/office365/complete

2. Antimatter میں، ڈسکوری اینڈ پوائنٹ (پرووائیڈر کا /.well-known/openid-configuration URL؛ GitLab کے لیے اس کے بجائے GitLab سائٹ یو آر آئی)، کلائنٹ ID اور کلائنٹ سیکرٹ بھریں۔ دوسرے پرووائیڈرز کے لیے، سائن ان بٹن کا بٹن کا نام اور Button Color بھی۔
3. ترجیحی صارف نام استعمال کریں (GitLab اور دیگر پرووائیڈرز) Antimatter یوزر نیم پرووائیڈر کے preferred_username کلائم سے لیتا ہے۔
4. محفوظ کریں، سائن آؤٹ کریں، اور سائن ان پیج پر نئے بٹن کی کوشش کریں۔

ترتیبات OpenIdSettings، GitLabSettings، GoogleSettings یا Office365Settings میں محفوظ کی جاتی ہیں (مثلاً AM_OPENIDSETTINGS_ENABLE، AM_OPENIDSETTINGS_DISCOVERYENDPOINT، AM_OPENIDSETTINGS_ID، AM_OPENIDSETTINGS_SECRET)۔ پرانا OAuth 2.0 پیج صرف ان سرورز کے لیے ظاہر ہوتا ہے جن میں اب بھی OAuth 2.0 GitLab، Google یا Entra ID کی ترتیبات موجود ہیں۔

SAML 2.0

سسٹم کنسول › تصدیق › SAML 2.0 میں SAML 2.0 کے ذریعے لاگ ان فعال کریں (SamlSettings.Enable) کو آن کریں اور اپنی Identity Provider کے ذریعے فراہم کردہ معلومات درج کریں: Identity Provider میٹا ڈیٹا URL، یا SAML SSO URL، Identity Provider آئی شوئر URL اور Identity Provider عوامی سرٹیفکیٹ۔ Identity Provider کی طرف سے:

• Service Provider Login URL (assertion consumer service): https://chat.example.com/login/sso/saml;
• Antimatter کی میٹا ڈیٹا، ان پرووائڈرز کے لیے جو اسے امپورٹ کرتے ہیں: https://chat.example.com/api/v4/saml/metadata.

اپنے پرووائڈر کے بھیجے ہوئے ایٹریبیوٹس کو میپ کریں: کم از کم ای میل ایٹریبیوٹ اور صارف نام کی خصوصیت، اور اختیاری طور پر ID، پہلا اور آخری نام، نکل نیام، عہدہ، زبان، مہمان اور ایڈمن ایٹریبیوٹس۔ دستخط کی تصدیق کریں اور انکرپشن فعال کریں پہلے سے آن ہیں (انکرپشن کے لیے service provider کی کلید اور سرٹیفکیٹ درکار ہے؛ صرف RSA کلیدز سپورٹ کی جاتی ہیں)؛ درخواست پر دستخط کریں آف ہے۔ دستخط کے الگورتھم کی پہلے سے طے شدہ ترتیب RSAwithSHA256 ہے۔

AD/LDAP

سسٹم کنسول › تصدیق › AD/LDAP میں، ایک مرحلہ وار پیج Antimatter کو Active Directory یا کسی دوسرے LDAP سرور سے جوڑتا ہے: سرور اور پورٹ (LdapSettings.LdapServer، LdapSettings.LdapPort، پہلے سے طے شدہ 389)، کنکشن کی حفاظت (کوئی نہیں، TLS یا STARTTLS)، بیس DN اور بائنڈ اکاؤنٹ (BaseDN، BindUsername، BindPassword)، صارفین، مہمانوں، ایڈمنز اور گروپس کے لیے فلٹرز، اور ای میل، صارف نام، ID، ناموں اور تصویر کے لیے ایٹریبیوٹس۔ پھر لوگ اپنے ڈائریکٹری لاگ ان کے ذریعے سائن ان کرتے ہیں۔

ہر 60 منٹ بعد (LdapSettings.SyncIntervalMinutes) ایک ہم آہنگی (synchronisation) جاب چلتی ہے تاکہ ناموں کو اپ ڈیٹ کیا جا سکے اور ڈائریکٹری سے ہٹائے گئے لوگوں کو غیر فعال کیا جا سکے؛ اسے ابھی چلانے کے لیے amctl ldap sync استعمال کریں۔ LDAP گروپس کو سسٹم کنسول › صارفین کا انتظام › گروپس میں کمیونٹیز اور چینلز سے جوڑا جا سکتا ہے۔ SAML اکاؤنٹس کو AD/LDAP کے ساتھ ہم آہنگ رکھا جا سکتا ہے (SAML اکاؤنٹس کو AD/LDAP کے ساتھ ہم آہنگ کرنا فعال کریں)۔

موجودہ اکاؤنٹس کو منتقل کرنا

موجودہ ای میل اکاؤنٹس کو سنگل سائن آن پر تبدیل کرنے کے لیے، amctl user migrate-auth email saml users.json (یا ldap) انہیں بیک وقت منتقل کر دیتا ہے۔ جب تصدیقی منتقلی کی اجازت دیں (ServiceSettings.ExperimentalEnableAuthenticationTransfer، جو سسٹم کنسول › تجرباتی › خصوصیات میں موجود ہے) فعال ہو، تو صارف اپنے سیکیورٹی ترتیبات میں اپنا سائن ان طریقہ بھی بدل سکتا ہے۔

مہمان اکاؤنٹس

مہمان وہ افراد ہیں جو آپ کی تنظیم سے باہر سے ہیں اور صرف ان چینلز کو دیکھ سکتے ہیں جن میں انہیں مدعو کیا گیا ہے۔ انہیں سسٹم کنسول › تصدیق › مہمان رسائی میں فعال کریں:

ایک بار فعال ہونے کے بعد، کمیونٹی ایڈمن مہمانوں کو مخصوص چینلز میں مدعو کرتے ہیں۔ ایڈمنسٹریٹرز amctl user demote کے ذریعے کسی رکن کو مہمان بن سکتے ہیں، اور amctl user promote کے ذریعے کسی مہمان کو رکن بن سکتے ہیں۔

سیشنز

لوگ کتنی دیر تک سائنڈ ان رہتے ہیں، یہ سسٹم کنسول › ماحول › سیشن کی مدت میں طے کیا جاتا ہے:

سب کو ایک ساتھ سائن آؤٹ کرنے کے لیے، سسٹم کنسول › صارفین کا انتظام › صارفین میں تمام سیشنز منسوخ کریں استعمال کریں۔ کسی ایک شخص کو سائن آؤٹ کرنے کے لیے، وہاں اس کا صفحہ کھولیں۔