Zarządzanie użytkownikami SCIM dla Twojej organizacji

Wymóg dotyczący planu

Funkcja zarządzania użytkownikami SCIM jest dostępna tylko dla organizacji korzystających z planu Shopify Plus.

Po zweryfikowaniu domeny i skonfigurowaniu uwierzytelniania SAML (Security Assertion Markup Language) dla swojej organizacji możesz wygenerować token API SCIM (System for Cross-domain Identity Management). Generowanie tokenów SCIM dla użytkowników jest dostępne tylko dla organizacji korzystających z planu Shopify Plus.

Funkcje

Dostarczenie tokena API SCIM do dostawcy usług tożsamości pozwala podjąć następujące działania za pośrednictwem dostawcy tożsamości:

• Tworzenie użytkowników
• Przypisz lub zaktualizuj role użytkownika
• Dezaktywacja użytkowników

Wymagania

Przed skonfigurowaniem zarządzania użytkownikami SCIM musisz zweryfikować swoją domenę i utworzyć konfigurację SAML. Możesz zarządzać tylko użytkownikami, którzy są związani ze zweryfikowaną domeną dla Twojej organizacji.

Konfiguracja zarządzania użytkownikami SCIM

1. W panelu administracyjnym Shopify przejdź do opcji Ustawienia > Użytkownicy i uprawnienia.

2. Kliknij Zabezpieczenia.

3. W sekcji Integracja SCIM kliknij Generuj token API.

4. Kliknij Kopiuj, aby skopiować wygenerowany token do schowka.

5. Podaj token dostawcy usług tożsamości. Procedura dodawania tokenu zależy od tego, z usług którego dostawcy usług tożsamości korzystasz.

Uwaga

Jeśli korzystasz z dostawcy usług tożsamości innego niż Okta, OneLogin lub Entra, być może oprócz tokena API będziesz musiał(-a) podać podstawowy adres URL. Jeśli Twój dostawca usług tożsamości żąda podstawowego adresu URL, użyj https://shopifyscim.com/scim/v2/.

Okta

Ukończ konfigurację SCIM w Okta

1. Otwórz aplikację Shopify Plus.

2. Kliknij kartę Logowanie.

   1. Ustaw Format nazwy użytkownika aplikacji na E-mail.
   2. Kliknij opcję Zapisz.

3. Kliknij kartę Aprowizacja.

   1. Kliknij opcję Konfiguruj integrację API.
   2. Wybierz opcję Włącz integrację API, a następnie wklej token API w podanym polu.
   3. Kliknij opcję Testuj poświadczenia API. Jeśli wystąpi błąd, sprawdź, czy token API został poprawnie skopiowany. Jeśli nadal napotykasz błędy, skontaktuj się z pomocą techniczną Shopify Plus.
   4. Kliknij opcję Zapisz.

OneLogin

Ukończ konfigurację SCIM w OneLogin

1. Otwórz aplikację Shopify Plus.

2. Kliknij pozycję menu Konfiguracja.

   1. W polu Token okaziciela SCIM wklej token API.
   2. Kliknij opcję Zapisz.

3. Kliknij pozycję menu Parametry.

   1. Ustaw domyślną wartość Nazwy użytkownika SCIM na E-mail.
   2. Kliknij opcję Zapisz.

Entra

Ukończ konfigurację SCIM w Entra

1. Otwórz aplikację Shopify Plus.
2. Kliknij pozycję menu Aprowizacja.
3. Kliknij opcję Rozpocznij.
4. W menu Tryb udostępniania wybierz opcję Automatyczny.
5. W polu Adres URL dzierżawy wprowadź podstawowy adres URL https://shopifyscim.com/scim/v2/.
6. W polu Tajny token wprowadź token API.
7. Kliknij przycisk Testuj połączenie. Jeśli wystąpi błąd, sprawdź, czy token API został poprawnie skopiowany. Jeśli nadal napotykasz błędy, skontaktuj się z Pomocą techniczną Shopify Plus.
8. Kliknij opcję Zapisz.
9. Zmień przełącznik Status udostępniania na Włączony.
10. Kliknij opcję Zapisz.

Po dodaniu tokena API do dostawcy usług tożsamości możesz dodawać lub usuwać użytkowników za pośrednictwem tej usługi. W zależności od statusu tego użytkownika w Shopify i Twojego dostawcy usług tożsamości, może to zmienić sposób logowania do Shopify.

Wyniki utworzenia użytkownika w dostawcy tożsamości

Status użytkownika	Wynik w Shopify
Użytkownik już istnieje w Twojej organizacji	Jeśli dodasz użytkownika w swoim dostawcy usług tożsamości, użytkownik jest zobowiązany do zalogowania się przy użyciu uwierzytelniania SAML, jeśli spełnione są wszystkie poniższe warunki: Użytkownik już istnieje w Shopify użytkownik już istnieje w Twojej organizacji korzystasz z egzekwowania określonych użytkowników Efekt usunięcia dostępu użytkownika za pośrednictwem dostawcy tożsamości zależy od jego statusu użytkownika. Jeśli trwale usuniesz dostęp aktywnego użytkownika do Shopify za pomocą dostawcy usług tożsamości, zostaje on zawieszony w Twojej organizacji. Jeśli trwale usuniesz użytkownika za pomocą dostawcy usług tożsamości, może on zostać usunięty z Twojej organizacji, w zależności od konfiguracji dostawcy tożsamości.
Użytkownik istnieje w Shopify, ale nie w Twojej organizacji	Jeśli dodasz użytkownika do dostawcy usług tożsamości, zostanie on dodany do Twojej organizacji i będzie musiał zalogować się przy użyciu uwierzytelniania SAML, jeśli spełnione są wszystkie poniższe warunki: Użytkownik już istnieje w Shopify Użytkownik nie istnieje w określonej organizacji Korzystasz z egzekwowania wymaganych lub określonych użytkowników
Użytkownik nie istnieje w Shopify	Jeśli dodasz użytkownika do dostawcy usług tożsamości, zostanie on dodany do Twojej organizacji i będzie musiał zalogować się przy użyciu uwierzytelniania SAML, jeśli spełnione są wszystkie poniższe warunki: użytkownik nie istnieje w Shopify Korzystasz z egzekwowania wymaganych lub określonych użytkowników Gdy użytkownik zaloguje się do panelu administracyjnego Shopify po raz pierwszy, ten użytkownik musi to zrobić za pośrednictwem dostawcy tożsamości, a nie za pośrednictwem strony logowania Shopify.

Po dodaniu tokena API dla nowego użytkownika (który nie istniał dotąd w Shopify) za pośrednictwem dostawcy tożsamości lub ustawień organizacji, nowy użytkownik uzyskuje status Oczekujący. Jeśli od Twojego użytkownika wymaga się logowania za pomocą protokołu SAML, będzie on mieć status Oczekujący, dopóki nie zaloguje się za pośrednictwem Twojego dostawcy tożsamości.

Przypisywanie ról w SCIM

Uwaga

Jeśli Twoja organizacja korzysta z funkcji kontroli dostępu opartego na rolach, przypisz użytkowników do grup zamiast ról. Dowiedz się więcej o migracji do modelu kontroli dostępu opartego na rolach.

Po zakończeniu konfiguracji SCIM możesz przypisać role do użytkowników SCIM za pośrednictwem dostawcy usług tożsamości. Zanim przypiszesz daną rolę do użytkownika, sprawdź, czy istnieje ona w Twojej organizacji. Istniejący użytkownicy SCIM nie aktualizowani, jeśli danej roli nie utworzono dla Twojej organizacji.

Przypisywanie ról w obsługiwanych dostawcach usług tożsamości

Obsługa przypisywania ról została dodana w aplikacji Entra, OneLogin i Okta.Tworzenie i przypisywanie nazw ról różni się w zależności od dostawcy tożsamości.

Uwaga

Zanim przypiszesz daną rolę do użytkownika, sprawdź, czy istnieje ona w Twojej organizacji Shopify.

Okta

Przypisz role w Okta

1. Otwórz aplikację Shopify Plus w Okta.
2. Kliknij kartę Przypisania.
3. Kliknij opcję Przypisz, aby dodać użytkownika lub edytować atrybuty istniejącego użytkownika.
4. W otwartym oknie modalnym dodaj lub zaktualizuj nazwę roli Shopify w polu Nazwa roli (opcjonalnie).
5. Kliknij opcję Zapisz.

Uwaga

Jeśli pole Nazwa roli (opcjonalnie) nie jest wyświetlane w aplikacji Okta, musisz ponownie skonfigurować integracje API. Powtórz trzeci etap konfiguracji SCIM dla aplikacji Okta.

OneLogin

Przypisz role w OneLogin

1. Otwórz aplikację Shopify Plus w OneLogin.
2. Na pasku nawigacji kliknij opcję Użytkownicy.
3. Kliknij opcję Nowy użytkownik, aby dodać użytkownika, lub kliknij użytkownika, aby edytować lub dodać nazwę roli.
4. W obszarze Informacje o użytkowniku na bocznym pasku nawigacji znajdź sekcję Pola niestandardowe.
5. Dodaj nazwę roli w polu Nazwa roli (opcjonalnie).
6. Kliknij opcję Zapisz użytkownika.

Entra

Przypisz role w Entra

1. Zaloguj się do portalu Entra.
2. Utwórz rolę dla aplikacji Shopify Plus zgodnie z tym przewodnikiem dostarczonym przez firmę Microsoft. Nazwa roli musi być taka sama jak nazwa w organizacji Shopify.
3. Przypisz rolę do użytkowników w aplikacji Shopify Plus zgodnie z tym przewodnikiem dostarczonym przez firmę Microsoft.
4. Aby przetestować, czy funkcjonalność przypisywania ról działa, aprowizuj użytkownika na żądanie.

Uwaga

Jeśli zmodyfikowałeś(-aś) domyślne mapowanie w aplikacji Entra, musisz przywrócić mapowania przed przygotowaniem ról Shopify. Aby uzyskać więcej informacji na temat mapowania, zapoznaj się z dokumentacją firmy Microsoft.

Przypisywanie ról w przypadku nieobsługiwanych dostawców usług tożsamości

Jeśli Twój dostawca usług tożsamości nie ma aplikacji Shopify Plus, musisz ręcznie edytować konfigurację SCIM. Zanim zaczniesz, sprawdź, czy Twój dostawca usług tożsamości może dodawać role jako pole SCIM.

Aby przypisać lub zaktualizować rolę użytkownika SCIM, treść JSON w żądaniach POST, PUT i PATCH musi zawierać następujące elementy:

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

Treść JSON SCIM musi zawierać klucz o nazwie roles. Klucz roles musi być tablicą zawierającą skrót, który przechowuje nazwę roli. Jeśli podano wiele skrótów nazw ról, do przypisania roli używany jest tylko skrót nazwy ostatniej roli. Jeśli nazwa roli jest nieprawidłowa lub treść JSON SCIM nie pasuje do powyższego szablonu, role nie są przypisywane ani aktualizowane.

Anulowanie przypisania ról

Aby anulować przypisanie roli użytkownika, użyj ustawień organizacji. Dowiedz się więcej o anulowaniu przypisania ról użytkowników w Shopify.

Usuń integrację SCIM

Jeśli nie potrzebujesz już integracji SCIM, możesz ją usunąć. Tej czynności nie można cofnąć. Jeśli musisz ponownie aktywować integrację, musisz wygenerować nowy token API.

Kroki:

1. W panelu administracyjnym Shopify przejdź do opcji Ustawienia > Użytkownicy i uprawnienia.

2. Kliknij Zabezpieczenia.

3. W sekcji Integracja SCIM kliknij ... obok tokena API.

4. Kliknij Usuń token.

Ograniczenia

Właściciele sklepów i organizacji nie mogą zostać usunięci za pośrednictwem dostawcy usług tożsamości. Aby użytkownik mógł zostać usunięty, konieczne jest przeniesienie obu rodzajów własności. Jeśli musisz zmienić właściciela sklepu, możesz to zrobić z poziomu panelu administracyjnego Shopify. Jeśli musisz zmienić właściciela organizacji, skontaktuj się z Pomocą techniczną Shopify Plus.