Over integraties

Integraties koppelen je provideraccounts — zoals Hetzner, Cloudflare of AWS — aan InfraNest, zodat je servers, domeinen, DNS en certificaten allemaal op één plek staan. Dit artikel is voor iedereen die wil begrijpen wat integraties doen en hoe je er een koppelt.

#Overzicht

• Elke provider kan één of meer gebieden dekken: Cloud (servers, firewalls, volumes, netwerken, load balancers), DNS (zones en records), Domeinen (geregistreerde domeinen en acties zoals verlengen, overzetten en nameservers) en Certificaten (SSL-certificaten).
• Eén koppeling kan meerdere van deze gebieden tegelijk dekken. Je ziet altijd alleen de acties die een provider daadwerkelijk ondersteunt — alles wat niet kan, is grijs weergegeven.
• Je kunt meer dan één account van dezelfde provider koppelen, bijvoorbeeld twee Hetzner-projecten.

#Een provider koppelen

1. Open Integraties en kies de provider die je wilt.
2. Lees wat deze doet en kies dan Verbinden.
3. Kies welke functies de koppeling moet dekken en geef deze een label zodat je hem later herkent.
4. Als de provider een API-sleutel nodig heeft, volg dan de genummerde stappen op het formulier — dit linkt rechtstreeks naar de pagina waar je de sleutel aanmaakt en geeft precies aan welke rechten je moet aanvinken.
5. Kies Verbinden. InfraNest controleert de sleutel meteen. Ontbreekt er iets, dan zie je wat de provider meldde en een link om het te herstellen. Er wordt pas iets opgeslagen zodra de sleutel werkt.

NoteJe inloggegevens worden versleuteld opgeslagen en worden nadat je ze hebt opgeslagen nooit meer getoond.

NoteAls de provider niet meteen reageert omdat deze druk is of tijdelijk uit de lucht, slaat InfraNest de sleutel toch op en controleert deze opnieuw bij de eerste import — zodat je niet opnieuw hoeft te beginnen.

Elke koppeling heeft ook een gezondheidsindicator, synchroniseert volgens een schema en kan op aanvraag worden vernieuwd met Vernieuwen. Als een synchronisatie mislukt, krijg je een melding.

#Op een suggestie reageren

Bovenaan Browse stelt InfraNest tot drie volgende stappen voor, gebaseerd op dingen die al in je werkruimte staan — nooit op advertenties. Elke suggestie geeft een reden, bijvoorbeeld: "23 van je domeinen gebruiken Cloudflare DNS." Eronder zie je een aantal van de domeinen waarop dit is gebaseerd, zodat je het zelf kunt controleren.

1. Bekijk de suggestie en de reden erachter.
2. Kies Inschakelen als je account bij die provider de taak al aankan maar de functie uitstaat — één klik zet het aan, geen nieuwe sleutel nodig.
3. Kies Verbinden als het een provider is die je domeinen gebruiken maar die je nog niet hebt gekoppeld — dit opent de koppelpagina.
4. Kies Bekijk abonnementen als de suggestie een ander abonnement vereist.
5. Sluit een suggestie met de × als deze niet nuttig is. Dit geldt voor je hele team, en ook op de lijst Domeinen en de instelpagina.

Aanbevolen suggesties zijn anders — dit zijn eigen keuzes van InfraNest en hebben niets te maken met je account. InfraNest stelt altijd alleen providers voor die je kunt koppelen.

Onder je kaarten toont Gekoppeld functies die je gekoppelde accounts al ondersteunen maar die uitstaan, plus automatiseringen die werken met wat je hebt gekoppeld. Een functie inschakelen werkt op dezelfde manier. Dit is verborgen terwijl je zoekt of filtert.

#Iemand anders vragen het te koppelen

Als iemand anders het account beheert — zoals je IT-team of een bureau — heb je hun wachtwoord niet nodig.

1. Open de provider onder Integraties en kies Heb je de inloggegevens niet? Vraag iemand die ze wel heeft, naast Verbinden. Je vindt dit ook naast een voorgestelde koppeling op het koppelformulier, en bij onderdelen van Jouw stack op Home.
2. Lees wat de link toestaat: eenmalig deze ene provider koppelen voor je werkruimte, tot een datum drie dagen later. Ze zien je monitors, domeinen of iets anders niet, en hebben geen InfraNest-account nodig.
3. Kies Kopiëren om de link zelf te versturen, of typ hun adres en kies E-mailen. De e-mail noemt jouw naam en adres, legt uit wat de link wel en niet kan, en hoe ze kunnen controleren dat hij echt is — hij opent altijd op ons eigen app-adres.
4. Wacht tot ze de koppeling maken. Je krijgt een melding en een e-mail. De auditlog toont wie het heeft gevraagd en wie het heeft gekoppeld.

WarningDe link werkt één keer en verloopt na drie dagen. Je kunt hem vanaf dezelfde plek intrekken zolang hij niet is gebruikt.

Als je abonnement geen extra koppeling toelaat, zie je dat al bij het aanmaken van de link, voordat er iemand iets wordt gestuurd.

#De pagina van een integratie verkennen

Klik op een integratie om de pagina te openen. Deze heeft tot drie tabbladen:

1. Overzicht — wat het doet, wat je kunt automatiseren, en na koppeling: Status, Wat het voor je doet, Volgende stappen en Recente activiteit. Als een account is gestopt met werken, is de eerste volgende stap om dit te herstellen.
2. Koppelingen & instellingen — toont je accounts, kanalen of eindpunten, elk met eigen instellingen achter Beheren. De pagina van een account heeft drie tabbladen: Status, Toegang & functies en Account (inclusief Loskoppelen).
3. Activiteit — de verzoeken die InfraNest heeft gedaan, de meldingen die het heeft verstuurd, of de afleveringen naar je eindpunten.

Direct na het koppelen toont de pagina wat er wordt geïmporteerd en hoever dit is gevorderd, bijvoorbeeld "DNS: wordt geïmporteerd — tot nu toe 8 zones". Je kunt de pagina verlaten terwijl dit draait. Een tabblad verschijnt alleen als er iets in staat — een agendafeed heeft geen tabblad Activiteit, omdat er niets ergens naartoe wordt verstuurd. Alles wat aandacht nodig heeft, wordt boven de tabbladen getoond, op welk tabblad je ook bent.

#Beschikbare integraties

• Cloudservers: Hetzner, DigitalOcean, OVHcloud, TransIP.
• DNS: Cloudflare, Hetzner, DigitalOcean, Amazon Web Services (Route 53), OVHcloud, TransIP, GoDaddy, IONOS, Namecheap, Porkbun, Dynadot, Openprovider.
• Domeinen (registrars): Cloudflare, Amazon Web Services (Route 53), OVHcloud, TransIP, GoDaddy, IONOS, Namecheap, Porkbun, Dynadot, Openprovider. Elke registrar ondersteunt een andere set acties — verlengingen, overzettingen, nameservers, automatisch verlengen — de eigen handleiding geeft aan welke.
• Certificaten: SSL.com, plus certificaten die worden beheerd bij Hetzner, Cloudflare, DigitalOcean, Amazon Web Services (ACM), TransIP, IONOS, Namecheap, Porkbun, Openprovider.
• Meldingsbestemmingen: Slack, Microsoft Teams, Telegram, Discord, e-mail.
• Dienst en incidenten: PagerDuty.
• Issuetrackers en verslagen: Jira, Confluence, Linear, Notion, GitHub.
• Automatiseringstools: Zapier, Make, n8n, Power Automate, of elk eigen systeem met een aangepaste webhook.
• Agenda's: Google Calendar, Outlook Calendar, of elke agenda-app via de iCal-feed.

Elke integratie heeft zijn eigen Verbinden-handleiding met de exacte stappen.

#Tips

TipKijk na het koppelen van een provider onder Gekoppeld — dit onthult vaak extra functies die je account al ondersteunt en die alleen nog ingeschakeld hoeven te worden, zonder nieuwe sleutel.