SCIM-gebruikersinrichting instellen
Wat je leert
Lees hoe je een systeem instelt voor SCIM-gebruikersinrichting voor cross-domain identity management in een account of portfolio.
SCIM is beschikbaar voor accounts met een betaald abonnement en voor portfolio’s. Gebruik om het in te stellen een Beheerder- of eigenaarrol in een account, of een portfolio Beheerder- of portfolio eigenaarrol in een portfolio.
Voordat je van start gaat
Je moet ook SSO ingeschakeld hebben in Klaviyo voordat je SCIM instelt.
Let op dat SCIM-inrichting vaak een add-on is voor identiteitsproviders (IdP's). IdP's vereisen bijvoorbeeld vaak een apart SCIM-abonnement naast een SSO-abonnement. Als je de volgende stappen niet ziet in je IdP, controleer dan of je het juiste abonnement hebt.
Voor elke gebruiker moet je IdP een rol en een e-mailadres sturen als userName. De gebruikersnaam moet overeenkomen met een e-mailwaarde die voor die gebruiker is verzonden.
Gebruik voor een portfolio portfolio_admin, portfolio_manager of portfolio_analyst. accountrollen zoals admin zijn niet van toepassing op portfolio's. SCIM kan geen gebruikers aanmaken met de rol eigenaar of portfolio-eigenaar.
Klaviyo ondersteunt de inrichting van gebruikers, maar geen groepsobjecten. Je kunt een IdP-groep toewijzen om bepaalde gebruikers te selecteren voor inrichting, maar laat inrichting van groepen uitgeschakeld.
SCIM-gebruikersinrichting inschakelen
- Klik linksonder op de naam van je organisatie.
- Klik op Instellingen > Beveiliging.

- Schakel het vakje SCIM-inrichting in.
- Klik op Kopiëren of Downloaden (.txt) om de toegangssleutel op te slaan zoals weergegeven.
Deze sleutel wordt maar één keer weergegeven, dus sla hem op een veilige plek op voordat je het dialoogvenster sluit.

- Klik op Klaar.
- Kopieer de basis-URL en plak deze ergens, bij voorkeur waar je de toegangssleutel hebt opgeslagen.
Als je een SCIM-sleutel vervangt, wordt de vorige sleutel direct ongeldig. Als je je sleutel kwijtraakt, klik je op SCIM-sleutel vervangen en daarna op Bevestigen. Sla de nieuwe sleutel op en werk deze bij in je IdP.
Ga vervolgens naar je identiteitsprovider om het proces af te ronden. Hieronder vind je instructies voor Okta, OneLogin en Microsoft Entra ID. Andere providers moeten compatibele SCIM 2.0-inrichting van gebruikers ondersteunen.
Okta
Raadpleeg voor de huidige navigatie in de installatie Okta’s SCIM-installatiehandleiding. Gebruik hieronder de verbindingsinstellingen van Klaviyo.
- Navigeer naar Toepassing > Toepassingen.
- Selecteer de Klaviyo-app.
- Ga naar het tabblad Sign On tab.

- Controleer onder Inloggegevensgegevens het volgende:
- Indeling van applicatiegebruikersnaam is ingesteld op E-mail.
- Update application username on is ingesteld op Aanmaken en bijwerken.

- Klik op het tabblad Algemeen .

- Selecteer Bewerken.
- Selecteer onder inrichting SCIM.

- Klik op Opslaan.
- Klik op het tabblad inrichting .
- Selecteer Bewerken om de pagina SCIM-verbinding te openen (hieronder weergegeven).

- Plak bij SCIM connector basis-URL de basis-URL van Klaviyo.
- Voer voor Veld met unieke identificatiecode voor gebruikers
userNamein. - Vink onder Ondersteunde inrichtingsacties de volgende vakjes aan:
- Nieuwe gebruikers en profielupdates importeren
- Nieuwe gebruikers pushen
- Profielupdate pushen
- Wijzig de optie Authenticatiemodus in HTTP-header.
- Plak de toegangssleutel onder Autorisatie.

- Klik op Configuratie van connector testen.
- Klik op Opslaan.
- Klik naast Inrichting naar app op Bewerken.
- Schakel Inschakelen in voor de volgende functies:
- Gebruikers maken.
- Gebruikerskenmerk bijwerken.
- Gebruikers deactiveren.

- Klik op Opslaan.
- Scroll omlaag naar het gedeelte met attribuuttoewijzingen van je app.
- Klik op Ga naar profiel-editor.
- Klik op Attribuut toevoegen.

- Typ "role" voor Weergavenaam, Variabelenaam en Externe naam.
- Voer in Externe naamruimte het volgende in:
urn:ietf:params:scim:schemas:core:2.0:User - Vink het vakje aan voor Genoemde lijst met waarden definiëren.

- Voeg voor een account de standaard rolwaarden hieronder toe. Gebruik voor een portfolio in plaats daarvan
portfolio_admin,portfolio_managerenportfolio_analyst.- Beheerder
- Manager
- Analist
- campaign_coordinator
- content_creator
social_media_manager- Support

- Scrol naar beneden naar Kenmerk vereist en vink Ja aan.
- Kies het type kenmerk (persoonlijk of groep).
- Aanbevolen: laat de Gebruikersmachtiging op Alleen lezen.

- Klik op Opslaan.
- Navigeer naar Toepassingen > Toepassingen en selecteer vervolgens je app.
- Klik op Toewijzen.
- Kies of je de app wilt toewijzen aan een individuele gebruiker (d.w.z. personen) of aan een groep.

- Zoek de personen of groepen waaraan je Klaviyo wilt toewijzen en klik op Toewijzen naast hun naam/namen.

- Scroll omlaag naar het veld role en wijs de juiste rol toe.

- Klik op Opslaan en teruggaan.
OneLogin
- Klik in de Beheerder-portal op Applicaties.
- Klik op App toevoegen.
- Zoek "Klaviyo."
- Klik op Klaviyo om dit toe te voegen.
- Optioneel: geef de verbinding een andere naam.
- Klik op Configuratie.
- Plak je SCIM-toegangssleutel in het veld SCIM Bearer Token .
- Klik op Inschakelen onder API Connection.
- Klik op Opslaan.
- Ga naar inrichting in de linker zijbalk.
- Vink het vakje Inrichting inschakelen aan.
- Vink de vakjes Create user, Delete user of Update user niet uit.

- Aanbevolen: selecteer Verwijderen in de dropdown voor Wanneer gebruikers worden verwijderd in OneLogin, of de app-toegang van de gebruiker wordt verwijderd, voer je de onderstaande actie uit.
- Klik op Opslaan.
Microsoft Entra ID (voorheen Azure AD)
Bekijk voor de huidige navigatie voor de setup Microsofts SCIM-inrichtingshandleiding. Gebruik hieronder de Klaviyo-URL, toegangssleutel en mappings.
- Log in bij Microsoft Entra ID.
- Klik op Microsoft Entra ID (voorheen "Azure Active Directory" genoemd)
- Klik aan de linkerkant op Enterprise Applications.

- Selecteer je app.
- Als je je applicatie nog niet hebt gemaakt, volg je de stappen in de SSO-handleiding.
- Klik links op Inrichting en selecteer vervolgens Aan de slag.

- Selecteer in het veld met de naam Inrichtingsmodus Automatisch.

- Ga naar de Beheerder-inloggegevens.
- Plak de SCIM-basis-URL van Klaviyo in het veld Tenant URL.
- Plak de SCIM API-sleutel in het veld Secret Token. Houd er rekening mee dat je deze token zonder voorvoegsels moet plakken (bijv. voeg geen "Bearer" of "Klaviyo-API-sleutel" toe).
- Test de verbinding.
- Zodra de verbinding tot stand is gebracht, klik je linksboven op Opslaan .
- Scroll op diezelfde pagina omlaag en open de dropdown Mappings .

- Selecteer Inrichting van Azure Active Directory-gebruikers.
- Optioneel: verwijder niet-ondersteunde toewijzingen. Klaviyo ondersteunt de volgende doelaattributen voor gebruikersupdates:
userNameactiveemails[type eq "work"].valuename.givenNamename.familyNameemails[primary eq "True"].valueroles[primary eq "True"].value
- Om een toegewezen app-rol toe te wijzen, gebruik je
SingleAppRoleAssignment([appRoleAssignments])als een expressie -toewijzing naarroles[primary eq "True"].value.- Koppel
appRoleAssignmentsniet rechtstreeks aan Klaviyo. - Wijs per gebruiker 1 app-rol toe en beperk inrichting tot toegewezen gebruikers en groepen. Deze expressie ondersteunt het synchroniseren van alle gebruikers en groepen niet. Bekijk Microsofts richtlijnen voor het toewijzen van rollen.
- Koppel
- Klik op Opslaan en klik vervolgens op Start.
- Navigeer terug naar Microsoft Entra ID > Enterprise applications > Klaviyo > inrichting.
- Selecteer Inrichting starten.

Nu begint Microsoft Entra ID met de inrichting van je gebruikers volgens een schema. Voor meer inzichten in welke gebruikers het heeft ingericht, selecteer je Inrichtingslogboeken bekijken.
Extra hulpbronnen
- Single sign-on (SSO, eenmalige aanmelding) instellen
Lees hoe je eenmalige aanmelding (SSO) instelt voor je Klaviyo-account of -portfolio. Momenteel wordt in Klaviyo alleen single sign-on via identity provider (IdP) ondersteund.
- Problemen met SSO- en SCIM-fouten oplossen
Ontdek hoe je fouten bij single sign-on (SSO) met Klaviyo kunt oplossen. Dit artikel is bedoeld voor mensen die bekend zijn met SSO, zoals IT-professionals.
- Hoe de facturering van Klaviyo werkt
Leer hoe Klaviyo klanten factureert voor profiel en e-mails, mobiele berichten, Reviews, Advanced Klaviyo Data Platform (voorheen 'platform voor klantgegevens'), Klaviyo Marketing Analytics, Klaviyo Customer Hub, Helpdesk en Klantenserviceagent.