Giriş ve hesaplar

Kimlerin hesap oluşturabileceğine ve insanların nasıl giriş yapacağına karar verin. Antimatter'ın her giriş yöntemi, tek oturum açma ve dizinler dahil olmak üzere, bir lisans gerektirmeden çalışır.

Kim hesap oluşturabilir

Kurulumdan hemen sonra Sistem Konsolu › Kimlik doğrulama › Hesap açın bölümüne bakın. Varsayılan ayarlarla, topluluğa ait bir davet bağlantısına sahip herkes hesap oluşturabilir, ancak bağlantı olmadan kimse hesap açamaz.

Topluluk yöneticileri de topluluklarına kimlerin katılacağını davet bağlantıları ve kendi izin verilen alanları aracılığıyla kontrol eder: Bir topluluk yönetme kılavuzuna bakın.

Komut satırından: amctl user create (--system-admin veya --guest ekleyin), amctl user invite, amctl user deactivate, birini sistem yöneticisi yapmak için amctl roles system-admin <user> ve bunu geri almak için amctl roles member <user>.

E-posta ve şifre

Sistem Konsolu › Kimlik doğrulama › E-posta bölümünde:

Sistem Konsolu › Kimlik doğrulama › Parola bölümünde:

12 veya daha fazla karakterli bir parola, karakter kurallarından daha fazla güvenlik sağlar. Birinin parolasını sıfırlamak için: Sistem Konsolu › Kullanıcı yönetimi › Kullanıcılar veya amctl user change-password <user> --password <new> komutunu kullanın.

Çok faktörlü kimlik doğrulama

Çok adımlı doğrulama (MFA), parolaya bir doğrulayıcı uygulamasından gelen bir kod ekler. E-posta veya AD/LDAP ile oturum açan hesaplara uygulanır; tek oturum açma (SSO) kullanılıyorsa, kimlik sağlayıcınızın MFA'sını kullanın. Sistem Konsolu › Kimlik doğrulama › Çok adımlı doğrulama bölümünde:

• Çok adımlı doğrulama kullanılsın (ServiceSettings.EnableMultifactorAuthentication, kapalı): kişiler, güvenlik ayarlarında MFA'yı etkinleştirebilir.
• Çok adımlı doğrulama dayatılsın (ServiceSettings.EnforceMultifactorAuthentication, kapalı): herkes, hesap açarken veya sonraki oturum açmada bunu yapılandırmak zorundadır.

Birinin cihazını kaybetmesi durumunda: amctl user resetmfa <user> komutunu kullanın veya Sistem Konsolu › Kullanıcı yönetimi › Kullanıcılar bölümündeki sayfasından sıfırlayın.

Tek oturum açma

Antimatter, kullanıcıları kimlik sağlayıcınız üzerinden giriş yapabilir. İlk girişte, sağlayıcının gönderdiği ad, e-posta ve kullanıcı adından hesap oluşturur (hesap oluşturma izni verilmişse).

OpenID Connect, GitLab, Google ve Entra ID

Sistem Konsolu › Kimlik doğrulama › OpenID Connect bölümüne gidin ve Hizmet sağlayıcıyı seçin altında şunlardan birini seçin: GitLab, Google Apps, Entra ID (Office 365) veya diğer herhangi bir sağlayıcı için (Keycloak, Authentik, Zitadel, Okta, Auth0…) OpenID Connect (diğer).

1. Sağlayıcınızda, web türünde bir uygulama ("istemci") oluşturun ve sitenizin URL'si için şu yönlendirme URI'sini kullanın:

   Sağlayıcı	Yönlendirme URI
   OpenID Connect (Diğer)	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'da Keşif uç noktası (sağlayıcının /.well-known/openid-configuration adresi; GitLab için bunun yerine GitLab sitesi adresi), İstemci kimliği ve İstemci parolası alanlarını doldurun. Diğer sağlayıcılar için ayrıca oturum açma düğmesinin Düğme adı ve Düğme rengi değerlerini de girin.
3. Yeğlenen kullanıcı adı kullanılsın (GitLab ve diğer sağlayıcılar), Antimatter kullanıcı adını sağlayıcının preferred_username alanından alır.
4. Kaydedin, çıkış yapın ve giriş sayfasındaki yeni düğmeyi deneyin.

Ayarlar OpenIdSettings, GitLabSettings, GoogleSettings veya Office365Settings içinde saklanır (örneğin AM_OPENIDSETTINGS_ENABLE, AM_OPENIDSETTINGS_DISCOVERYENDPOINT, AM_OPENIDSETTINGS_ID, AM_OPENIDSETTINGS_SECRET). Eski OAuth 2.0 sayfası yalnızca hâlâ OAuth 2.0 GitLab, Google veya Entra ID yapılandırmasına sahip sunucularda görünür.

SAML 2.0

Sistem Konsolu › Kimlik doğrulama › SAML 2.0 bölümünde SAML 2.0 ile oturum açılabilsin (SamlSettings.Enable) seçeneğini etkinleştirin ve kimlik hizmeti sağlayıcınızın size verdiği bilgileri girin: Kimlik hizmeti sağlayıcının üst veri adresi veya SAML tek oturum açma adresi, Kimlik hizmeti sağlayıcının yayınlayan adresi ve Herkese açık kimlik hizmeti sağlayıcı sertifikası. Kimlik hizmeti sağlayıcısı tarafında:

• Hizmet Sağlayıcısı Giriş URL’si (assertion consumer service): https://chat.example.com/login/sso/saml;
• İçe aktaran sağlayıcılar için Antimatter meta verileri: https://chat.example.com/api/v4/saml/metadata.

Sağlayıcınızın gönderdiği öznitelikleri eşleştirin: en azından E-posta özniteliği ve Kullanıcı adı özniteliği, isteğe bağlı olarak da kimlik, ad, soyad, takma ad, pozisyon, dil, konuk ve yönetici öznitelikleri. İmza doğrulansın ve Şifreme kullanılsın seçenekleri varsayılan olarak açıktır (şifreleme, bir hizmet sağlayıcı anahtarı ve sertifikası gerektirir; yalnızca RSA anahtarları desteklenir); İmzalama isteği ise kapalıdır. İmza algoritması varsayılan olarak RSAwithSHA256'tır.

AD/LDAP

Sistem Konsolu › Kimlik doğrulama › AD/LDAP bölümünde, Antimatter'i Active Directory veya başka bir LDAP sunucusuna bağlayan adım adım bir sayfa bulunur: sunucu ve port (LdapSettings.LdapServer, LdapSettings.LdapPort, varsayılan 389), bağlantı güvenliği (yok, TLS veya STARTTLS), temel DN ve bir bağlama hesabı (BaseDN, BindUsername, BindPassword), kullanıcılar, konuklar, yöneticiler ve gruplar için filtreler, e-posta, kullanıcı adı, kimlik, adlar ve fotoğraf için öznitelikler. Kullanıcılar ardından dizin oturum bilgileriyle giriş yapar.

İsimleri güncellemek ve dizinden kaldırılan kişileri devre dışı bırakmak için her 60 dakikada bir (LdapSettings.SyncIntervalMinutes) bir eşitleme işi çalışır; bunu şimdi amctl ldap sync komutuyla çalıştırabilirsiniz. LDAP grupları, Sistem Konsolu › Kullanıcı yönetimi › Gruplar bölümünde topluluklara ve kanallara bağlanabilir. SAML hesapları da AD/LDAP ile eşitlenebilir (SAML hesapları AD/LDAP ile eşitlensin).

Mevcut hesapların taşınması

Mevcut e-posta hesaplarını tek oturum açmaya geçirmek için amctl user migrate-auth email saml users.json (veya ldap) komutuyla toplu olarak taşıyabilirsiniz. Kimlik doğrulaması aktarılabilsin (ServiceSettings.ExperimentalEnableAuthenticationTransfer, Sistem Konsolu › Deneysel › Özellikler bölümünde) seçeneği açık olduğunda, bir kullanıcı kendi giriş yöntemini güvenlik ayarlarından değiştirebilir.

Konuk hesapları

Konuklar, organizasyonunuzun dışından gelen ve yalnızca davet edildikleri kanalları gören kişilerdir. Bunları Sistem Konsolu › Kimlik doğrulama › Konuk erişimi bölümünde etkinleştirin:

Etkinleştirildiğinde, topluluk yöneticileri konukları belirli kanallara davet eder. Yöneticiler, amctl user demote komutuyla bir üyeyi konuk, amctl user promote komutuyla ise bir konuğu üye yapabilir.

Oturumlar

Kullanıcıların ne kadar süre oturumda kalacağı Sistem panosu › Ortam › Oturum süreleri bölümünde ayarlanır:

Tüm kullanıcıları aynı anda oturumdan çıkarmak için Sistem panosu › Kullanıcı yönetimi › Kullanıcılar bölümündeki Tüm oturumları kapat seçeneğini kullanın. Tek bir kullanıcıyı oturumdan çıkarmak için orada profil sayfasını açın.