SCIM-gebruikersbeheer voor je organisatie
Nadat je jouw domein hebt geverifieerd en SAML-verificatie hebt ingesteld voor je organisatie, kun je een SCIM API-token genereren.
Kenmerken
Door het SCIM API-token aan je identiteitsserviceprovider te verstrekken, kun je de volgende acties ondernemen via je identiteitsprovider:
- Gebruikers aanmaken
- Gebruikersrollen toewijzen
- Gebruikers deactiveren
Vereisten
Voordat je SCIM-gebruikersbeheer instelt, moet je jouw domein verifiëren en een SAML-configuratie maken. Je kunt alleen gebruikers beheren die zijn gekoppeld aan een domein dat jij hebt geverifieerd.
Configureer SCIM-gebruikersbeheer
- Ga in het Shopify-beheercentrum van je organisatie naar Gebruikers > Beveiliging.
- Klik in de sectie SCIM-integratie op API-token genereren.
- Klik op kopiëren om het gegenereerde token naar je klembord te kopiëren.
- 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.
Volledige SCIM-configuratie in Okta
- Open de Shopify Plus-app.
-
Klik op het tabblad Aanmelden.
- Stel de Indeling gebruikersnaam toepassing in op E-mail.
- Klik op Opslaan.
-
Klik op het tabblad Provisioning.
- Klik op API-integratie configureren.
- Vink API-integratie inschakelen aan en plak vervolgens het API-token in het daarvoor bestemde veld.
- Klik op API-accountgegevens testen. Als je een fout tegenkomt, controleer dan of je het API-token correct hebt gekopieerd van je Shopify Plus-beheercentrum. Als je fouten blijft tegenkomen, neem dan contact op met Shopify Plus-ondersteuning.
- Klik op Opslaan.
Volledige SCIM-configuratie in OneLogin
- Open de Shopify Plus-app.
-
Klik op het menu-item configuratie.
- Plak het API-token in het veld SCIM Bearer Token.
- Klik op Opslaan.
-
Klik op het menu-item Parameters.
- Stel de standaardwaarde SCIM-gebruikersnaam in op e-mailadres.
- Klik op Opslaan.
Voltooi de SCIM-configuratie in Azure
- Open de Shopify Plus-app.
- Klik op het menu-item Provisioning.
- Klik op Aan de slag.
- Selecteer in het menu Provisioning Mode Automatic.
- Voer in het veld Tenant URL de basis-URL in
https://shopifyscim.com/scim/v2/
. - Voer in het veld Geheim token het API-token in.
- Klik op de knop Verbinding testen. Als je een fout tegenkomt, controleer dan of je het API-token correct hebt gekopieerd van je Shopify Plus-beheercentrum. Als je nog steeds fouten tegenkomt, neem dan contact op met Shopify Plus-ondersteuning.
- Klik op Opslaan.
- Wijzig de schakelaar Provisioning-status naar Aan.
- Klik op Opslaan.
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.
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:
|
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:
|
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:
|
Nadat je het API-token hebt toegevoegd, worden nieuwe gebruikers die je toevoegt die voorheen nog niet in Shopify zijn geweest via de identiteitsprovider of de organisatiebeheerder, ingesteld op de status 'in behandeling'. Als het nodig is dat gebruikers inloggen met SAML, blijven ze in de status 'in behandeling' totdat ze inloggen met de identiteitsprovider.
Rollen toewijzen in SCIM
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
We hebben ondersteuning voor de toewijzing van rollen toegevoegd aan de OneLogin-app. Ondersteuning in de Okta- en Azure-apps voegen we later toe. Wijzig de rolnaam voor een bestaande SCIM-gebruiker in de provisioningportal van de identiteitsserviceprovider om deze gebruikersrol toe te wijzen of bij te werken in OneLogin.
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 SCIM-gebruikersrollen toewijzen of bijwerken 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 roles
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 de Shopify-organisatiebeheerder om de toewijzing van een gebruikersrol op te heffen. Hier vind je meer informatie over het opheffen van de toewijzing van 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:
- Ga in het Shopify-beheercentrum van je organisatie naar Gebruikers > Beveiliging.
- Klik in de sectie SCIM-integratie op ... naast het API-token.
- 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 je Shopify-beheercentrum. Als je de organisatie-eigenaar wilt wijzigen, neem je contact op met de Shopify Plus-ondersteuning.