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

  1. Klik linksonder op de naam van je organisatie.
  2. Klik op Instellingen > Beveiliging.
Security tab in Account settings
Security tab in Account settings
  1. Schakel het vakje SCIM-inrichting in.
  2. 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.
Example of an access key
Example of an access key
  1. Klik op Klaar.
  2. 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.

  1. Navigeer naar Toepassing > Toepassingen.
  2. Selecteer de Klaviyo-app.
  3. Ga naar het tabblad Sign On tab.
Four tabs for an app with SSO: General, Sign On, Import, and Assignments
Four tabs for an app with SSO: General, Sign On, Import, and Assignments
  1. Controleer onder Inloggegevensgegevens het volgende:
    • Indeling van applicatiegebruikersnaam is ingesteld op E-mail.
    • Update application username on is ingesteld op Aanmaken en bijwerken.
Credental Details section in the Sign On tab
Credental Details section in the Sign On tab
  1. Klik op het tabblad Algemeen .
General tab for app, when there's no provisioning
General tab for app, when there's no provisioning
  1. Selecteer Bewerken.
  2. Selecteer onder inrichting SCIM.
Selecting SCIM for the provisioning
Selecting SCIM for the provisioning
  1. Klik op Opslaan.
  2. Klik op het tabblad inrichting .
  3. Selecteer Bewerken om de pagina SCIM-verbinding te openen (hieronder weergegeven).
SCIM Connection page with no information
SCIM Connection page with no information
  1. Plak bij SCIM connector basis-URL de basis-URL van Klaviyo.
  2. Voer voor Veld met unieke identificatiecode voor gebruikers userName in.
  3. Vink onder Ondersteunde inrichtingsacties de volgende vakjes aan:
    • Nieuwe gebruikers en profielupdates importeren
    • Nieuwe gebruikers pushen
    • Profielupdate pushen
  4. Wijzig de optie Authenticatiemodus in HTTP-header.
  5. Plak de toegangssleutel onder Autorisatie.
How the SCIM Connection should look once filled out
How the SCIM Connection should look once filled out
  1. Klik op Configuratie van connector testen.
  2. Klik op Opslaan.
  3. Klik naast Inrichting naar app op Bewerken.
  4. Schakel Inschakelen in voor de volgende functies:
    • Gebruikers maken.
    • Gebruikerskenmerk bijwerken.
    • Gebruikers deactiveren.
Enabled features in the Provisioning to App page
Enabled features in the Provisioning to App page
  1. Klik op Opslaan.
  2. Scroll omlaag naar het gedeelte met attribuuttoewijzingen van je app.
  3. Klik op Ga naar profiel-editor.
  4. Klik op Attribuut toevoegen.
Top of the Profile Editor page in Okta, showing the button to add an attribute
Top of the Profile Editor page in Okta, showing the button to add an attribute
  1. Typ "role" voor Weergavenaam, Variabelenaam en Externe naam.
  2. Voer in Externe naamruimte het volgende in:
    urn:ietf:params:scim:schemas:core:2.0:User
  3. Vink het vakje aan voor Genoemde lijst met waarden definiëren.
The first of the required settings for the role attribute
The first of the required settings for the role attribute
  1. Voeg voor een account de standaard rolwaarden hieronder toe. Gebruik voor een portfolio in plaats daarvan portfolio_admin, portfolio_manager en portfolio_analyst.
    • Beheerder
    • Manager
    • Analist
    • campaign_coordinator
    • content_creator
    • social_media_manager
    • Support
All roles with the correct values for the role attribute
All roles with the correct values for the role attribute
  1. Scrol naar beneden naar Kenmerk vereist en vink Ja aan.
  2. Kies het type kenmerk (persoonlijk of groep).
  3. Aanbevolen: laat de Gebruikersmachtiging op Alleen lezen.
The rest of the required settings for the role attribute
The rest of the required settings for the role attribute
  1. Klik op Opslaan.
  2. Navigeer naar Toepassingen > Toepassingen en selecteer vervolgens je app.
  3. Klik op Toewijzen.
  4. Kies of je de app wilt toewijzen aan een individuele gebruiker (d.w.z. personen) of aan een groep.
Assignments tab showing the Assign dropdown
Assignments tab showing the Assign dropdown
  1. Zoek de personen of groepen waaraan je Klaviyo wilt toewijzen en klik op Toewijzen naast hun naam/namen.
Example of searching for a user to assign to an app
Example of searching for a user to assign to an app
  1. Scroll omlaag naar het veld role en wijs de juiste rol toe.
Role dropdown, showing all the values for roles within Klaviyo
Role dropdown, showing all the values for roles within Klaviyo
  1. Klik op Opslaan en teruggaan.
OneLogin
  1. Klik in de Beheerder-portal op Applicaties.
  2. Klik op App toevoegen.
  3. Zoek "Klaviyo."
  4. Klik op Klaviyo om dit toe te voegen.
  5. Optioneel: geef de verbinding een andere naam.
  6. Klik op Configuratie.
  7. Plak je SCIM-toegangssleutel in het veld SCIM Bearer Token .
  8. Klik op Inschakelen onder API Connection.
  9. Klik op Opslaan.
  10. Ga naar inrichting in de linker zijbalk.
  11. Vink het vakje Inrichting inschakelen aan.
  12. Vink de vakjes Create user, Delete user of Update user niet uit.
Credential details section with the correct settings
Credential details section with the correct settings
  1. 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.
  2. 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.

  1. Log in bij Microsoft Entra ID.
  2. Klik op Microsoft Entra ID (voorheen "Azure Active Directory" genoemd)
  3. Klik aan de linkerkant op Enterprise Applications.
The Enterprise applications option in the left sidebar
The Enterprise applications option in the left sidebar
  1. Selecteer je app.
    • Als je je applicatie nog niet hebt gemaakt, volg je de stappen in de SSO-handleiding.
  2. Klik links op Inrichting en selecteer vervolgens Aan de slag.
Left sidebar for app when Provisioning is highlighted
Left sidebar for app when Provisioning is highlighted
  1. Selecteer in het veld met de naam Inrichtingsmodus Automatisch.
Changing the Provisioning mode to automatic
Changing the Provisioning mode to automatic
  1. Ga naar de Beheerder-inloggegevens.
  2. Plak de SCIM-basis-URL van Klaviyo in het veld Tenant URL.
  3. 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).
  4. Test de verbinding.
  5. Zodra de verbinding tot stand is gebracht, klik je linksboven op Opslaan .
  6. Scroll op diezelfde pagina omlaag en open de dropdown Mappings . 
Mappings dropdown to provision (in order) Azure AD groups or users
Mappings dropdown to provision (in order) Azure AD groups or users
  1. Selecteer Inrichting van Azure Active Directory-gebruikers.
  2. Optioneel: verwijder niet-ondersteunde toewijzingen. Klaviyo ondersteunt de volgende doelaattributen voor gebruikersupdates:
    • userName
    • active
    • emails[type eq "work"].value
    • name.givenName
    • name.familyName
    • emails[primary eq "True"].value
    • roles[primary eq "True"].value
  3. Om een toegewezen app-rol toe te wijzen, gebruik je SingleAppRoleAssignment([appRoleAssignments]) als een expressie -toewijzing naar roles[primary eq "True"].value.
    • Koppel appRoleAssignments niet 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.
  4. Klik op Opslaan en klik vervolgens op Start.
  5. Navigeer terug naar Microsoft Entra ID > Enterprise applications > Klaviyo > inrichting.
  6. Selecteer Inrichting starten.
Provisioning tab, showing the start provisioning button
Provisioning tab, showing the start provisioning button

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.

Was dit artikel nuttig?
Gebruik dit formulier alleen voor feedback op artikelen. Meer informatie over hoe je contact opneemt met support.

Ontdek meer van Klaviyo

Community
Maak contact met collega's, partners en Klaviyo-experts om inspiratie op te doen, inzichten te delen en antwoorden te krijgen op al je vragen.
Partners
Huur een Klaviyo-gecertificeerde expert in om je te helpen met een specifieke taak of voor doorlopend marketingbeheer.
Support

Krijg ondersteuning via je account.

E-mailsupport (gratis proefperiodes en betaalde accounts) 24/7 beschikbaar

Chat-/virtuele assistentie
Beschikbaarheid varieert per locatie en type abonnement