Pentru a opri înscrierile publice pe un server Matrix auto-găzduit care rulează Synapse, configurați enable_registration: falseși homeserver.yamlreporniți Synapse. Dacă doriți ca persoanele invitate să își creeze singure conturi, lăsați înregistrarea activată, dar solicitați în schimb token-uri de înregistrare. Bifați registration_shared_secretsetarea separată: oricine o cunoaște poate crea în continuare conturi, inclusiv administratorii serverului, chiar și atunci când înregistrarea obișnuită este dezactivată.
Alegeți politica de înregistrare potrivită
Setarea corectă depinde de modul în care ar trebui create conturile noi:
- Server privat, conturi furnizate de un administrator: dezactivați înregistrarea publică. Creați utilizatori cu comanda Synapse
register_new_matrix_usersau cu un alt proces administrativ aprobat.
- Server doar pe invitație, utilizatorii se înregistrează din Element sau de la un alt client: activați înregistrarea și solicitați un token. Oferiți fiecărei persoane un token cu utilizare limitată printr-un canal privat.
- Server public: token-urile de înregistrare, CAPTCHA sau adresa de e-mail/telefonul verificat pot reduce abuzurile automate, dar nu garantează că fiecare cont este de încredere.
Acest articol prezintă Synapse, cea mai răspândită implementare de server de acasă Matrix auto-găzduit. Alte programe software pentru servere de acasă au propria configurație. Documentația actuală de configurare a Synapse precizează că înregistrarea este dezactivată în mod implicit și că token-urile de înregistrare funcționează numai atunci când înregistrarea în sine este activată. Dacă utilizați Matrix Authentication Service (MAS), verificați documentația sa pentru controalele de înregistrare corespunzătoare; API-ul de administrare a token-urilor de înregistrare al Synapse este dezactivat atunci când integrarea MAS este activată.
Dezactivați înregistrarea publică pe Synapse
- Găsiți fișierul de configurare activ. Instalările obișnuite de pachete utilizează
/etc/matrix-synapse/homeserver.yaml; instalările de containere montează adesea fișierul sub /data/homeserver.yaml. Folosiți calea configurată pentru serviciul dvs., în loc să presupuneți o singură locație.
- Faceți o copie de rezervă a fișierului, apoi setați semnalizatorul de înregistrare. În configurația YAML de nivel superior, adăugați sau modificați setarea la:
enable_registration: false
Dacă cheia există deja, editați intrarea respectivă în loc să adăugați un duplicat. Indentarea YAML și cheile duplicate pot cauza confuzie, așadar păstrați setarea la nivelul superior și păstrați structura existentă a fișierului.
- Verificați secretul de înregistrare partajat. Synapse
registration_shared_secret(sau registration_shared_secret_path) acceptă scriptul de înregistrare administrativă. Ghidul de instalare Synapse avertizează că o persoană care deține acest secret poate crea conturi standard sau de administrator chiar și atunci când înregistrarea publică este dezactivată. Păstrați-l privat, restricționați accesul la fișierul său și nu-l plasați într-un depozit public, în configurația clientului sau într-un mesaj către invitați. Dacă nu utilizați înregistrarea cu secret partajat, eliminați setarea numai după ce confirmați că nicio automatizare nu depinde de aceasta. În schimb, puteți crea conturi utilizând un alt flux de lucru de administrator acceptat.
- Validați și reporniți Synapse. Folosiți managerul de servicii, orchestrarea containerelor sau metoda de implementare care rulează serverul. Pentru un serviciu systemd denumit în mod obișnuit
matrix-synapse, un administrator ar putea rula:
sudo systemctl restart matrix-synapse
sudo systemctl status matrix-synapse --no-pager
Numele exact al serviciului diferă în funcție de implementările de pachete și containere. Verificați jurnalele dacă serviciul nu pornește; nu editați în mod repetat un fișier de configurare fără a rezolva o eroare YAML sau de configurare raportată.
Conturile existente și accesul la camere nu sunt eliminate prin dezactivarea înregistrării. Setarea previne noi înregistrări regulate prin fluxul de înregistrare a clientului; nu este un control de ștergere a utilizatorilor sau dezactivare a serverului.
Permiteți înscrierile doar cu token-uri de înregistrare
Folosește această opțiune atunci când dorești ca invitații să finalizeze singuri înregistrarea, dar nu dorești o pagină de înregistrare deschisă. În homeserver.yaml, configurează ambele setări:
enable_registration: true
registration_requires_token: true
Reporniți Synapse după salvare. O poartă cu tokenuri nu este același lucru cu dezactivarea înregistrării: persoanele cu tokenuri valide pot crea conturi. Manualul de configurare Synapse recomandă controale anti-abuz atunci când înregistrarea este activată; alegeți o politică adecvată publicului și capacității operaționale.
Pentru versiunile Synapse care acceptă API-ul documentat pentru administrarea jetoanelor de înregistrare, un administrator poate crea un jeton de unică folosință. Următorul exemplu folosește o adresă URL substituentă și un jeton de acces; rulați-l doar dintr-un mediu administrativ de încredere, înlocuiți adresa URL publică de bază a serverului dvs. de domiciliu și un jeton de acces de administrator și protejați istoricul shell-ului și jurnalele:
curl -X POST "https://matrix.example.com/_synapse/admin/v1/registration_tokens/new" \
-H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
--data '{"uses_allowed":1}'
Răspunsul include token-ul generat. Partajați această valoare în mod privat cu utilizatorul țintă. API-ul Synapse acceptă, de asemenea, un timp de expirare, măsurat în milisecunde de la epoca Unix; utilizați referința oficială API pentru a calcula și seta corect o expirare pentru implementarea dvs. Un token cu o limită de utilizare sau o expirare omisă are implicit utilizări nelimitate și nicio expirare, așadar setați limitele în mod deliberat. Administratorii pot lista, actualiza sau șterge token-uri prin intermediul aceluiași API. Nu lipiți un token purtător real sau un token de înregistrare într-o problemă sau un articol public.
Gestionarea tokenurilor are o versiune și o limită de implementare: consultați documentația API-ului de administrare corespunzător versiunii Synapse instalate. Documentația actuală menționează că acest API Synapse nu este disponibil atunci când integrarea MAS este activată; utilizați API-ul de administrare MAS sau interfața CLI în configurația respectivă.
Greșeli comune de configurare
- Schimbarea fișierului greșit: containerele pot citi un fișier montat, în timp ce gazda are o copie separată. Confirmați calea utilizată de procesul Synapse care rulează.
- Uitarea repornirii: modificările de configurație sunt citite de serviciu, așadar o editare de text reușită nu demonstrează în sine că noua politică este activă.
- Presupunând că înregistrarea dezactivată blochează fiecare rută: un secret partajat configurat rămâne o cale de creare a contului. Protejați-l sau eliminați-l în funcție de necesitatea automatizării administrative.
- Activarea token-urilor, dar dezactivarea înregistrării:
registration_requires_token nu activează independent înregistrarea. Ambele semnalizatoare trebuie să permită fluxul dorit.
- Presupunând că token-urile disponibile doar pe invitație previn orice abuz: un token reutilizabil divulgat poate fi folosit de persoane neintenționate. Limitați utilizările, setați o dată de expirare acolo unde este practic și distribuiți token-urile în mod privat.
Verificați rezultatul
După ce Synapse repornește, deschideți fluxul de înregistrare al serverului principal într-un client Matrix utilizând o sesiune deconectată. Pentru un server închis, clientul nu ar trebui să ofere o înscriere publică reușită, în timp ce utilizatorii existenți ar trebui să se poată conecta în continuare. Pentru înregistrarea bazată pe token, încercați fluxul fără token și confirmați că solicită unul; apoi utilizați un token de testare într-un cont de testare controlat și confirmați că înregistrarea a reușit. Verificați jurnalele Synapse și starea tokenului API de administrare dacă rezultatul diferă de politica intenționată. Evitați testarea cu tokenul de invitație real dacă acest lucru ar consuma singura utilizare permisă.
Referințe oficiale