Bejelentkezés és fiókok
Döntse el, hogy ki hozhat létre fiókot, és hogyan történik a bejelentkezés. Az Antimatter minden bejelentkezési módja licenc nélkül működik, beleértve a single sign-on-t és a könyvtárakat is.
Ki hozhat létre fiókot
A telepítés után ellenőrizze a Rendszerkonzol › Hitelesítés › Regisztráció menüpontot. Az alapértelmezésekkel bárki, aki rendelkezik egy közösségre szóló meghívóhivatkozással, létrehozhat fiókot, de meghívó nélkül senki nem regisztrálhat.
| Beállítás | Kulcs | Alapérték | Mire szolgál |
|---|---|---|---|
| Fiók létrehozás engedélyezése | TeamSettings.EnableUserCreation | bekapcsolva | Ki: senki nem hozhat létre fiókot egyetlen módszerrel sem; csak az adminisztrátorok tehetik meg (Rendszerkonzol vagy amctl user create). |
| Nyílt szerver engedélyezése | TeamSettings.EnableOpenServer | ki | Be: bárki, aki eléri a szervert, regisztrálhat e-mail-címmel, meghívó nélkül. Csak nyilvános közösségek esetén használja. |
| Új rendszer- és csapattagok korlátozása megadott e-mail-doménekre | TeamSettings.RestrictCreationToDomains | üres | Vesszővel elválasztott domének, például example.com, example.org: csak ezeknek a doméneknek a címei hozhatnak létre fiókot. |
| E-mail meghívók engedélyezése | ServiceSettings.EnableEmailInvitations | új szerveren ki | Lehetővé teszi, hogy a tagok e-mailben hívjanak meg embereket (ezhez SMTP szükséges). A Függőben lévő e-mail meghívók érvénytelenítése opció visszavonja a még nem elfogadott meghívókat; ezek mindenesetre 48 óra múlva lejárnak. |
A közösségi adminisztrátorok ők is irányítják, hogy ki csatlakozik a közösségükhöz, meghívóhivatkozásokkal és saját engedélyezett doméneikkel: lásd a Közösség üzemeltetése útmutatót.
Parancssorból: amctl user create (adja hozzá a --system-admin vagy --guest kapcsolót), amctl user invite, amctl user deactivate, amctl roles system-admin <user> valakinek a rendszeradminisztrátorrá tételéhez, és amctl roles member <user> a visszavonáshoz.
E-mail és jelszó
A Rendszerkonzol › Hitelesítés › E-mail menüpontban:
| Beállítás | Kulcs | Alapérték |
|---|---|---|
| Engedélyezze a fiók létrehozását e-maillel | EmailSettings.EnableSignUpWithEmail | be. Kapcsolja ki, ha mindenki single sign-on-nal jelentkezik be. |
| E-mail ellenőrzés megkövetelése | EmailSettings.RequireEmailVerification | ki. Kapcsolja be, miután az e-mail működik: ekkor a felhasználóknak először megerősítik az e-mail-címüket, mielőtt bejelentkezhetnének. |
| Bejelentkezés engedélyezése e-maillel | EmailSettings.EnableSignInWithEmail | bekapcsolva |
| Bejelentkezés engedélyezése felhasználónévvel | EmailSettings.EnableSignInWithUsername | bekapcsolva |
A Rendszerkonzol › Hitelesítés › Jelszó menüpontban:
| Beállítás | Kulcs | Alapérték |
|---|---|---|
| Minimális jelszóhossz | PasswordSettings.MinimumLength | 8 (5-től 72-ig) |
| Jelszó követelmények: kisbetű, nagybetű, szám, speciális karakter | PasswordSettings.Lowercase, .Uppercase, .Number, .Symbol | minden kikapcsolva |
| Bejelentkezési kísérletek maximális száma | ServiceSettings.MaximumLoginAttempts | 10: ennyi sikertelen kísérlet után a fiók addig zárolva marad, amíg e-mailben vissza nem állítják a jelszót |
| Jelszó visszaállítása hivatkozás engedélyezése | PasswordSettings.EnableForgotLink | bekapcsolva |
A 12 vagy több karakter hosszúság többet tesz a biztonságért, mint a karakteres szabályok. Valakinek a jelszavát így állíthatod vissza: Rendszerkonzol › Felhasználókezelés › Felhasználók, vagy a amctl user change-password <user> --password <new> paranccsal.
Tényezős hitelesítés
A tényezős hitelesítés (MFA) a jelszó mellé egy hitelesítő alkalmazásból származó kódot is megkövetel. Az e-maillel vagy AD/LDAP-vel bejelentkező fiókokra vonatkozik; egységes bejelentkezés (SSO) esetén az identitásszolgáltató MFA-ját használd. A Rendszerkonzol › Hitelesítés › MFA menüben:
- Többtényezős hitelesítés engedélyezése (
ServiceSettings.EnableMultifactorAuthentication, kikapcsolva): a felhasználók bekapcsolhatják a többtényezős hitelesítést a biztonsági beállításokban. - Többtényezős hitelesítés kényszerítése (
ServiceSettings.EnforceMultifactorAuthentication, kikapcsolva): mindenki be kell, hogy állítsa, a regisztráció során vagy a következő bejelentkezéskor.
Ha valaki elveszíti az eszközét: amctl user resetmfa <user>, vagy a Rendszerkonzol › Felhasználókezelés › Felhasználók menüben, a felhasználó oldaláról állíthatod vissza.
Egységes bejelentkezés
Az Antimatter az identitásszolgáltatódn keresztül hitelesítheti a felhasználókat. Az első bejelentkezéskor (ha a fiók létrehozása engedélyezett) a szolgáltató által küldött név, e-mail-cím és felhasználónév alapján hozza létre a fiókjukat.
OpenID Connect, GitLab, Google és Entra ID
Lépjen a Rendszerkonzol › Hitelesítés › OpenID Connect menüpontra, és a Szolgáltató kiválasztása alatt válassza a GitLabot, a Google Apps-t, az Entra ID-t (Office 365) vagy az OpenID Connect (Egyéb) lehetőséget bármely más szolgáltatóhoz (Keycloak, Authentik, Zitadel, Okta, Auth0 stb.).
- Az identitásszolgáltatódnál hozz létre egy web típusú alkalmazást („clientet”) az alábbi átirányítási URI-val, a weboldalad URL-éhez:
Szolgáltató Átirányítási URI OpenID Connect (Egyéb) https://chat.example.com/signup/openid/completeGitLab https://chat.example.com/signup/gitlab/completeGoogle https://chat.example.com/signup/google/completeEntra ID https://chat.example.com/signup/office365/complete - Az Antimatterben tölje ki a Felfedezési végpontot (a szolgáltató
/.well-known/openid-configurationURL-je; GitLab esetén a GitLab rendszer URL), a Kliens azonosítót és a Kliens titkot. Egyéb szolgáltatók esetén a bejelentkezési gomb Gomb neve és Gomb színe mezőit is kitölti. - A Használja a preferált felhasználónevet (GitLab és más szolgáltatók) beállítás az Antimatter-felhasználónevet a szolgáltató
preferred_usernameállításából veszi. - Mentsd el, jelezz be, és próbáld ki az új gombot a bejelentkezési oldalon.
A beállítások a OpenIdSettings, GitLabSettings, GoogleSettings vagy Office365Settings objektumban tárolódnak (például AM_OPENIDSETTINGS_ENABLE, AM_OPENIDSETTINGS_DISCOVERYENDPOINT, AM_OPENIDSETTINGS_ID, AM_OPENIDSETTINGS_SECRET). A régebbi OAuth 2.0 oldal csak azokon a szervereken jelenik meg, amelyeknél még van OAuth 2.0 alapú GitLab, Google vagy Entra ID konfiguráció.
SAML 2.0
A Rendszerkonzol › Hitelesítés › SAML 2.0 menüben kapcsolja be a Bejelentkezés engedélyezése SAML 2.0-val opciót (SamlSettings.Enable), és tölje ki az azonosító-szolgáltató által megadott adatokat: a Személyazonosság szolgáltató (IdP) metaadat URL-t, vagy a SAML SSO URL-t, a Személyazonosság szolgáltató (IdP) kiállítási URL-t és a Személyazonosság szolgáltató (IdP) nyilvános tanúsítványt. Az azonosító-szolgáltató oldalán:
- Szolgáltatásfelhasználó bejelentkezési URL (assertion consumer service):
https://chat.example.com/login/sso/saml; - Az Antimatter metaadatai, az olyan szolgáltatók számára, amelyek importálják:
https://chat.example.com/api/v4/saml/metadata.
Állítsa be a szolgáltató által küldött attribútumok leképezését: legalább az E-mail attribútumot és a Felhasználónév attribútumot, valamint opcionálisan az azonosító, a keresztnév, a vezetéknév, a becenév, a pozíció, a nyelv, a vendég és az admin attribútumokat. A Aláírás ellenőrzés és a Titkosítás engedélyezése alapértelmezetten bekapcsolva van (a titkosítás szolgáltatói kulcsot és tanúsítványt igényel; csak RSA kulcsokat támogat); az Aláírás kérelem kikapcsolva van. Az aláírási algoritmus alapértelmezése RSAwithSHA256.
AD/LDAP
A Rendszerkonzol › Hitelesítés › AD/LDAP menüben egy lépésről lépésre haladó oldal csatlakoztatja az Antimattert az Active Directory-hez vagy más LDAP-szerverhez: a szerver és a port (LdapSettings.LdapServer, LdapSettings.LdapPort, alapértelmezés szerint 389), a kapcsolat biztonsági beállításai (semmi, TLS vagy STARTTLS), az alap DN és egy bind-fiók (BaseDN, BindUsername, BindPassword), a felhasználók, vendégek, adminok és csoportok szűrői, valamint az e-mail, felhasználónév, ID, nevek és kép attribútumai. A felhasználók ekkor a könyvtárbeli bejelentkezési adataikkal jelentkeznek be.
A szinkronizálási feladat 60 percenként (LdapSettings.SyncIntervalMinutes) fut le, hogy frissítse a neveket, és letiltsa a könyvtárból eltávolított személyeket; most futtatható a amctl ldap sync paranccsal. Az LDAP-csoportok a Rendszerkonzol › Felhasználókezelés › Csoportok menüben kapcsolhatók közösségekhez és csatornákhoz. A SAML-fiókok is szinkronban tarthatók az AD/LDAP-pal (SAML fiókok AD/LDAP-pal való szinkronizálásának engedélyezése).
Meglévő fiókok áthelyezése
A meglévő e-mail alapú fiókok egységes bejelentésre (single sign-on) való átkötéséhez a amctl user migrate-auth email saml users.json (vagy ldap) parancs hajtja végre tömegben. Egy felhasználó a saját bejelentkezési módját is megváltoztathat a biztonsági beállításai között, ha be van kapcsolva a Hitelesítés átvitel engedélyezése (ServiceSettings.ExperimentalEnableAuthenticationTransfer, a Rendszerkonzol › Kísérleti › Funkciók menüben).
Vendégfiókok
A vendégek a szervezeteden kívüli személyek, akik csak azokat a csatornákat látják, ahová meghívták őket. Ezek bekapcsolhatók a Rendszerkonzol › Hitelesítés › Vendég hozzáférés (Béta) menüben:
| Beállítás | Kulcs | Alapérték |
|---|---|---|
| Vendég hozzáférés engedélyezése | GuestAccountsSettings.Enable | ki |
| Engedélyezett vendég domainek | GuestAccountsSettings.RestrictCreationToDomains | üres: a vendégek bármilyen e-mail-domennelet használhatnak |
| Többtényezős hitelesítés kényszerítése | GuestAccountsSettings.EnforceMultifactorAuthentication | ki; csak akkor érhető el, ha a többfaktoros hitelesítés (MFA) mindenki számára be van kapcsolva és kikényszerítve |
| Vendégcímke elrejtése | GuestAccountsSettings.HideTags | ki: a nevük mellett megjelenik egy „vendég” jelvény |
Miután bekapcsolva, a közösségi adminisztrátorok a vendégeket konkrét csatornákba hívhatják meg. Az adminisztrátorok a amctl user demote parancsbaléphetik tagot vendéggé, a amctl user promote parancsbaléphetik vendéget taggá.
Munkamenetek
A bejelentkezések élettartama a Rendszerkonzol › Környezet › Munkamenet hosszak menüben állítható be:
| Beállítás | Kulcs | Alapértelmezett egy új szerveren |
|---|---|---|
| Munkamenetek meghosszabbítása aktivitással | ServiceSettings.ExtendSessionLengthWithActivity | be: a munkamenetek megújulnak, amíg a felhasználók az Antimattert használják |
| Munkamenet hossza AD/LAP és e-mail alapú bejelentkezés esetén (óra) | ServiceSettings.SessionLengthWebInHours | 720 óra (30 nap) |
| Munkamenet hossza Mobil klienshez (óra) | ServiceSettings.SessionLengthMobileInHours | 720 óra |
| Munkamenet hossza SSO alapú bejelentkezés esetén (óra) | ServiceSettings.SessionLengthSSOInHours | 720 óra |
| Munkamenet üresjárati időtúllépés (perc) | ServiceSettings.SessionIdleTimeoutInMinutes | 43200 perc (30 nap); csak akkor jelenik meg, ha a munkamenetek nem újulnak meg aktivitás alapján |
| Munkamenetek lezárása jelszómódosításkor | ServiceSettings.TerminateSessionsOnPasswordChange | bekapcsolva |
Ha egyszerre mindenkit szeretnél kijelentkeztetni, használd a Összes munkamenet visszavonása funkciót a Rendszerkonzol › Felhasználókezelés › Felhasználók menüben. Egyetlen felhasználó kijelentkeztetéséhez nyisd meg az ő profilját ott.