Installatiehandleiding

Eerste aanmelding en beheer

De eerste beheerder, upgrades, back-ups, coming soon en het beveiligingsbeleid.

De eerste beheerder

Registreren kan alleen met een uitnodigingscode, en de codes worden in de console aangemaakt — die nog niemand kan openen. De eerste code wordt op de computer zelf aangemaakt.

  1. Image: op de server, in de hoofdmap van de repository, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Map: in PowerShell, in de map, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. De opdracht drukt een code af in de vorm XXXX-XXXX-XXXX; invite-code 5 drukt er vijf af.
  4. Klik in het portaal op Inloggen en daarna op Account aanmaken: voer de code in, registreer u met het e-mailadres uit ADMINISTRATORS en bevestig het met de code uit de verificatie-e-mail.
  5. Meld u aan: Diagnostiek, onderaan elke pagina, opent de console, waar de andere uitnodigingscodes worden aangemaakt.

Tip Komt de verificatie-e-mail niet aan, controleer dan het wachtwoord van de mailbox: de aanmeldservice meldt bij het starten wanneer het ontbreekt.

Upgraden

Een upgrade vervangt de image en behoudt de gegevens: die staan in het volume van de container, dat bij het project hoort en niet bij de image.

  1. Bouw op de ontwikkelcomputer, met de bijgewerkte repository, de nieuwe image: .\rebuild_container_release.ps1 -NoSeedData.
  2. Kopieer hem naar de server, controleer hem en laad hem zoals de eerste keer: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Start met dezelfde opdracht als de eerste keer: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d merkt de nieuwe image op en maakt de container opnieuw aan, met een onderbreking van enkele seconden.
  4. Open de console op het tabblad Upgrade: waar een regel Upgrade beschikbaar toont, klikt u op Upgrade uitvoeren — tot dan blijven de gegevensfuncties van die service uitgeschakeld.

Tip Controleer vóór elke upgrade in de diagnostiek of de kopieën van de databases in orde zijn (de kaart “Kopieën van de databases”) en kopieer de bestanden: de upgrade van de databases werkt op een kopie en bewaart het origineel tot de kopie is gecontroleerd, maar de kopieën zijn uw eigen weg terug.

Kopieën en terugzetten

Elke dienst houdt een doorlopende kopie bij van de databases die hij beheert — accounts, documentindexen, e-mail, chats — met hooguit ongeveer een seconde achterstand, en kan die terugzetten naar elk moment van de afgelopen zeven dagen. De bestanden zelf — documenten, bijlagen, voorbeeldweergaven — worden één keer geschreven en veranderen nooit: ze worden apart gekopieerd, of staan in een S3-bucket.

  1. Haal de kopieën van de databases van de computer af: registreer een bestemming van de klasse backups op een S3-bucket of op een andere schijf, en activeer die.
  2. Image: kopieer de bestanden, zonder de databases, terwijl die draait: docker run --rm -v merydion-prod-allinone_merydion_state:/d:ro -v "$PWD/files":/b alpine sh -c 'tar czf /b/files-$(date +%F).tgz -C /d --exclude="*.db" --exclude="*.db-*" --exclude=./backups --exclude=./restores .' schrijft een gedateerd archief in de map files.
  3. Map: stop hem met .\stop.ps1, kopieer de map data in zijn geheel en start hem daarna weer.
  4. Heeft een beheerder een andere bestemming voor de bestanden geregistreerd, kopieer dan in dezelfde ronde ook die map: de bestanden die na de activering zijn ontstaan, staan alleen daar.
  5. Bewaar de kopieën ver van de computer die ze beschermen.

Tip Om één database of de hele installatie terug te zetten naar een bepaald moment, stopt u de installatie en voert u merydion-storage copies restore uit (de procedure “Kopieën en terugzetten” uit het runbook): de opdracht schrijft de teruggezette databases in een nieuwe map, die daarna de plaats van de oude inneemt.

De site in coming soon zetten

Coming soon toont elke bezoeker alleen een voorbeeldpagina terwijl de installatie wordt voorbereid: het portaal, de apps, Palatys en de console wachten erachter, ook voor beheerders.

  1. Meld u aan als beheerder en open https://merydion.example.com/coming-soon.html?enabled=true: de pagina bevestigt en de site staat in coming soon.
  2. Om de site weer aan te zetten, opent u https://merydion.example.com/coming-soon.html?enabled=false: na de bevestiging brengt de pagina u naar de startpagina.
  3. Als u niet bent aangemeld, vraagt de pagina eerst om aan te melden; een account dat geen beheerder is, krijgt dat te horen, en er verandert niets.
  4. De toestand is het bestand site/coming-soon in de gegevensmap: wie het verwijdert, zet de site ook zonder de pagina weer aan.

Tip De coming-soon-pagina bestaat in het Engels en het Italiaans; een bezoeker met een andere taal krijgt de Engelse.

De bezoekstatistieken aanzetten

De site kan zijn bezoeken tellen met Google Analytics 4 en vraagt daarbij eerst elke bezoeker om toestemming: zolang een bezoeker niet accepteert, wordt er niets van Google geladen. De statistieken blijven uit tot de installatie haar metings-ID opgeeft, en de beheerconsole heeft ze nooit.

  1. Maak in Google Analytics een property en een webdatastream voor het adres van de site, en kopieer de metings-ID ervan (die begint met G-).
  2. Image: voeg in het bestand .env naast docker-compose.yml de regel MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX toe en maak de container opnieuw aan met docker compose up -d. Map: exporteer dezelfde variabele in de sessie vóór start.ps1.
  3. Open de site in een privévenster: linksonder verschijnt de melding over de bezoekstatistieken, en onderaan elke pagina verschijnt “Cookievoorkeuren”.
  4. Om de statistieken uit te zetten, maakt u de variabele leeg en maakt u de container opnieuw aan: de melding verdwijnt, en de browsers van wie had geaccepteerd laden Google Analytics niet meer.

Tip De privacyverklaring en het cookiebeleid beschrijven de statistieken al, in elke taal, voor de installatie die ze aanzet. Stel in de property de gewenste gegevensbewaring in — Google bewaart de gegevens van een bezoek hoogstens 14 maanden — en laat Google-signalen uit: de site zet ze ook aan zijn kant uit.

De site openstellen voor zoekmachines

Elke installatie vraagt zoekmachines haar niet te indexeren tot ze de indexering aanzet: een kopie van de site die niet de officiële is — een testinstallatie, die van een organisatie — concurreert er in de resultaten nooit mee. De adressen die de pagina's, de voorvertoningen en de sitemaps opgeven, verwijzen naar de officiële site, https://merydion.eu, en de accountpagina's, de console en de pagina van een adres dat niet bestaat, komen nooit in een index terecht.

  1. Alleen op de installatie die de officiële site aanbiedt. Image: voeg in het bestand .env naast docker-compose.yml de regel MERYDION_SITE_INDEXING=1 toe en maak de container opnieuw aan met docker compose up -d. Map: exporteer dezelfde variabele in de sessie vóór start.ps1.
  2. Controleer het: curl -I https://merydion.eu/ toont de header X-Robots-Tag: noindex niet meer, en https://merydion.eu/robots.txt verwijst naar https://merydion.eu/sitemap.xml.
  3. Verifieer in Google Search Console en in Bing Webmaster Tools het domein met een DNS-record en dien https://merydion.eu/sitemap.xml in.
  4. Om de site weer uit de zoekmachines te halen, maakt u de variabele leeg en maakt u de container opnieuw aan: elk antwoord zegt weer noindex, en de zoekmachines verwijderen de pagina's bij hun volgende bezoek.

Tip Een portaal dat voor een ander adres wordt gegenereerd, stelt bij het genereren MERYDION_SITE_ORIGIN in (bijvoorbeeld https://www.example.com): de canonieke adressen, de taalvarianten, de voorvertoningen en de sitemaps verwijzen dan naar dat adres. De pagina van een adres dat niet bestaat, antwoordt in de taal van haar map, met de status 404.

De Content-Security-Policy van het portaal

De pagina's van het portaal draaien onder een strikte Content-Security-Policy die de gateway meestuurt: een pagina mag alleen haar eigen bestanden gebruiken, verzoeken naar haar eigen oorsprong doen, afbeeldingen ook uit data: en blob: laden, en geen frame van een andere site tonen. Zo kan een binnengeslopen stukje markup geen code uitvoeren. De enige uitzondering zijn de bezoekstatistieken: de pagina's die bezoeken mogen tellen, laten ook gtag.js van Google toe, alleen op zijn eigen pad, en de gegevensverzameling van Google Analytics, die pas worden geladen nadat een bezoeker heeft geaccepteerd.

  1. Een aangepast portaal met scripts of stijlen die in de pagina's zelf staan, werkt niet: scripts en stijlen horen in eigen bestanden.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE en window.MERYDION_DIAGNOSTICS_BASE kunnen een familie verzoeken alleen onder een ander pad van dezelfde oorsprong verplaatsen; een adres op een andere oorsprong wordt genegeerd, met een fout in de console van de browser.
  3. De pagina's van de installatieconsole hebben het beleid zonder de uitzondering voor de statistieken en kunnen bovendien niet in een frame worden getoond.
  4. Het beleid staat in apps/portal-csp.mjs en in de drie Caddyfiles, en een test houdt ze gelijk: wijzig het op alle vier de plaatsen tegelijk.

Tip Het aanmeldformulier van de identiteitsservice en de weigeringspagina van de console komen met een eigen, nog strenger beleid.

Terug naar de handleiding

Productiviteit, made in Italy.

Breng de hele suite naar uw team — eenvoudig, veilig en volledig van u.