Privé integraties: Alles wat je moet weten

Wat zijn privé integraties?

Met privé integraties kun je krachtige aangepaste integraties bouwen tussen je account en externe applicaties die beschikken over een api (maar bijvoorbeeld niet in Zapier zitten). Zo maak je jouw Voluit Suite helemaal naar jouw wens.

Als je je account wilt integreren met een externe app, heb je twee opties:

1. Zoek en installeer een relevante app uit de App Marketplace
2. Bouw je eigen private integratie zelf of met hulp van een ontwikkelaar via APIs.

privé integraties helpt je om optie 2 veilig te realiseren.

De belangrijkste voordelen van privé integraties zijn:

• Eenvoudig: Genereer privé integratie tokens vanuit je accountinstellingen en beheer ze gemakkelijk.
• Veilig: Je bepaalt zelf welke rechten en toegang een ontwikkelaar heeft tot je account

Wat is het verschil tussen privé integraties en API Keys?

privé integraties is een krachtigere en veiligere optie dan API Keys.

Hoe gebruik je privé integraties?

Wie kan privé integraties aanmaken?

Standaard kunnen alle accountbeheerders privé integraties aanmaken en beheren.

Je kunt deze machtiging per gebruiker beperken. Ga hiervoor naar Instellingen > Mijn Medewerkers > Bewerk de specifieke gebruiker > Rollen & Machtigingen, en schakel privé integraties in of uit voor de gebruiker.

Waar vind ik privé integraties?

Om privé integraties te beheren, ga je naar Instellingen en scroll je naar beneden naar het gedeelte 'private integrations/ privé integraties' in het linker navigatiemenu.

Hoe maak ik een nieuwe privé integratie aan?

Stap 1: Klik op "Nieuwe integratie aanmaken"

Stap 2: Geef je privé integratie een naam en beschrijving zodat jij en je team weten waar deze voor dient.

Stap 3: Selecteer de rechten die je de privé integratie wilt geven op je account. Selecteer alleen de rechten die noodzakelijk zijn voor betere databeveiliging.

Stap 4: Kopieer het gegenereerde token en deel dit met je externe app ontwikkelaar.

Deel het token alleen met vertrouwde partijen. Deel het niet openbaar.

Wat zijn de beste praktijken voor het beveiligen van mijn privé integratie token?

We raden aan om je privé integratie tokens elke 90 dagen te verversen.

Dit doe je als volgt:

Stap 1: Ga naar privé integraties onder instellingen en klik op de privé integratie die je hebt aangemaakt.

Stap 2: Klik op "Token verversen en later laten verlopen"

Stap 3: Klik op "Doorgaan" als reactie op de waarschuwing wanneer je zeker weet dat je wilt doorgaan met verversen.

Stap 4: Kopieer het nieuwe token en werk het bij in je externe app. Je hebt een periode van 7 dagen waarin zowel het oude als het nieuwe token blijven werken. Na 7 dagen verloopt het oude token. In deze periode van 7 dagen heb je de volgende opties:

1. "Verversen annuleren" als bijvoorbeeld je ontwikkelaar meer tijd nodig heeft om het token in de externe app bij te werken.
2. "Nu laten verlopen" als bijvoorbeeld de externe app is bijgewerkt met het nieuwe token.

Is je token gecompromitteerd? Dit kun je doen

Stap 1: Ga naar privé integraties onder instellingen en klik op de privé integratie die je hebt aangemaakt.

Stap 2: Klik op "Token direct verversen en verlopen".

Stap 3: Klik op "Doorgaan" als reactie op de waarschuwing wanneer je zeker weet dat je wilt doorgaan met het verversen.

Stap 4: Kopieer het nieuwe token en werk het bij in je externe app.

Let op: Vergeet niet het gegenereerde token te kopiëren, want je kunt dit later niet meer inzien.

Kan ik de rechten van mijn privé integratie aanpassen zonder het token te updaten?

Je kunt de naam, beschrijving en rechten/toegang van je privé integratie op elk moment na het aanmaken wijzigen.

Dit doe je als volgt:

Stap 1: Ga naar privé integraties onder instellingen en kies 'Bewerken' in het drie-punten menu.

Stap 2: Pas indien nodig de naam en beschrijving van de privé integratie aan. Klik op "Volgende".

Stap 3: Pas indien nodig de rechten aan die je de privé integratie wilt geven op je account. Selecteer alleen de rechten die noodzakelijk zijn voor betere databeveiliging. Klik op "Bijwerken" om de wijzigingen op te slaan.

Let op: Bij het bijwerken van de privé integratie details wordt er geen nieuw token gegenereerd. Het bestaande token blijft gewoon werken.

Hoe verwijder ik de privé integratie als ik deze niet meer nodig heb?

Je kunt de privé integratie verwijderen zodra je de externe app niet meer gebruikt.

Ga hiervoor naar privé integraties onder instellingen en kies 'Verwijderen' in het drie-punten menu.