SCIM-användarhantering

När du har verifierat din domän och konfigurerat SAML-autentisering (Security Assertion Markup Language) för din organisation kan du generera en API-token för SCIM (System for Cross-domain Identity Management). Det är endast organisationer i Shopify Plus-planen som kan generera SCIM-tokens för användare.

Funktioner

Genom att ange SCIM API-token till din identitetsleverantör kan du vidta följande åtgärder via identitetsleverantören:

• Skapa användare
• Tilldela eller uppdatera grupper
• Inaktivera användare

Krav för SCIM-hantering

Innan du konfigurerar SCIM-användarhantering måste du verifiera din domän och skapa en SAML-konfiguration. Du kan endast hantera användare som är kopplade till en domän som du har verifierat för din organisation.

Att tänka på vid SCIM-hantering

Gå igenom följande att tänka på när du använder SCIM-hantering för dina användare:

• Användare som skapas via SCIM får inget inbjudningsmeddelande via e-post. Användaren måste logga in via identitetsleverantören för att aktivera sitt konto.
• När du har lagt till API-token och lägger till en ny användare som inte tidigare funnits i Shopify, antingen via din identitetsleverantör eller via inställningarna för Användare, får den nya användaren statusen Väntande. Om användaren måste logga in med SAML förblir statusen Väntande tills hen loggar in via din identitetsleverantör.
• Gruppnamnet hos din identitetsleverantör och gruppnamnet i din Shopify-admin måste vara identiska. Gruppnamnet hos identitetsleverantören måste matcha det valfria anpassade gruppattributet som används för att synkronisera med Shopify, inte identitetsleverantörens standardattribut för grupper.
• Butiksägare och organisationsägare kan inte tas bort via en identitetsleverantör. Båda typerna av ägande måste överföras innan användaren kan tas bort. Om du behöver byta butiksägare kan du göra det från din Shopify-admin. Om du behöver byta organisationsägare, kontakta Shopify Plus-supporten.

Konfigurera SCIM-användarhantering

För att konfigurera SCIM-hantering måste du generera en API-token från din Shopify-admin och sedan slutföra konfigurationen hos din valda identitetsleverantör.

1. Gå till Inställningar > Användare i din Shopify-admin.

2. Klicka på Säkerhet.

3. Klicka på Generera API-token i avsnittet SCIM-integration.

4. Klicka på Kopiera för att kopiera den genererade tokenen till ditt urklipp.

5. Ange tokenen för din identitetsleverantör. Proceduren för att lägga till tokenen beror på vilken identitetsleverantör du använder.

Hantera användare med SCIM

När din API-token har lagts till hos din identitetsleverantör kan du lägga till eller ta bort användare via den tjänsten. Beroende på användarens status i Shopify och hos din identitetsleverantör kan detta ändra hur hen loggar in på Shopify.

När du har lagt till API-tokenen och lägger till en ny användare som inte tidigare fanns i Shopify, antingen via din identitetsleverantör eller via organisationsinställningarna, ställs din nya användare in på statusen Väntande. Om din användare måste logga in med SAML förblir hen i statusen Väntande tills hen loggar in via din identitetsleverantör.

Grupptilldelning i SCIM

När du har slutfört SCIM-konfigurationen kan du valfritt tilldela grupper till SCIM-användare via din identitetsleverantör. Innan du tilldelar en grupp till en användare, verifiera att gruppen finns i din organisation. Om gruppen inte har skapats i din Shopify admin uppdateras inte befintliga SCIM-användare.

Tilldelning av grupper hos identitetsleverantörer som stöds

Okta Group Push stöds inte med Shopify Plus. Mer information finns på den officiella Okta-integrationssidan.

Grupptilldelning stöds i Entra-, OneLogin- och Okta-apparna. Skapande och tilldelning av gruppnamn skiljer sig åt för varje identitetsleverantör.

Verifiera att gruppen finns i din Shopify admin innan du tilldelar den till en användare.

Tilldelning av grupper hos identitetsleverantörer som inte stöds

Om din identitetsleverantör inte har en Shopify Plus-app måste du redigera din SCIM-konfiguration manuellt. Innan du börjar, verifiera att din identitetsleverantör kan lägga till grupper som ett SCIM-fält.

SCIM JSON-kroppen måste innehålla en nyckel som kallas roles. Nyckeln roles måste vara en matris som innehåller en hash som lagrar rollnamnet. Om flera rollnamnshashar anges används endast den sista rollnamnshashen för att tilldela en roll. Om rollnamnet är ogiltigt, eller om SCIM JSON-kroppen inte matchar mallen ovan, kommer grupper inte att tilldelas eller uppdateras.

För att tilldela eller uppdatera en SCIM-grupp måste JSON-kroppen i förfrågningar av typen POST, PUT och PATCH innehålla följande:

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

Ta bort grupptilldelning

Du kan ta bort tilldelningen av en grupp från sidan Inställningar > Användare i din Shopify admin. Läs mer om att hantera grupper.

Ta bort SCIM-integration

Om du inte längre behöver en SCIM-integration kan du ta bort den. Den här åtgärden kan inte ångras. Om du behöver återaktivera din integration måste du generera en ny API-token.

Steg:

1. Gå till Inställningar > Användare i din Shopify-admin.

2. Klicka på Säkerhet.

3. I avsnittet SCIM-integration klickar du på bredvid API-tokenen.

4. Klicka på Radera token.