Sluit Matrix-aanmeldingen af ​​of vereis uitnodigingstokens op Synapse.

Om te voorkomen dat mensen zich aanmelden op een zelfgehoste Matrix-homeserver met Synapse, moet je dit instellen enable_registration: falseen homeserver.yamlSynapse opnieuw opstarten. Als je wilt dat uitgenodigde personen zelf accounts aanmaken, laat je registratie ingeschakeld, maar vereis je in plaats daarvan registratietokens. Controleer de aparte registration_shared_secretinstelling: iedereen die deze kent, kan nog steeds accounts aanmaken, inclusief serverbeheerders, zelfs als gewone registratie is uitgeschakeld.

Kies het juiste registratiebeleid.

De juiste instelling hangt af van hoe nieuwe accounts moeten worden aangemaakt:

  • Privéserver, accounts aangemaakt door een beheerder: openbare registratie uitschakelen. Gebruikers aanmaken met een Synapse- register_new_matrix_useropdracht of een ander goedgekeurd beheerproces.
  • Server alleen toegankelijk op uitnodiging; gebruikers registreren zich via Element of een andere client: schakel registratie in en vereis een token. Geef elke persoon een token voor beperkt gebruik via een privékanaal.
  • Openbare server: registratietokens, CAPTCHA of geverifieerd e-mailadres/telefoonnummer kunnen geautomatiseerd misbruik verminderen, maar ze garanderen niet dat elk account betrouwbaar is.

Dit artikel behandelt Synapse, de meest gebruikte zelfgehoste Matrix-homeserverimplementatie. Andere homeserversoftware heeft zijn eigen configuratie. De huidige configuratiedocumentatie van Synapse vermeldt dat registratie standaard is uitgeschakeld en dat registratietokens alleen werken wanneer registratie zelf is ingeschakeld. Als u Matrix Authentication Service (MAS) gebruikt, raadpleeg dan de bijbehorende documentatie voor de registratie-instellingen; de Admin API voor registratietokens van Synapse is uitgeschakeld wanneer MAS-integratie is ingeschakeld.

Schakel openbare registratie op Synapse uit.

  1. Zoek het actieve configuratiebestand. Bij de meeste pakketinstallaties wordt het bestand gebruikt /etc/matrix-synapse/homeserver.yaml; bij containerinstallaties wordt het bestand vaak gekoppeld aan de map /data/homeserver.yaml. Gebruik het pad dat voor uw service is geconfigureerd in plaats van uit te gaan van één specifieke locatie.
  2. Maak een back-up van het bestand en stel vervolgens de registratievlag in. Voeg in de hoofdconfiguratie van het YAML-bestand de volgende instelling toe of wijzig deze:
    enable_registration: false
    Als de sleutel al bestaat, bewerk dan die vermelding in plaats van een duplicaat toe te voegen. Inspringen in YAML en dubbele sleutels kunnen verwarring veroorzaken, dus houd de instelling op het hoogste niveau en behoud de bestaande structuur van het bestand.
  3. Controleer het gedeelde registratiegeheim. Synapse registration_shared_secret(of registration_shared_secret_path) ondersteunt het administratieve registratiescript. De installatiehandleiding van Synapse waarschuwt dat iemand met dit geheim standaard- of beheerdersaccounts kan aanmaken, zelfs als openbare registratie is uitgeschakeld. Houd het geheim privé, beperk de toegang tot het bestand en plaats het niet in een openbare repository, clientconfiguratie of een bericht aan genodigden. Als u geen gebruikmaakt van registratie met een gedeeld geheim, verwijder de instelling dan pas nadat u hebt bevestigd dat er geen automatisering van afhankelijk is. U kunt in plaats daarvan accounts aanmaken met behulp van een andere ondersteunde beheerdersworkflow.
  4. Valideer en herstart Synapse. Gebruik de servicemanager, containerorkestratie of implementatiemethode die op uw server draait. Voor een systemd-service die vaak de naam heeft matrix-synapse, kan een beheerder het volgende uitvoeren:
    sudo systemctl restart matrix-synapse
    sudo systemctl status matrix-synapse --no-pager
    De exacte servicenaam verschilt per pakket- en containerimplementatie. Controleer de logbestanden als de service niet start; blijf niet herhaaldelijk een configuratiebestand bewerken zonder een gemelde YAML- of configuratiefout op te lossen.

Bestaande accounts en toegang tot ruimtes worden niet verwijderd door de registratie uit te schakelen. De instelling voorkomt nieuwe, reguliere registraties via het klantregistratieproces; het is geen functie voor het verwijderen van gebruikers of het deactiveren van de server.

Sta aanmeldingen alleen toe met registratietokens.

Gebruik deze optie wanneer u wilt dat genodigden zich zelf aanmelden, maar geen open registratiepagina wilt. homeserver.yamlConfigureer in beide instellingen:

enable_registration: true
registration_requires_token: true

Herstart Synapse na het opslaan. Een tokengate is niet hetzelfde als het uitschakelen van registratie: mensen met geldige tokens kunnen accounts aanmaken. De configuratiehandleiding van Synapse adviseert anti-misbruikmaatregelen wanneer registratie is ingeschakeld; kies een beleid dat past bij uw doelgroep en operationele capaciteit.

Voor Synapse-versies die de gedocumenteerde Registration Tokens Admin API ondersteunen, kan een beheerder een eenmalig te gebruiken token aanmaken. Het volgende voorbeeld gebruikt een placeholder-URL en een toegangstoken; voer dit alleen uit vanuit een vertrouwde beheerdersomgeving, vervang de URL door de openbare basis-URL van uw homeserver en een beheerderstoegangstoken, en bescherm de shellgeschiedenis en logboeken:

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}'

Het antwoord bevat het gegenereerde token. Deel deze waarde privé met de beoogde gebruiker. De API van Synapse ondersteunt ook een vervaltijd, gemeten in milliseconden sinds de Unix-epoch; gebruik de officiële API-referentie om de vervaltijd voor uw implementatie correct te berekenen en in te stellen. Een token zonder gebruikslimiet of vervaltijd heeft standaard onbeperkt gebruik en geen vervaltijd, dus stel limieten bewust in. Beheerders kunnen tokens via dezelfde API weergeven, bijwerken of verwijderen. Plak geen daadwerkelijk bearer-token of registratietoken in een openbaar probleem of artikel.

Tokenbeheer kent versie- en implementatiebeperkingen: raadpleeg de documentatie van de Admin API die overeenkomt met uw geïnstalleerde Synapse-release. De huidige documentatie vermeldt dat deze Synapse API niet beschikbaar is wanneer MAS-integratie is ingeschakeld; gebruik in dat geval de MAS Admin API of CLI.

Veelvoorkomende configuratiefouten

  • Het verkeerde bestand wijzigen: containers kunnen een gekoppeld bestand lezen, terwijl de host een aparte kopie heeft. Controleer het pad dat door het actieve Synapse-proces wordt gebruikt.
  • Vergeet de herstart: configuratiewijzigingen worden door de service gelezen, dus een succesvolle tekstbewerking alleen bewijst niet dat het nieuwe beleid actief is.
  • Ervan uitgaande dat uitgeschakelde registratie alle routes blokkeert: een geconfigureerd gedeeld geheim blijft een pad voor het aanmaken van accounts. Bescherm of verwijder het, afhankelijk van of administratieve automatisering het nodig heeft.
  • Tokens inschakelen maar registratie uitschakelen: registration_requires_token dit schakelt registratie niet automatisch in. Beide vlaggen moeten de beoogde workflow toestaan.
  • Ervan uitgaande dat tokens die alleen op uitnodiging beschikbaar zijn misbruik voorkomen: een uitgelekt herbruikbaar token kan door onbedoelde personen worden gebruikt. Beperk het gebruik, stel waar mogelijk een vervaldatum in en deel tokens privé uit.

Controleer het resultaat

Nadat Synapse opnieuw is opgestart, opent u de registratieprocedure van uw thuisserver in een Matrix-client met een uitgelogde sessie. Voor een gesloten server zou de client geen succesvolle openbare registratie moeten weergeven, terwijl bestaande gebruikers zich nog wel zouden moeten kunnen aanmelden. Voor registratie met een token probeert u de procedure zonder token en controleert u of er om een ​​token wordt gevraagd; gebruik vervolgens een testtoken in een gecontroleerd testaccount en controleer of de registratie slaagt. Controleer de Synapse-logboeken en de tokenstatus van de Admin API als het resultaat afwijkt van het beoogde beleid. Vermijd testen met het echte uitnodigingstoken als dit het enige toegestane gebruik ervan zou verbruiken.

Officiële referenties

Laat een reactie achter

Sluit Matrix-aanmeldingen af ​​of vereis uitnodigingstokens op Synapse.

Stop met het aanmaken van open accounts op een zelfgehoste Synapse-server, of beperk aanmeldingen tot uitnodigingen met registratietokens voor beperkt gebruik.

Waarschuwing voor Element-sessie-identiteit: verifieer uw aanmelding veilig.

Verwijder de waarschuwing van Element voor niet-geverifieerde sessies met behulp van een vertrouwd apparaat of herstelsleutel, met controles die uw versleutelde chatgeschiedenis beschermen.

Voorkom time-outs bij het vergrendelen van bestanden in ownCloud met de juiste backend.

Onderscheid conflicten over databasevergrendelingen van verlopen WebDAV-vergrendelingen en kies en configureer vervolgens de juiste ownCloud 10-oplossing.

Wat te controleren als ownCloud Web een lege pagina weergeeft?

Wat te controleren als ownCloud Web een lege pagina weergeeft?

Traceer een leeg ownCloud-webscherm naar de browsercache, ontbrekende webonderdelen, servicefouten of URL-instellingen van de reverse proxy met gerichte controles.

Wis de ownCloud PHP-geheugenwaarschuwing in de juiste runtime.

Stel de PHP-geheugenlimiet voor de webserver van ownCloud in, herstart de bijbehorende service en controleer de actieve waarde zonder deze te verwarren met CLI-instellingen of uploadlimieten.

Problemen met de MySQL-verbinding van ownCloud 10 oplossen

Ontdek of MySQL, PHP, socketinstellingen of databaserechten ownCloud 10 blokkeren en controleer vervolgens een veilige oplossing.

Stel een vaste vervaldatum in voor openbare ownCloud-links.

Stel een vaste vervaldatum in voor openbare ownCloud-links.

Maak het verlopen van openbare links verplicht in ownCloud Classic, stel een maximale levensduur in en controleer bestaande gedeelde mappen die mogelijk apart moeten worden opgeschoond.

Voeg TOTP-tweefactorauthenticatie toe aan ownCloud Infinite Scale met Keycloak.

Voeg TOTP-tweefactorauthenticatie toe aan ownCloud Infinite Scale met Keycloak.

Schakel TOTP in via Keycloak, registreer gebruikers veilig en begrijp wanneer de MFA-instellingen op routeniveau van Infinite Scale van toepassing zijn.

Herstel ownCloud-synchronisatie door de client aan uw server te koppelen.

Controleer of het probleem te wijten is aan een compatibiliteitsprobleem tussen OC10 en 7.x of aan een beschadigd CSync-logboek, en pas vervolgens de juiste oplossing toe zonder gesynchroniseerde bestanden te verwijderen.

Beveilig ownCloud met HTTPS via Let's Encrypt en Nginx.

Beveilig ownCloud met HTTPS via Let's Encrypt en Nginx.

Kies HTTP-01 of DNS-01, configureer een ownCloud reverse proxy en controleer of Certbot HTTPS-certificaten automatisch vernieuwt.