SCIM-gebruikersbeheer voor je Shopify Plus-organisatie

Abonnementvereiste

SCIM-gebruikersbeheer is alleen beschikbaar voor organisaties met het Shopify Plus-abonnement.

Nadat je je domein hebt geverifieerd en SAML-verificatie (Security Assertion Markup Language) hebt ingesteld voor je organisatie, kun je een API-token voor SCIM (System for Cross-domain Identity Management) genereren. Het genereren van SCIM-tokens voor gebruikers is alleen beschikbaar voor organisaties waarvoor je een Shopify Plus-abonnement hebt.

Kenmerken

Vroege toegang

Als je organisatie deel uitmaakt van de vroege toegang voor op rollen gebaseerde toegangscontrole, wijs je gebruikers toe aan groepen in plaats van aan rollen. Hier vind je meer informatie over migreren naar het op rollen gebaseerde toegangscontrolemodel.

Door het SCIM API-token aan je identiteitsserviceprovider te verstrekken, kun je de volgende acties ondernemen via je identiteitsprovider:

• Gebruikers aanmaken
• Gebruikersrollen toewijzen of bijwerken
• Gebruikers deactiveren

Vereisten

Voordat je SCIM-gebruikersbeheer instelt, moet je je domein verifiëren en een SAML-configuratie aanmaken. Je kunt alleen gebruikers beheren die zijn gekoppeld aan een domein dat je hebt geverifieerd voor je Shopify Plus-organisatie.

Configureer SCIM-gebruikersbeheer

1. Klik in je Shopify-beheercentrum op Instellingen.
2. Klik in de sectie Organisatie op Gebruikers > Beveiliging.
3. Klik in de sectie SCIM-integratie op API-token genereren.
4. Klik op kopiëren om het gegenereerde token naar je klembord te kopiëren.
5. Geef het token door aan je provider voor identiteitsproviders. De procedure voor het toevoegen van het token is afhankelijk van de ID-provider die je gebruikt.

Opmerking

Als je een andere identiteitsserviceprovider gebruikt dan Okta, OneLogin of Entra, moet je mogelijk naast een API-token ook een basis-URL opgeven. Als je identiteitsserviceprovider om een basis-URL vraagt, gebruik dan https://shopifyscim.com/scim/v2/.

Nadat je API-token is toegevoegd aan je identiteitsserviceprovider, kun je via die service gebruikers toevoegen of verwijderen. Afhankelijk van de status van die gebruiker binnen Shopify en je identiteitsserviceprovider, kan dit de manier waarop ze inloggen bij Shopify veranderen.

Effecten van het aanmaken van een gebruiker in een identiteitsprovider

Gebruikersstatus	Effect binnen Shopify
Gebruiker bestaat al in je organisatie	Als je een gebruiker toevoegt aan je identiteitsserviceprovider, moet de gebruiker inloggen met SAML-verificatie als aan al het volgende wordt voldaan: de gebruiker bestaat al in Shopify de gebruiker bestaat al in je organisatie je gebruikt Specifieke gebruikers-handhaving Welk effect het verwijderen van de toegang via je identiteitsprovider voor gebruikers heeft, hangt van hun gebruikersstatus af. Als je de toegang van een actieve gebruiker tot Shopify verwijdert via je identiteitsprovider, wordt deze gebruiker opgeschort in je organisatie. Als je een gebruiker permanent verwijdert met je identiteitsprovider, wordt deze mogelijk uit je organisatie verwijderd, afhankelijk van de instellingen van je identiteitsprovider.
Gebruiker bestaat in Shopify, maar je organisatie niet	Als je een gebruiker toevoegt aan je identiteitsserviceprovider, wordt de gebruiker toegevoegd aan jouw organisatie en moet deze inloggen met SAML-verificatie als aan het volgende wordt voldaan: de gebruiker bestaat al in Shopify de gebruiker bestaat niet in je specifieke organisatie je gebruikt Verplichte of Specifieke gebruikers-handhaving
Gebruiker bestaat niet in Shopify	Als je een gebruiker toevoegt aan de identiteitsserviceprovider, wordt de gebruiker toegevoegd aan de organisatie en kan die inloggen met SAML-verificatie als aan het volgende wordt voldaan: de gebruiker bestaat niet in Shopify je gebruikt Verplichte of Specifieke gebruikers-handhaving Wanneer de gebruiker voor de eerste keer inlogt bij het Shopify-beheercentrum, kan diegene dat alleen doen via de identiteitsprovider, niet via de Shopify-inlogpagina.

Nadat je het API-token hebt toegevoegd, krijgen nieuwe gebruikers die je toevoegt die voorheen nog niet in Shopify zijn geweest via de identiteitsprovider of de Organisatie-instellingen, de status 'in behandeling'. Als het nodig is dat gebruikers inloggen met SAML, behouden ze de status 'in behandeling' totdat ze inloggen met de identiteitsprovider.

Rollen toewijzen in SCIM

Vroege toegang

Als je organisatie deel uitmaakt van de vroege toegang voor op rollen gebaseerde toegangscontrole, wijs je gebruikers toe aan groepen in plaats van aan rollen. Hier vind je meer informatie over migreren naar het op rollen gebaseerde toegangscontrolemodel.

Nadat je de SCIM-configuratie hebt voltooid, kun je optioneel rollen toewijzen aan SCIM-gebruikers via de identiteitsserviceprovider. Ga voordat je een rol aan een gebruiker toewijst na of die rol bestaat in de organisatie. Bestaande SCIM-gebruikers worden niet bijgewerkt als de rol niet is aangemaakt voor de organisatie.

Rollen toewijzen in ondersteunde identiteitsserviceproviders

Roltoewijzing wordt ondersteund in de apps van Entra, OneLogin en Okta. Het aanmaken en toewijzen van rolnamen is voor elke identiteitsprovider anders.

Opmerking

Ga voordat je een rol aan een gebruiker toewijst na of die rol bestaat in je Shopify-organisatie.

Rollen toewijzen in niet-ondersteunde identiteitsserviceproviders

Als de identiteitsserviceprovider geen Shopify Plus-app heeft, kun je de SCIM-configuratie alleen handmatig bewerken. Ga voordat je begint na of de identiteitsserviceprovider rollen kan toevoegen als SCIM-veld.

Je kunt alleen een SCIM-gebruikersrol toewijzen of bewerken als de JSON-body in POST-, PUT- en PATCH-aanvragen het volgende bevat:

{
  "name": {
    "givenName": "given_name"
    "familyName": "family_name"
  },
  "userName": "email",
  "roles": [{"value": "role_name"}]
}

Voor de SCIM JSON-body is een sleutel nodig met de naam roles. Het is vereist dat de roles-sleutel een reeks is met een hash waarin de naam van de rol wordt opgeslagen. Als er meerdere hashes voor namen van rollen worden opgegeven, wordt alleen de laatste hash met rolnaam gebruikt om een rol toe te wijzen. Als de naam van de rol ongeldig is of als de SCIM JSON-body niet overeenkomt met de bovenstaande template, worden er geen rollen toegewezen of bijgewerkt.

Toewijzing van rollen opheffen

Gebruik Organisatie-instellingen als je de toewijzing van een gebruikersrol wilt intrekken. Lees meer over het intrekken van toegewezen gebruikersrollen in Shopify.

SCIM-integratie verwijderen

Als je geen SCIM-integratie meer nodig hebt, kun je deze verwijderen. Deze actie kan niet ongedaan worden gemaakt. Als je je integratie opnieuw moet activeren, moet je een nieuw API-token genereren.

Stappen:

1. Klik in je Shopify-beheercentrum op Instellingen.
2. Ga in de sectie Organisatie naar Gebruikers > Beveiliging.
3. Klik in de sectie SCIM-integratie op ... naast het API-token.
4. Klik op Token verwijderen.

Beperkingen

Winkeleigenaren en organisatie-eigenaren kunnen niet worden verwijderd via een identiteitsserviceprovider. De gebruiker kan pas worden verwijderd als beide soorten eigendom zijn overgedragen. Als je de winkeleigenaar wilt wijzigen, kun je dit doen vanuit het Shopify-beheercentrum. Als je de organisatie-eigenaar wilt wijzigen, neem je contact op met de Shopify Plus-ondersteuning.