Deze handleiding legt uit hoe u een actie in n8n instelt, zodat een bericht naar kChat wordt verzonden wanneer aan de voorwaarden is voldaan.

Vereisten

• Installeer n8n op een Infomaniak-hosting.
• Maak een webhook aan in de kChat-app van Infomaniak.

Actie in n8n aanmaken

In uw n8n-sessie:

1. Klik om opnieuw te beginnen:
   
2. Klik om een eerste actie toe te voegen.
3. Selecteer een handmatige trigger:
   
4. Klik om een actie toe te voegen die moet worden uitgevoerd.
5. Zoek en activeer een actie van het type "HTTP-verzoek":
   
6. Selecteer de POST-methode.
7. Geben Sie die URL Ihres kChat-Webhooks ein.
8. Authenticatie is niet vereist (wordt al in de URL toegepast).
9. Activeer de schakelaar "Send body" om inhoud op te geven:
   
10. Voer in het veld "Name" de exacte term "text" in, zoals verwacht door kChat.
11. Voer in het veld "Value" de instructies in die u in kChat wilt weergeven.
12. Klik op de knop om uw handmatige opdracht te testen en toe te passen:
    
13. De in **n8n** opgegeven melding wordt vervolgens weergegeven in **kChat**:
    

Nu deze basisfunctionaliteit werkt, kunt u zich voorstellen de vaste tekst te vervangen door gegevens van een andere bron. Voeg bijvoorbeeld een "Imap"- of "RSS Feed"-knooppunt toe vóór de knooppunt voor de HTTP-aanvraag. In plaats van de tekst handmatig in te voeren, klikt u op het kleine tandwiel naast Value > Expression om aan te geven: "Stuur de titel van de laatst ontvangen e-mail naar kChat"…

Deze handleiding legt uit hoe u één of meerdere TXT-records aan de DNS-zone (van een domeinnaam) kunt toevoegen of wijzigen, die wordt beheerd via het beheerpaneel van Infomaniak.

Inleiding

• Het recordtype TXT maakt het mogelijk om leesbare tekst in de DNS-zone van een domeinnaam in te voegen.
• Deze methode wordt doorgaans gebruikt om spam te helpen voorkomen en om het eigendom van een domeinnaam te verifiëren (bijvoorbeeld kan Google dit vereisen voordat bepaalde van hun diensten kunnen worden gebruikt: zie deze handleiding voor een voorbeeld van het toevoegen van een TXT-record om een domeinnaam te authenticeren).

DNS-zone wijzigen

Om dit recordtype in een DNS-zone te beheren:

1. Klik hier om toegang te krijgen tot het beheer van uw domeinnaam in het Infomaniak-beheerpaneel (Hulp nodig?).
2. Klik direct op de naam van de betreffende domeinnaam.
3. Klik in de linkerzijbalk op DNS-zone.
4. Klik op de knop om een record toe te voegen:
   
5. Klik op de optie TXT om een record toe te voegen.
6. Klik op de knop Volgende:
   
7. Voer de vereiste TXT-waarden in voor uw DNS-zone.
8. Laat de TTL-waarde op de standaardinstelling staan.
9. Klik op de knop Opslaan:
   

Deze handleiding legt uit hoe u bestanden veilig kunt overzetten tussen uw computer en de server van de webhosting met behulp van het protocol SCP (secure copy command).

Inleiding

• Om te werken, heeft de opdracht SCP het volgende nodig:
  1. een bron: een bestand/map dat/die moet worden overgezet
  2. een bestemming: het FTP-serveradres voor het uitvoeren van de overdracht
• De gegevens worden automatisch door SCP versleuteld op het moment van de overdracht.
• Voor verdere hulp kunt u contact opnemen met een partner of gratis een offerte aanvragen – u kunt ook meer te weten komen over de rol van de host.

Een lokaal bestand naar de server kopiëren

Vereisten

• Om het adres van de FTP-server te verkrijgen:
  1. Klik hier om toegang te krijgen tot het beheer van uw hosting in de Infomaniak Manager (Hulp nodig?).
  2. Klik direct op de naam die aan de betreffende hosting is toegewezen.
  3. Klik in het linkermenu op FTP / SSH:
     
  4. Het adres van de hostserver wordt linksboven weergegeven en kan worden gekopieerd:
     
• Om het pad naar de doelmap te verkrijgen:
  1. Klik hier om toegang te krijgen tot het beheer van uw hosting in de Infomaniak Manager (Hulp nodig?).
  2. Klik direct op de naam die aan de betreffende hosting is toegewezen.
  3. Klik op Meer informatie (in de sectie Informatie).
  4. Kopieer het absolute pad:
     
  5. Vul het absolute pad aan met de gewenste doelmap.

Vervolgens, om een bestand van uw computer te kopiëren, is het commando als volgt:

scp localmachine/path_to_the_file username@ftp_server_adress:/path_to_remote_directory

Om een hele map van uw computer te kopiëren, moet u het commando als volgt aanpassen:

scp -r localmachine/path_to_the_file username@ftp_server_adress:/path_to_remote_directory

De hele map wordt naar uw server overgebracht.

Om de inhoud van een hele map van uw computer te kopiëren, moet u het commando als volgt aanpassen:

scp -r localmachine/path_to_the_file/* username@ftp_server_adress:/path_to_remote_directory

Deze handleiding beschrijft hoe u een GIT-repository aanmaakt, zowel op uw webhosting als op uw Infomaniak Cloud-server.

Voorwoord

• GIT en GitHub zijn standaard beschikbaar op de bovengenoemde platforms.
• Voor extra hulp kunt u contact opnemen met een partner of gratis een offerte aanvragen – u kunt ook meer te weten komen over de rol van de hostingprovider.

Aanmaken van de GIT-repository

Instellen op de server:

• de GIT-repository bevindt zich onder /git_depot
• de website bevindt zich in de map /web/[project] (op uw FTP-server)

Te gebruiken opdrachtregels:

cd
mkdir git_depot
cd git_depot/
git init --bare [projet].git
cd [projet].git
git update-server-info

Overzetten van de lokale repository naar de server

Uit te voeren op de lokale computer:

git init
git remote add origin ssh://user@[xxxxx].ftp.infomaniak.com:/home/clients/[123456789]/git_depot/[projet].git
git status
git add .
git commit -a -m "init"
git push --set-upstream origin master
git push

Klonen van de website naar de map op de server

Uit te voeren op de server:

cd
cd web
rm -r [projet]/
git clone /home/clients/[123465789]/git_depot/[projet].git [projet]/

Het hostingplatform voor uw websites *.perso.ch, *.users.ch, *.geneva-link.ch wordt bijgewerkt. Deze handleiding laat u zien hoe u verbinding maakt met uw FTP-opslagruimte.

Wijziging van de inloggegevens

Het huidige hostingplatform gebruikt een voorvoegsel voor uw FTP-gebruikersnaam. Dit voorvoegsel heeft de volgende indeling: persoch_

Als uw gebruikersnaam bijvoorbeeld infomaniak was, moet u nu met de volgende gebruikersnaam via FTP inloggen: persoch_infomaniak.

Deze handleiding geeft u een overzicht van de beschikbare open poorten voor de Node.js-websites die bij Infomaniak worden gehost.

Uitgaande open poorten

Web

• HTTP (tcp/80)
• Alternatieve HTTP (tcp/8080)
• HTTPS (tcp/443)
• FTP-gegevens (tcp/20)
• FTP-besturing (tcp/21)

E-mail

• POP3 (tcp/110)
• IMAP (tcp/143)
• SMTP-Einreichung (+ STARTTLS) (tcp/587)
• SMTPS (tcp/465)
• IMAPS (tcp/993)
• POP3S (tcp/995)

DB

• MySQL (tcp/3306)
• MongoDB (tcp/27017)
• PostgreSQL (tcp/5432)
• Redis (tcp/6379)
• Redis TLS (tcp/6380)
• ElasticSearch (tcp/9200)

Overige

• SSH (tcp/22)
• Git-pakketoverdracht (tcp/9418)

Inkomende open poorten

• HTTP (tcp/80)
• HTTPS (tcp/443)
• SSH (tcp/22)

Deze handleiding legt uit hoe u een probleem kunt oplossen bij de installatie van een SSL-certificaat (Let's Encrypt of Sectigo), wanneer u Cloudflare gebruikt met strenge beveiligingsregels, zoals land- of IP-adresfiltering.

SSL-/geoblokkeringsinstellingen aanpassen

Wanneer een SSL-certificaat via Infomaniak (gratis Let's Encrypt of Sectigo) wordt aangevraagd, moet de certificeringsinstantie verifiëren of u de rechtmatige eigenaar van het domein bent. Deze verificatie kan via HTTP (via speciale bestanden die op uw website worden geplaatst), DNS of e-mail plaatsvinden:

• Let's Encrypt gebruikt /.well-known/acme-challenge/.
• Sectigo gebruikt doorgaans /.well-known/pki-validation/ (of DNS/e-mail, afhankelijk van de gekozen optie).

Als deze verificaties mislukken (bijvoorbeeld omdat Cloudflare de toegang blokkeert), kan het certificaat niet worden uitgegeven of verlengd. Let's Encrypt voert echter niet meer alleen verificaties uit vanaf één enkele locatie. Sinds enige tijd (en nog meer sinds maart 2024) voert het zijn verificaties tegelijkertijd uit vanuit meerdere landen – waaronder nieuwe landen zoals Zweden of Singapore. Het resultaat: als een van deze landen door uw Cloudflare-instellingen wordt geblokkeerd, kan de certificaataanvraag mislukken, zelfs als alles anders correct is geconfigureerd.

Nog erger: zelfs als u probeert een uitzondering te maken voor alleen het adres van de uitdaging (.well-known/acme-challenge), werkt dit mogelijk niet met bepaalde Cloudflare-regels. In feite worden de blokkeringsregels voor landen of IP-adressen vóór elke uitzondering toegepast op basis van URL-paden.

SSL/TLS-modus aanpassen

Bij Cloudflare gebruikt u de modus Full of Full (strict). Deze modi tolereren tijdelijk een verlopen of zelfondertekend certificaat, totdat de validatie is voltooid:

Validatiepaden vrijgeven

Vermijd blokkerende "IP Access Rules" en geef de voorkeur aan "Custom Rules", die de paden zonder beperkingen vrijgeven:

• /.well-known/acme-challenge/ (Let's Encrypt)
• /.well-known/pki-validation/ (Sectigo)

Geografische blokkade tijdelijk uitschakelen

Indien nodig, schakelt u tijdelijk de geografische of IP-blokkade uit, totdat de validatie is voltooid, en activeert u vervolgens uw beveiligingsmaatregelen na de uitgifte of vernieuwing van het certificaat.

Infomaniak biedt verschillende Site Creator-pakketten aan, zowel gratis als betaald, die zijn afgestemd op verschillende behoeften. Het is belangrijk om de voorwaarden van elk type pakket te begrijpen voordat u een keuze maakt.

De verschillende Site Creator-pakketten begrijpen

Site Creator is beschikbaar…

• … ofwel gratis bij elke betaalde webhosting:
  • In dit geval kan slechts 1 Site Creator per Infomaniak-webhosting worden ingesteld.
  • Om meerdere websites die met Site Creator zijn gemaakt binnen dezelfde organisatie te beheren, is het dus noodzakelijk om meerdere webhostings te hebben.
• … of zelfstandig (standalone in 3 versies), en vereist in dit geval geen ander specifiek pakket:
  1. Site Creator Free
  2. Site Creator Lite
  3. Site Creator Pro

1. Site Creator Free

Dit pakket is bedoeld als een test- en ontdekkingsoplossing en is volledig gratis. Het is bedoeld voor gebruikers die willen kennismaken met het hulpmiddel of een zeer eenvoudige website willen publiceren:

• Het staat slechts één website toe en biedt een beperkte opslagruimte (5 GB).
• Dit pakket maakt geen verbinding mogelijk met een aangepaste domeinnaam (deze heeft de vorm *.infomaniak.site) en bevat de verplichte weergave van de reclame van Infomaniak.
• Belangrijke groeimodules, zoals het volledige beheer van een blog, het gebruik van kunstmatige intelligentie voor het genereren van tekst of de functie "sitemap", zijn niet inbegrepen.

2. Site Creator Lite

Het Lite-abonnement is het instapmodel van Infomaniak. Het is ideaal voor het maken van een eenvoudige website of een persoonlijke blog, omdat het de belangrijkste beperkingen van de gratis versie opheft en de modules vrijgeeft die nodig zijn voor een complete website:

• Het maakt het mogelijk om een uitgebreidere website te maken met een limiet van 5 webpagina's en meer opslagruimte (15 GB).
• Het omvat een domeinnaam voor een jaar en, wat cruciaal is, het verwijderen van alle reclame-elementen van Infomaniak op de website.
• In tegenstelling tot het gratis abonnement, geeft het Lite-abonnement toegang tot belangrijke functies voor navigatie en organisatie, met name de module voor het maken en beheren van een blog en de module voor een sitemap.

3. Site Creator Pro

Het Pro-abonnement is de premiumversie van Site Creator. Het is uitsluitend bedoeld voor de meest ambitieuze projecten, zoals het lanceren van een complete webshop, dankzij het opheffen van alle inhoudsbeperkingen en de integratie van geavanceerde handels- en analysetools:

• Het heft alle beperkingen voor de inhoud op door onbeperkte webpagina's en een grote opslagruimte van 50 GB aan te bieden.
• Het is het enige abonnement dat volledig geïntegreerd e-commercebeheer (bestellingen, voorraad, kortingen) biedt en de integratie van essentiële betalingsgateways (Stripe, PayPal, Mollie) mogelijk maakt voor online bedrijfsactiviteiten.
• Het Pro-abonnement is het enige abonnement dat toegang biedt tot belangrijke externe analyse- en prestatietrackingtools, zoals Google Analytics, Hotjar en tools zoals Google reCaptcha.

Verplichting voor betaalde abonnementen

In tegenstelling tot andere Infomaniak-producten bevatten bepaalde Site Creator-pakketten een gratis domeinnaam. Deze pakketten vereisen een vaste overeenkomst voor een minimale periode van 12 maanden, zonder de mogelijkheid tot terugbetaling, zelfs niet gedeeltelijk, en dat geldt ook als:

• u besluit het gebruik van Site Creator te beëindigen voordat het eerste jaar is verstreken,
• u uw producten opzegt,
• u uw gebruikersaccount of uw organisatie beëindigt.

Aanpassing van de pakketten en het behouden van uw website

Het is mogelijk om over te stappen van een gratis pakket naar een uitgebreider betaald pakket:

1. Klik hier om toegang te krijgen tot het beheer van uw product in de Infomaniak Manager (Hulp nodig?).
2. Klik rechtstreeks op de naam van het betreffende product.
3. Klik vervolgens op de pijl ‍ Beheren.
4. Klik op Pakket wijzigen:
   

Het is ook mogelijk om over te stappen naar een hoger pakket (bijvoorbeeld van Lite naar Pro).

Als u uw website actief wilt houden, moet u absoluut hetzelfde betaalde pakket verlengen. Het is niet mogelijk om over te schakelen naar een gratis versie van Site Creator, zelfs niet als:

• u geen van de betaalde modules gebruikt,
• uw website slechts één pagina bevat.

Wat te doen als u terug wilt naar het gratis pakket?

In dit geval moet u het volgende doen:

• opzeggen uw huidige website, nadat u alle informatie die u wilt behouden handmatig hebt gekopieerd,
• een nieuw gratis Site Creator-abonnement activeren,
• uw website opnieuw aanmaken door de inhoud van de oude website te importeren.

Deze handleiding begeleidt u bij de installatie van Ghost op Infomaniak, een ideaal platform voor blogs (regelmatig schrijven, redactionele vorm) en websites die zich richten op content, zoals Substack of Medium.

Ghost is gebaseerd op Node.js en maakt gebruik van Markdown voor het schrijven. Het kenmerkt zich door zijn gebruiksgemak, terwijl WordPress, hoewel flexibeler en veelzijdiger, complexer is.

Vereisten

• Installeer een lege Node.js-website op een Infomaniak-webhosting.
• Maak een SSH-toegang aan.
• Maak een database aan.
• Zorg ervoor dat u een geldig en werkend e-mailadres heeft (vooral voor de functie om een vergeten wachtwoord opnieuw in te stellen).
• Stop uw Node.JS-applicatie voordat u de volgende stappen uitvoert!

Installatie van Ghost

Hiervoor:

1. Log in op de server via SSH (Hulp nodig?).

2. Clone en voer het installatiescript uit (voer deze commando's achter elkaar uit):

   git clone https://github.com/Infomaniak/hosting-tools.git
   cd hosting-tools/h3-ghost
   bash ./install.sh

Het script zal nu:

• Een aantal vragen stellen (zoals de URL van uw website, de databasegegevens, enz.)…
• Ghost automatisch downloaden en configureren…
• Een paar minuten duren – wees geduldig!

Beantwoord de vragen zorgvuldig en gebruik de databasegegevens die u eerder hebt genoteerd. Sluit het terminalvenster niet voordat het proces is voltooid!

Configureer uw hosting (via het Infomaniak-beheerpaneel)

Zodra het script is voltooid, gaat u naar uw Infomaniak-beheerpaneel:

1. Klik hier om toegang te krijgen tot het beheer van uw product in het Infomaniak-beheerpaneel (Hulp nodig?).
2. Klik rechtstreeks op de naam van het betreffende product.
3. Klik op Beheren onder Geavanceerde instellingen:
   
4. Klik op het tabblad Node.js om toegang te krijgen tot de instellingen.

5. Voer in het veld Uitvoeringsopdracht het volgende in:

   /srv/customer/node_modules/ghost-cli/bin/ghost run

6. Controleer of het poortnummer 3000 is.
7. Bij de opdracht build: schakel deze uit.
8. Klik op de knop Opslaan onderaan de pagina:
   
9. Op de hoofdpagina klikt u op de knop Start (of Herstart, als het al actief is).
10. Volg de logbestanden om de creatie van de database en het opstarten van de applicatie te volgen:
    
    

Klaar! Ga naar uw Ghost-blog

Ga vervolgens naar de URL van uw website om aan de slag te gaan:

1. Open uw browser en ga naar https://votresite.com/ghost (vervang votresite.com door uw huidige domeinnaam).
2. De eerste keer:
   1. U maakt een administratoraccount aan (uw inloggegevens voor de blog)...
   2. Daarna kunt u beginnen met het schrijven van artikelen!

Gebruikersconfiguratie / E-mail

Om de eerste gebruiker aan te maken, voegt u /ghost toe aan de URL van uw website (bijvoorbeeld https://ghost.domain.xyz/ghost) en volgt u de wizard.

U kunt ook het "ondersteuningsadres van het ledenportaal" configureren: wanneer nieuwe leden zich willen aanmelden, stuurt het portaal de bevestiging van de dubbele opt-in vanaf een bepaald adres. Standaard is dit het "noreply"-adres van uw domein. Om dit te wijzigen, gaat u naar "Instellingen", "Lidmaatschap", "Portaalinstellingen", "Aanpassen" en "Accountpagina":

Los een technisch compatibiliteitsprobleem tussen Ghost en MariaDB op

Er is een compatibiliteitsprobleem tussen Ghost en de MariaDB-database. Dit leidt tot het volgende type fout:

[2025-01-01 12:54:28] ERROR "GET /ghost/api/admin/posts/6834625e35802b06f1496305/?formats=mobiledoc%2Clexical&include=tags%2Cauthors%2Cauthors.roles%2Cemail%2Ctiers%2Cnewsletter%2Ccount.conversions%2Ccount.clicks%2Csentiment%2Ccount.positive_feedback%2Ccount.negative_feedback" 400 27ms
Could not understand request.
Error ID:
8f2b0d90-3a30-11f0-a25f-fd9c83e1cf02
Error Code:
ER_BAD_FIELD_ERROR
----------------------------------------
Error: select `posts`.*, (with `k` as (select `member_id` from `members_subscription_created_events` where posts.id = members_subscription_created_events.attribution_id union select `member_id` from `members_created_events` where posts.id = members_created_events.attribution_id) select count(*) from `k`) as `count__conversions`, `posts`.*, (select count(distinct `members_click_events`.`member_id`) from `members_click_events` inner join `redirects` on `members_click_events`.`redirect_id` = `redirects`.`id` where posts.id = redirects.post_id) as `count__clicks`, `posts`.*, (select COALESCE(ROUND(AVG(score) * 100), 0) from `members_feedback` where posts.id = members_feedback.post_id) as `count__sentiment`, `posts`.*, (select count(*) from `members_feedback` where posts.id = members_feedback.post_id AND members_feedback.score = 0) as `count__negative_feedback`, `posts`.*, (select sum(`score`) from `members_feedback` where posts.id = members_feedback.post_id) as `count__positive_feedback` from `posts` where (`posts`.`type` = 'post' and `posts`.`status` in ('draft', 'published', 'scheduled', 'sent')) and `posts`.`id` = '2834125e33802b06e1433305' limit 1 - Unknown column 'posts.id' in 'where clause'
at Child.<anonymous> (/srv/customer/sites/ghost.domain.xyz/versions/5.120.2/core/server/models/base/plugins/crud.js:194:31)
at Packet.asError (/srv/customer/sites//versions/5.120.2/node_modules/mysql2/lib/packets/packet.js:740:17)
at Query.execute (/srv/customer/sites//versions/5.120.2/node_modules/mysql2/lib/commands/command.js:29:26)
at Connection.handlePacket (/srv/customer/sites//versions/5.120.2/node_modules/mysql2/lib/base/connection.js:475:34)
at PacketParser.onPacket (/srv/customer/sites//versions/5.120.2/node_modules/mysql2/lib/base/connection.js:93:12)
at PacketParser.executeStart (/srv/customer/sites//versions/5.120.2/node_modules/mysql2/lib/packet_parser.js:75:16)
at Socket.<anonymous> (/srv/customer/sites//versions/5.120.2/node_modules/mysql2/lib/base/connection.js:100:25)
at Socket.emit (node:events:518:28)
at addChunk (node:internal/streams/readable:561:12)
at readableAddChunkPushByteMode (node:internal/streams/readable:512:3)
at Readable.push (node:internal/streams/readable:392:5)
at TCP.onStreamRead (node:internal/stream_base_commons:189:23)

Sommige door Ghost gegenereerde SQL-query's die gebruikmaken van Common Table Expressions (CTE's) die zijn ingebed in scalaire subquery's, veroorzaken HTTP 400-fouten wanneer ze op MariaDB worden uitgevoerd. Deze query's zijn geldig in MySQL 8, dat CTE's in scalaire subquery's ondersteunt, maar niet in MariaDB tot versie 10.6.

Er is een patch beschikbaar om het gedrag van Ghost aan te passen en deze fouten te voorkomen (lees de officiële handleiding).

Om deze patch te gebruiken, voert u het volgende commando uit:

cd current
curl -L https://gist.githubusercontent.com/reneluria/8cbbfbc001e542c77d6d5887fbafe5d3/raw/65e0ce31753b4687d0eb67fc030734a35d3ffbad/ghost-post.patch | patch -p0

Deze handleiding helpt u bij het oplossen van een probleem met het CMS Prestashop en in het bijzonder met de module "Faceted Search" (facetzoekfunctie), waarmee het beheer van filters op de pagina's van de productcategorieën mogelijk wordt.

Het probleem

Deze specifieke Prestashop-zoekmodule maakt een cache in de database aan om de zoekopdracht te versnellen. De bijbehorende tabel wordt echter nooit geleegd, wat problemen veroorzaakt voor de hostinginfrastructuur.

Eerste oplossing

De eerste oplossing is om de voorgestelde cache uit te schakelen.

Ga als volgt te werk:

1. Ga in het PrestaShop-beheerpaneel naar Modules → Modulebeheer.
2. Selecteer Modules en gebruik het zoekveld om "facet" te vinden.
3. Klik op Configureren naast de module die in de zoekresultaten wordt weergegeven:
   
4. Schakel de bijbehorende knop uit:
   

Tweede oplossing

De tweede oplossing is om een cronjob aan te maken die de tabel leegt, bijvoorbeeld elke avond:

1. Kopieer de bestaande URL van de knop Cache legen vanuit de module-instellingen:
   

Maak vervolgens in de Infomaniak Manager een webcron aan (raadpleeg deze andere handleiding over dit onderwerp) om de URL uit stap 1 hierboven uit te voeren, bijvoorbeeld één keer per dag en nacht.

Deze handleiding gaat over de WordPress-module "Infomaniak Connect voor OpenID", waarmee gebruikers zich kunnen aanmelden bij uw WordPress-website (ongeacht of deze wordt gehost door Infomaniak of niet) door hun Infomaniak-inloggegevens te gebruiken.

Inleiding

• Door het aanmaken van een account via een Infomaniak-account op uw WordPress-website mogelijk te maken, kunnen uw bezoekers met slechts één klik reacties plaatsen, zich aanmelden voor cursussen of toegang krijgen tot inhoud die alleen voor leden bedoeld is, zonder dat ze een nieuw account hoeven aan te maken.
• Dit bespaart tijd en is een veiligere methode voor u, omdat u geen extra wachtwoorden hoeft te beheren.
• De werking van deze externe module is identiek aan de opties "Aanmelden met Google", "Aanmelden met Facebook" of "Aanmelden met Apple"; het gebruikt de standaardprotocollen OAuth2 en OpenID Connect om een single sign-on (SSO)-authenticatie mogelijk te maken.

A. Maak een applicatie aan met Auth Infomaniak

Ga als volgt te werk:

1. Klik hier om toegang te krijgen tot het beheer van uw Auth-product in de Infomaniak Manager (Hulp nodig?).
2. Klik op de knop om een nieuwe applicatie aan te maken:
   
3. Selecteer het type "Web Front-End".
4. Geef uw applicatie een naam.
5. Voer in het URL-veld de **domeinnaam van uw WordPress-website** in, gevolgd door `/openid-connect-authorize` (zie indien nodig de GitHub-documentatie).
6. Klik op de knop om de **aanmaak van de app** te voltooien:
   
7. Noteer zorgvuldig de 2 stukken informatie die u ontvangt bij het voltooien van uw **OAuth2-applicatie**:
   

B. Configureer de WordPress-plugin

Ga als volgt te werk:

1. Zoek de plugin `Infomaniak Connect for OpenID` op het WordPress-platform van uw website.
2. Installeer en activeer de plugin:
   
3. Configureer de plugin via het menu **Instellingen**:
   
4. De enige velden die u hoeft in te vullen, zijn **Client ID** en **Client Secret Key**, en deze informatie haalt u uit punt **A** hierboven:
   
5. Vergeet niet om de wijzigingen in de plugininstellingen op te slaan.
6. Er is nu een extra knop toegevoegd voor het inloggen met uw Infomaniak-account op uw inlogpagina voor gebruikers /wp-admin (/wp-login.php):
   

Deze handleiding gaat over de Typo3-module "t3ext-infomaniak-auth", waarmee gebruikers zich kunnen aanmelden bij uw Typo3-website (ongeacht of deze wordt gehost bij Infomaniak of niet) door hun Infomaniak-inloggegevens te gebruiken.

Inleiding

• Door het inschakelen van de aanmeldingsoptie via een Infomaniak-account op uw Typo3-website, kunnen uw bezoekers met slechts één klik reacties plaatsen, zich aanmelden voor cursussen of toegang krijgen tot inhoud die alleen voor leden bedoeld is, zonder dat ze een nieuw account hoeven aan te maken.
• Dit bespaart tijd en is een veiligere methode voor u, omdat u geen extra wachtwoorden hoeft te beheren.
• De werking van deze externe module is identiek aan de opties "Aanmelden met Google", "Aanmelden met Facebook" of "Aanmelden met Apple"; het gebruikt de standaardprotocollen OAuth2 en OpenID Connect om een single sign-on (SSO)-authenticatie mogelijk te maken.

A. Maak een applicatie aan met Auth Infomaniak

Ga als volgt te werk:

1. Klik hier om toegang te krijgen tot het beheer van uw Auth-product in de Infomaniak Manager (Hulp nodig?).
2. Klik op de knop om een nieuwe applicatie aan te maken:
   
3. Selecteer het type "Web Front-End".
4. Geef uw applicatie een naam.
5. Voer in het URL-veld de **domeinnaam van uw Typo3-website** in, gevolgd door ` /openid-connect-authorize` (zie GitHub-documentatie indien nodig).
6. Klik op de knop om de **app-creatie** te voltooien:
   
7. Noteer de 2 stukken informatie die u ontvangt bij het voltooien van uw **OAuth2-applicatie**:
   

B. Configureer de Typo3-plugin

Installeer indien nodig **Composer** via SSH om de extensie t3ext-infomaniak-auth te installeren. Ga als volgt te werk:

• Het SSH-commando om de extensie te installeren is:
  • https://packagist.org/packages/infomaniak/t3ext-infomaniak-auth

Vervolgens in Typo3:

1. Log in op uw Typo3-beheerdersinterface.
   • Zorg ervoor dat de Infomaniak-plugin is geactiveerd:
     
2. Klik op **Instellingen** in het linkermenu.
3. Klik op **Extensies configureren**:
   
4. Klik op de pijl ‍ rechts naast **typo3-openid-main** om de clientconfiguratie te openen.
5. De enige velden die moeten worden ingevuld, zijn clientID en clientSecret, en deze gegevens haalt u uit de informatie die u in stap A hierboven heeft verkregen.
6. Vergeet niet om de wijzigingen in de extensie-instellingen op te slaan:
   
7. Er is nu een extra knop toegevoegd voor het inloggen met uw Infomaniak-account, die zichtbaar is op uw inlogpagina:
   

Deze handleiding gaat over de Drupal-module "Infomaniak_Connect", waarmee gebruikers zich kunnen aanmelden bij hun Drupal-website (ongeacht of deze bij Infomaniak wordt gehost of niet) door hun Infomaniak-inloggegevens te gebruiken.

Inleiding

• Door het inschakelen van aanmelden via een Infomaniak-account op uw Drupal-website, kunnen uw bezoekers met slechts één klik reacties plaatsen, zich aanmelden voor cursussen of toegang krijgen tot inhoud die alleen voor leden bedoeld is, zonder dat ze een nieuw account hoeven aan te maken.
• Dit bespaart hen tijd en is een veiligere methode voor u, omdat u geen extra wachtwoorden hoeft te beheren.
• De werking van deze externe module is identiek aan de opties "Aanmelden met Google", "Aanmelden met Facebook" of "Aanmelden met Apple"; het gebruikt de standaardprotocollen OAuth2 en OpenID Connect om een single sign-on (SSO)-authenticatie mogelijk te maken.

A. Maak een applicatie aan met Auth Infomaniak

Ga als volgt te werk:

1. Klik hier om toegang te krijgen tot het beheer van uw Auth-product in de Infomaniak Manager (Hulp nodig?).
2. Klik op de knop om een nieuwe applicatie aan te maken:
3. Selecteer het type "Web Front-End".
4. Geef uw applicatie een naam.
5. Voer in het URL-veld de **domeinnaam van uw Drupal-site** in, gevolgd door ` /openid-connect-authorize` (zie de GitHub-documentatie indien nodig).
6. Klik op de knop om de **app-creatie te voltooien**:
   
7. Noteer zorgvuldig de 2 stukken informatie die u ontvangt bij het voltooien van uw **OAuth2-applicatie**:
   

B. Drupal-extensie configureren

Installeer indien nodig **Composer** via SSH om de extensies `openid_connect` en `infomaniak_connect` te installeren. Ga als volgt te werk:

• U moet mogelijk het bestand **composer.json** bewerken, omdat de versie van `openid_connect` nog niet als stabiel wordt beschouwd. Voeg het volgende toe:

• "minimum-stability": "dev",
  "prefer-stable": true

• De SSH-opdrachten voor het installeren van de 2 extensies vindt u hier:
  • https://www.drupal.org/project/openid_connect
  • https://www.drupal.org/project/infomaniak_connect

Vervolgens in Drupal:

1. Zoek de module **Infomaniak** op onder uw vooraf geïnstalleerde modules.
2. Selecteer deze.
3. Klik op de knop **Installeren**:
   
4. De installatie van de afhankelijkheden verloopt als volgt:
   
5. Klik onder Configuratie om de OpenID-verbinding te configureren:
   
6. Klik op de knop Bewerken:
   
7. De enige velden die moeten worden ingevuld, zijn Client ID en Client Secret, en deze gegevens haalt u uit de informatie die u in het bovenstaande punt A heeft ontvangen:
    
8. Vergeet niet om de aangebrachte wijzigingen op te slaan in de instellingen van de extensie.
9. In het tabblad Instellingen kunt u het weergavetype voor uw inlogpagina selecteren; vergeet niet om op te slaan:
   
10. Een extra knop voor het inloggen met uw Infomaniak-account is nu zichtbaar op uw inlogpagina voor gebruikers:
     

Deze handleiding legt uit hoe u de configuratie van een Node.js-website kunt aanpassen die op de Infomaniak-infrastructuur wordt gehost, zodat het gedrag van uw applicatie kan worden afgestemd op de ontwikkeling, afhankelijkheden of technische voorkeuren.

Vereisten

• Installeer een Node.js-website op uw hosting.
• Test uw wijzigingen lokaal voordat u ze in productie implementeert.
• Zorg ervoor dat uw scripts (start, build) zijn gedefinieerd in uw package.json-bestand.
• Als u de structuur van uw project wijzigt, vergeet dan niet de uitvoermap en de bijbehorende opdrachten aan te passen.
• De poort die in de manager is gedefinieerd, moet absoluut overeenkomen met de poort die in uw applicatiecode wordt gebruikt.

Toegang tot de configuratie

Elke website heeft een eigen dashboard om de applicatie te beheren (start, stop, restart), de uitvoerconsole te raadplegen, Node.js-versies te beheren, domeinen te configureren en SSL-certificaten te activeren:

1. Klik hier om toegang te krijgen tot het beheer van uw website in de Infomaniak-manager (Hulp nodig?).
2. Klik rechtstreeks op de naam van de betreffende website.
3. U kunt de console openen, het project stoppen (er wordt een onderhoudspagina weergegeven) of opnieuw starten.
4. Klik op Beheren onder Geavanceerde instellingen:
   
5. Klik op het tabblad Node.js om toegang te krijgen tot de instellingen:
   

Wijzigingen toepassen

Ga als volgt te werk:

1. Sla de wijzigingen op via de beheerinterface.
2. Start uw applicatie opnieuw op, zodat de wijzigingen worden doorgevoerd.

Raadpleeg deze andere handleiding als er problemen optreden.

Belangrijkste commando's

Uitvoeringsdirectory

De uitvoeringsdirectory geeft de locatie op de server aan waar de build- en startcommando's worden uitgevoerd. Deze moet verwijzen naar de hoofdmap van uw applicatie, dus de map waarin uw package.json-bestand zich bevindt.

U kunt bijvoorbeeld de volgende waarde opgeven voor de projectroot:

./

of, als uw applicatie zich in een submap met de naam app bevindt:

./app

of, als deze zich in een map backend bevindt:

./backend

Build-commando (optioneel)

Als uw Node.js-applicatie een compilatiestap vereist voordat deze wordt uitgevoerd, geeft u dan een build-commando op in het daarvoor bestemde veld. Dit commando wordt automatisch uitgevoerd voordat de applicatie wordt gestart.

U kunt bijvoorbeeld het volgende opgeven:

npm install && npm run build

of, als u yarn gebruikt:

yarn install && yarn build

Als uw project geen compilatie vereist, kan dit veld leeg worden gelaten.

Start-commando

Het start-commando is het commando dat wordt gebruikt om uw applicatie te starten. Het moet identiek zijn aan het commando dat u lokaal gebruikt om het project uit te voeren.

U kunt bijvoorbeeld het volgende opgeven:

node index.js

npm start

of

yarn start

Dit commando moet het mogelijk maken om de server of het startpunt van uw applicatie direct te starten, zoals gedefinieerd in uw ontwikkelomgeving.

Luikpoort

Uw applicatie moet op een specifieke poort luisteren, die is gedefinieerd in de manager. Deze poort wordt aan uw applicatie doorgegeven via een omgevingsvariabele PORT.
Voorbeeld in uw Node.js-code:

const port = process.env.PORT || 8080;
app.listen(port, () => {
  console.log(`Application lancée sur le port ${port}`);
});

Zorg ervoor dat deze poort in uw code wordt meegenomen.

Node.js-versie

U kunt de versie van Node.js selecteren die uw website moet gebruiken. Het wordt aanbevolen om een stabiele en altijd ondersteunde versie te gebruiken, om de veiligheid en compatibiliteit van uw applicatie te waarborgen.

De Node.js-sites die door Infomaniak worden aangeboden, maken het mogelijk om Node.js-applicaties uit te voeren in een flexibele, gebruiksklare omgeving, zonder dat er een serverinfrastructuur beheerd hoeft te worden.

Inleiding

• Dit type hosting biedt de flexibiliteit van een server zonder de complexiteit van het beheer en is vooral geschikt voor REST API-projecten, voor het implementeren van het CMS Ghost, n8n, Strapi of frameworks zoals Express.js, NestJS of zelfs socket.io, next.js, bedrijfstoepassingen of prototypes voor:
  • Ontwikkelaars die Node.js-applicaties willen implementeren zonder een infrastructuur te hoeven beheren.
  • Webmasters die Node.js willen uitproberen of ermee vertrouwd willen raken.
  • Agentschappen en freelancers die aan meerdere klantprojecten werken.
  • Studenten, docenten en scholen die een eenvoudige omgeving nodig hebben om code te testen.
• De pakketbeheerders NPM en Yarn worden ondersteund.
• Als u Node.js op een webhosting binnen een cloudserver installeert, werkt uw website niet met de gegarandeerde resources van de beheerde cloudserver.
  • Raadpleeg deze andere handleiding om Fast Installer te gebruiken en NVM te implementeren.
• Node.js = de officiële naam van de taal/omgeving; NodeJS = de "technische" of vereenvoudigde naam in bepaalde contexten (vaak om praktische redenen, geen echt technisch verschil).

Een Node.js-site maken

Om toegang te krijgen tot een webhostingpakket en een Node.js-site toe te voegen:

1. Klik hier om toegang te krijgen tot het beheer van uw producten in de Infomaniak Manager (Hulp nodig?).
2. Klik rechtstreeks op de naam van het betreffende product.
3. Klik op de blauwe knop Toevoegen:
   
4. Selecteer een project met geavanceerde technologieën.
5. Klik op Volgende:
   
6. Selecteer Node.js.
7. Selecteer indien nodig een andere versie.
8. Klik op Volgende:
   
9. Selecteer het domeintype dat aan deze nieuwe site moet worden toegewezen:
   1. een reeds aangeschaft domeinnaam
   2. een subdomein, gemaakt van een reeds aangeschaft domeinnaam
   3. een nog beschikbare domeinnaam en te bestellen
10. Voer de domeinnaam of het subdomein in.
11. Selecteer indien nodig de geavanceerde opties.
12. Klik op Volgende:
    
13. Kies een van de twee mogelijke methoden:
    
    1. Snelle methode:
       1. Een vooraf geconfigureerd voorbeeldproject wordt automatisch geïnstalleerd.
       2. Deze methode is ideaal om Node.js te leren kennen of snel een functionele basis te creëren.
    2. Aangepaste methode:
       1. De broncode kan worden geïmporteerd via Git, ZIP-archief, SSH of SFTP.
       2. U definieert zelf de scripts, toegangspunten, de poort waarop geluisterd wordt en de benodigde build-opdrachten.
14. Elke website heeft een eigen dashboard voor het beheren van de applicatie (starten, stoppen, herstarten), voor het bekijken van de uitvoerconsole, voor het beheren van de Node.js-versies, voor het configureren van domeinen en voor het activeren van SSL-certificaten:
    

Om de configuratie van uw Node.js-website verder te optimaliseren, kunt u deze andere handleiding raadplegen.

Deze handleiding legt uit hoe u externe gegevens (bestanden, mappen, enz.) via het WebDAV-protocol in uw kDrive importeert.

Inleiding

• Raadpleeg deze handleiding als u informatie zoekt over het kopiëren van bepaalde gegevens van de ene kDrive naar de andere, wanneer uw gebruiker toegang heeft tot beide kDrives.
• Raadpleeg deze handleiding als u informatie zoekt over het later gebruiken van uw kDrive via het WebDAV-protocol.

Externe gegevens importeren via WebDAV

Vereisten

• U heeft een kDrive of kSuite (WebDAV is niet vereist).
• U moet voldoende rechten hebben in kDrive of kSuite.
• Wijzig uw wachtwoord niet totdat de import is voltooid!

Om toegang te krijgen tot het importgereedschap, waar de gegevens moeten worden geïmporteerd:

1. Klik hier om toegang te krijgen tot de web-app kDrive van Infomaniak (online dienst ksuite.infomaniak.com/kdrive).
2. Klik op het pictogram Instellingen ‍ rechtsboven.
3. Controleer of selecteer de betreffende kDrive in het vervolgmenu in de linkerzijbalk.
4. Klik op Algemeen in de linkerzijbalk.
5. Klik op Externe gegevens importeren:
   
6. Klik op de blauwe knop Starten:
   
7. Klik op WebDAV.
8. Voer de gevraagde informatie in op basis van de bron (met name het WebDAV-adres dat u bezit – verkregen van de bron).
9. Selecteer de doel-kDrive en de gewenste locatie voor de geïmporteerde gegevens.
10. Klik op Starten:
    

Voorbeeld: gegevens van een externe kDrive naar de organisatie kopiëren

Om een kDrive te importeren die zich buiten de organisatie bevindt waarin uw doel-kDrive zich bevindt, moet u de volgende informatie invoeren op de bovengenoemde plek 9 (uw inloggegevens worden uitsluitend gebruikt om uw gegevens te importeren; ze worden onmiddellijk na voltooiing van het proces verwijderd):

• Gebruikersnaam: e-mailadres voor het aanmelden bij het Infomaniak-account
• Wachtwoord: maak een app-wachtwoord aan voor dit specifieke doel.
• Toegangspunt: de webDAV-aanmeldings-URL met de ID van de bron-kDrive (bron-schijf) – zie deze handleiding voor de kDrive-ID.
  • Voorbeeld: https://123456.connect.kdrive.infomaniak.com als de ID "123456" is, om de volledige kDrive te verkrijgen; het is echter ook mogelijk om slechts een deel te importeren (zie hieronder).

Geef de naam van een specifieke submap op

Het is mogelijk om een submap als bronmap te selecteren door de kDrive-ID en het pad van de map te combineren.

Voorbeeld van een map in de gedeelde ruimte van de organisatiemappen (= "Gedeelde documenten"):

• https://IDkDrive.connect.kdrive.infomaniak.com/Gedeelde documenten/Naam van de map

Voorbeeld van een map/submap die zich in de persoonlijke mappen bevindt (dus buiten de organisatiemappen):

• https://IDkDrive.connect.kdrive.infomaniak.com/Naam van de map/Naam van de submap

Deze handleiding beschrijft de specifieke regels die in acht moeten worden genomen bij het maken van een gebruikerswachtwoord met mysqli_connect(), dat het teken ‘dollar’ $ bevat, op de Infomaniak-platforms.

Inleiding

• Als u bij het gebruik van mysqli_connect() de foutmelding “Toegang geweigerd voor gebruiker” ontvangt en uw databasegebruikerswachtwoord een dollarteken $ bevat, kan het probleem te wijten zijn aan de werking van strings in PHP.
• Het probleem kan ook voorkomen bij berichten-scripts.

Regels om te volgen

Als het speciale teken $ in een gebruikerswachtwoord wordt gebruikt en er geen cijfer direct achter staat, is de variabelenaam ongeldig en wordt de substitutie niet correct uitgevoerd.

Hier zijn enkele oplossingen om dit te verhelpen:

• Plaats het wachtwoord tussen enkele aanhalingstekens: '$******'
• Zorg ervoor dat er direct na het dollarteken een cijfer staat: "$2*****"
• Gebruik een backslash om het dollarteken in het wachtwoord te ‘escapen’: "\$****"

Deze handleiding legt de verschillen uit tussen een domein (of hoofdpagina), een subdomein en een alias.

Inleiding

• Hoewel ze met elkaar verbonden zijn, hebben deze drie elementen (domein, subdomein en alias) verschillende functies en doelen.
• U kunt via de domeinnaam uw webhosting beïnvloeden, of zelfs uw e-mail, omdat het bijvoorbeeld heel goed mogelijk is om e-mailadressen op een subdomein te hebben.

Wat is een domein?

Het domein of de domeinnaam is de belangrijkste toegang tot uw website. Via deze toegang komen uw gebruikers bij uw inhoud. Dit hoofddomein bepaalt wat er in de adresbalk van de browser van uw gebruikers wordt weergegeven.

Vereisten

• U bezit een domein.
• U bezit een webhosting van Infomaniak.

Raadpleeg de handleiding Maak een nieuwe website aan op uw webhosting.

Wat is een subdomein?

Het subdomein wordt gesymboliseerd door een extra woord dat voor uw hoofddomeinnaam staat. Dit is in verschillende gevallen erg handig, bijvoorbeeld:

• het kan worden gebruikt om exclusieve of gerichte inhoud weer te geven, bijvoorbeeld als u naar faq.infomaniak.com gaat, komt u terecht in de kennisbank, waar alle handleidingen staan
• het kan ook (tijdelijk of permanent) worden gebruikt bij het maken van een nieuwe website of het herzien van een bestaande website, bijvoorbeeld door new.domain.xyz aan te maken, terwijl de hoofdsite tot nu toe domain.xyz was

Vereisten

• U bezit minstens één domeinnaam.
• U bezit een webhostingpakket van Infomaniak.

Raadpleeg de handleiding Voeg een subdomein toe aan uw webhosting.

Wat is een alias?

Een alias of alias-domein is een tweede domeinnaam die rechtstreeks naar uw hoofdwebsite verwijst. Ze delen dezelfde webpagina's. De alias is een extra toegang tot uw website. Zo is de hoofdpagina van de Zwitserse Confederatie www.ch.ch en www.suisse.ch is hun alias.

Vereisten

• U bezit meerdere domeinnamen.
• U bezit een webhostingpakket van Infomaniak.

Raadpleeg de handleiding Voeg een alias toe aan uw webhosting.

Het equivalent bestaat ook voor een e-maildienst.

Het voordeel van een alias is dat u de zichtbaarheid van uw website voor uw doelgroep kunt vergroten door meer toegangsmogelijkheden aan te bieden.

Deze handleiding beschrijft de bereiken van openbare IP-adressen die door Infomaniak worden gebruikt. Dit vereenvoudigt met name de configuratie van beveiligingssystemen (firewall, filtering, whitelisting).

Voorwoord

• De adressen worden weergegeven in het CIDR-formaat (bijvoorbeeld: 192.0.2.0/24), wat een reeks opeenvolgende adressen omvat.
• Het formaat van de lijst bevat de IP-bereiken die worden gebruikt door de volgende producten:
  • kuite: alle kSuite-producten
  • vps: alle VPS
  • public-cloud: de gehele Public Cloud
  • all: omvat alle IP-adressen van het Infomaniak-netwerk

Bereiken van IPv4- en IPv6-adressen

De link naar het JSON-bestand met de lijst van IP-adressen is:

https://prefixes.infomaniak.com/json

Deze handleiding gaat over OAuth2-applicaties waarmee u zich kunt aanmelden bij uw externe diensten met behulp van uw Infomaniak-inloggegevens.

Infomaniak OAuth2-applicaties beheren

Volg deze stappen:

1. Klik hier om toegang te krijgen tot het beheer van uw product in de Infomaniak Manager (Hulp nodig?).
2. Klik op de blauwe knop Nieuwe applicatie maken:
   
3. Selecteer het type dat het beste past bij uw behoeften en uw huidige project.
4. Geef de applicatie een naam.
5. Voer de URL van de applicatie in, op basis van de beschikbare technische informatie.
6. Klik op de knop om de applicatie te maken:
   
7. Kopieer de informatie (Client ID, Client Secret) naar een veilige locatie – deze zijn daarna niet meer toegankelijk: