Konfigurowanie integracji użytkowników Secure Cloud na potrzeby automatycznej aprowizacji użytkowników przy użyciu Microsoft Entra ID

Z tego samouczka dowiesz się, jak skonfigurować automatyczną aprowizację użytkowników między Microsoft Entra ID i Secure Cloud. Po skonfigurowaniu Microsoft Entra ID automatycznie tworzy, aktualizuje i usuwa aprowizację użytkowników i grup w Secure Cloud przy użyciu protokołu SCIM 2.0. Zmniejsza to nakład pracy administracyjnej i pomaga zapewnić synchronizację dostępu użytkowników między Microsoft Entra ID i Secure Cloud.

Aby uzyskać ważne szczegółowe informacje na temat działania usługi, sposobu jej działania i często zadawanych pytań, zobacz Automatyzowanie aprowizacji użytkowników i cofania aprowizacji użytkowników w aplikacjach SaaS przy użyciu Microsoft Entra ID.

Obsługiwane funkcje

Prerequisites

Zanim zaczniesz, upewnij się, że masz następujące wymagania wstępne:

• Logowanie jednokrotne (SSO) zostało już skonfigurowane zgodnie z instrukcjami w Krok 3: Dodaj integrację Secure Cloud User do dzierżawy Microsoft Entra.
• Dzierżawa firmy Microsoft Entra.
• Aplikacja przedsiębiorstwa Secure Cloud User Integration jest dostępna w dzierżawie Microsoft Entra.
• Konto Microsoft Entra z jedną z następujących ról:
  • Administrator aplikacji.
  • Administrator aplikacji w chmurze.
  • Właściciel aplikacji.
• Subskrypcja integracji użytkowników z bezpieczną chmurą, która obsługuje automatyczne aprowizowanie.
• Dostęp administratora do Secure Cloud z uprawnieniami do konfigurowania aprowizacji.
• Dostęp do strony konfiguracji aprowizacji bezpiecznej chmury w celu uzyskania poświadczeń aprowizacji SCIM.
• Konto użytkownika integracji Secure Cloud, którego adres e-mail jest zgodny z kontem Microsoft Entra administratora, który udziela zgody w kroku 3.

Krok 1: Zaplanuj wdrożenie provisioningu

1. Dowiedz się, jak działa usługa wdrażania.
2. Określ, kto znajduje się w zakresie zaopatrywania.
3. Ustal, jakie dane zmapować między Microsoft Entra ID a Secure Cloud User Integration.

Krok 2. Konfigurowanie integracji Secure Cloud User w celu obsługi prowizjonowania przy użyciu Microsoft Entra ID

1. Zaloguj się do Secure Cloud User Integration admin portal jako administrator.

2. Przejdź do Administracja usługą>Zarządzanie kontem>Integracja użytkowników>Plany importu.

   

3. Wybierz pozycję Nowy plan Microsoft Entra.

   

4. W obszarze Ustawienia aprowizacji włącz Włącz aprowizację Microsoft Entra.

   

5. W obszarze Usługi wybierz usługi, które mają zostać przypisane udostępnionym użytkownikom. Te usługi są przypisywane tylko nowo aprowizowanym użytkownikom. To ustawienie nie zmienia istniejących użytkowników integracji Secure Cloud User Integration.

   

6. Opcjonalnie w obszarze Powiadomienia wybierz pozycję Wyślij powitalną wiadomość e-mail.

   

7. Wybierz Zapisz. Zostanie otwarta strona Szczegóły planu — Microsoft Entra Plan inicjowania obsługi administracyjnej.

   

8. W sekcji Microsoft Entra Admin Center skopiuj następujące wartości. Wprowadź je w Microsoft Entra ID w kroku 5.

   Wartość Secure Cloud User Integration	pole Microsoft Entra
   Adres URL dzierżawy, na przykład https://api.appriver.com/scim/api	Adres URL dzierżawcy
   Punkt końcowy tokenu, na przykład https://account.appriver.com/identity/connect/token	endpoint tokenu OAuth
   identyfikator klienta	Identyfikator klienta
   Klucz tajny klienta (Client Secret) (wybierz pozycję Pokaż, aby go ujawnić)	Klucz tajny klienta

   

Krok 3. Dodaj integrację Secure Cloud User do dzierżawy Microsoft Entra

Aplikacja korporacyjna Secure Cloud User Integration wykorzystuje wdrażanie oparte na zgodzie. Aplikacja jest tworzona w dzierżawie Microsoft Entra, gdy administrator najpierw loguje się do Secure Cloud User Integration z Microsoft Entra ID i udziela zgody. Wykonaj ten krok, aby włączyć logowanie jednokrotne i utworzyć aplikację skonfigurowaną do aprowizacji w kroku 5.

Włącz uwierzytelnianie Microsoft Entra

1. W Secure Cloud User Integration admin portal przejdź do Service Administration>>>.

   

2. Na liście Typ uwierzytelniania wybierz Microsoft Entra SSO.

   

3. W obszarze Konfiguracja włącz opcję Włącz uwierzytelnianie Microsoft Entra.

   

4. Opcjonalnie włącz opcję Zapasowe hasło użytkownika podczas początkowej konfiguracji. Ta opcja zapewnia alternatywną metodę logowania, jeśli uwierzytelnianie Microsoft Entra jest niedostępne.

   • Jeśli hasło awaryjnego użytkownika jest włączone, użytkownicy mogą wybrać pozycję Zaloguj się za pomocą konta Microsoft lub zalogować się przy użyciu poświadczeń Secure Cloud User Integration albo poświadczeń LDAP, jeśli skonfigurowano uwierzytelnianie LDAP.
   • Jeśli Fallback User Password jest wyłączone, użytkownicy są przekierowywani do Microsoft Entra ID po wprowadzeniu nazwy użytkownika, a nie można użyć poświadczeń Secure Cloud User Integration lub LDAP.

   

5. Wybierz Zapisz.

Zaloguj się i wyraź zgodę

1. Wyloguj się z Secure Cloud User Integration, lub użyj innej przeglądarki i przejdź do strony logowania do Secure Cloud User Integration.

   

2. Wprowadź nazwę użytkownika konta integracji użytkownika Secure Cloud, którego adres e-mail jest zgodny z kontem Microsoft Entra, które może wyrazić zgodę na aplikacje w dzierżawcy, a następnie wybierz pozycję Kontynuuj.

   

3. Jeśli hasło użytkownika zapasowego jest włączone, wybierz pozycję Zaloguj się przy użyciu konta Microsoft w obszarze Użyj cyfrowej tożsamości swojej organizacji. Jeśli jest wyłączona, nastąpi automatyczne przekierowanie do Microsoft Entra ID.

   

4. Zaloguj się przy użyciu poświadczeń Microsoft Entra i ukończ wszystkie monity uwierzytelniania wieloskładnikowego.

5. Na stronie Żądane uprawnienia przejrzyj żądane uprawnienia.

   

6. Opcjonalnie wybierz pozycję Zgoda w imieniu organizacji, aby użytkownicy nie byli proszeni o wyrażenie zgody podczas pierwszego logowania. Aby uzyskać więcej informacji, zobacz Omówienie zgody użytkownika i administratora.

   

7. Wybierz pozycję Akceptuj. Microsoft Entra ID tworzy aplikację dla przedsiębiorstw Secure Cloud User Integration w Twojej dzierżawie i przekierowuje Cię z powrotem do Secure Cloud User Integration, gdzie następuje logowanie.

8. Aby potwierdzić, zaloguj się do centrum administracyjne Microsoft Entra, przejdź do Entra ID>Aplikacje dla przedsiębiorstw i wyszukaj pozycję Secure Cloud User Integration.

   

Krok 4: Zdefiniuj, kto jest objęty zakresem udostępniania

Usługa aprowizacji Microsoft Entra umożliwia definiowanie, kto ma być aprowizowany na podstawie przypisania do aplikacji lub na podstawie atrybutów użytkownika lub grupy. Jeśli zdecydujesz się określić, komu aplikacja będzie udostępniana na podstawie przypisania, możesz skorzystać z kroków do przypisania użytkowników i grup do aplikacji. Jeśli zdecydujesz się określić, kto jest objęty zakresem wyłącznie na podstawie atrybutów użytkownika lub grupy, możesz użyć filtru określania zakresu.

• Zacznij od małego Przeprowadź test z użyciem mniejszego zestawu użytkowników i grup, zanim wdrożysz to rozwiązanie dla wszystkich. Gdy zakres przydzielania jest ustawiony na przypisanych użytkowników i grupy, możesz kontrolować to, przypisując jednego lub dwóch użytkowników albo jedną lub dwie grupy do aplikacji. Gdy zakres jest ustawiony na wszystkich użytkowników i grupy, można określić filtr określania zakresu na podstawie atrybutów.

• Jeśli potrzebujesz dodatkowych ról, możesz zaktualizować manifest aplikacji , aby dodać nowe role.

Krok 5. Konfigurowanie automatycznej obsługi administracyjnej użytkowników do Secure Cloud User Integration

Ta sekcja przeprowadzi Cię przez proces łączenia Microsoft Entra ID z interfejsem API aprowizacji Secure Cloud User Integration. Usługa provisioningu Microsoft Entra używa tego połączenia do tworzenia, aktualizowania i wycofywania przypisanych użytkowników i grup z obsługi w ramach integracji użytkowników z bezpieczną chmurą.

Konfigurowanie automatycznej aprowizacji użytkowników na potrzeby Secure Cloud User Integration w Microsoft Entra ID

1. Zaloguj się do centrum administracyjnego Microsoft Entra z uprawnieniami co najmniej Administratora aplikacji w chmurze.

2. Przejdź do aplikacji Entra ID>Dla przedsiębiorstw.

   

3. Na liście aplikacji wybierz pozycję Secure Cloud User Integration.

4. Wybierz Konfiguracja.

   

5. Wybierz pozycję Nowa konfiguracja.

   

6. Wprowadź wartości skopiowane w kroku 2:

   pole Microsoft Entra	Value
   Adres URL dzierżawcy	Integracja użytkowników Secure Cloud adres URL dzierżawy
   Punkt końcowy OAuth	Punkt końcowy tokenu integracji użytkowników z bezpieczną chmurą
   Identyfikator klienta	Identyfikator klienta integracji użytkowników Secure Cloud
   Klucz tajny klienta	Bezpieczna integracja użytkowników chmury Klucz tajny klienta

7. Wybierz pozycję Testuj połączenie, aby upewnić się, że Microsoft Entra ID może nawiązać połączenie z integracją użytkowników w chmurze. Jeśli połączenie nie powiedzie się, upewnij się, że wartości są zgodne z wartościami wyświetlanymi w planie aprowizacji Secure Cloud User Integration i że Włącz aprowizację Microsoft Entra jest włączona.

8. Wybierz Utwórz.

9. Na stronie Aprowizacja> wybierz pozycję Właściwości, a następnie edytuj Ustawienia.

10. W obszarze Wiadomość e-mail z powiadomieniem wprowadź adres e-mail, aby otrzymywać powiadomienia o błędach aprowizacji i włączać powiadomienia e-mail w przypadku wystąpienia błędu.

11. Włącz opcję Zapobiegaj przypadkowemu usunięciu i ustaw odpowiedni próg.

12. Wybierz opcję Zastosuj.

    

13. Wybierz pozycję Mapowanie atrybutów, a następnie wybierz użytkowników.

14. Przejrzyj atrybuty użytkownika, które są synchronizowane z Microsoft Entra ID do Secure Cloud User Integration. Domyślny atrybut dopasowania użytkownika to userName, pochodzący z userPrincipalName. Atrybuty wybrane jako właściwości dopasowujące są używane do dopasowywania kont użytkowników w Secure Cloud User Integration na potrzeby operacji aktualizacji. Jeśli zmienisz odpowiadający atrybut docelowy, upewnij się, że interfejs API Secure Cloud User Integration obsługuje filtrowanie użytkowników według tego atrybutu. Wybierz pozycję Zapisz , aby zatwierdzić wszelkie zmiany.

    Attribute	Typ	Obsługiwane w przypadku dopasowywania/filtrowania	Wymagane przez Secure Cloud User Integration	Notes
    userName	String	Yes	Yes	Mapowane z userPrincipalName.
    active	logiczny			Mapowane z Switch([IsSoftDeleted], , "False", "True", "True", "False").
    displayName	String			Zmapowano z displayName.
    title	String			Mapowane z jobTitle.
    emails[type eq "work"].value	String			Mapowane na podstawie mail.
    name.givenName	String			Mapowane z givenName.
    name.familyName	String			Mapowane z elementu surname.
    externalId	String			Mapowane z mailNickname.
    phoneNumbers[type eq "work"].value	String			Zmapowano z telephoneNumber.
    phoneNumbers[type eq "mobile"].value	String			Odwzorowano z mobile.
    phoneNumbers[type eq "fax"].value	String			Mapowane z facsimileTelephoneNumber.
    addresses[type eq "work"].streetAddress	String			Mapowane z streetAddress.
    addresses[type eq "work"].locality	String			Mapowano z city.
    addresses[type eq "work"].region	String			Odwzorowano z state.
    addresses[type eq "work"].postalCode	String			Zmapowano z postalCode.
    addresses[type eq "work"].country	String			Zmapowano z country.
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	String			Mapowano z department.
    urn:ietf:params:scim:schemas:extension:opentext:2.0:Mailbox:proxyAddresses	String			Zmapowano z Join(",", [proxyAddresses]).

15. Wybierz pozycję Mapowanie atrybutów, a następnie wybierz grupy.

16. Przejrzyj atrybuty grupy, które są synchronizowane z Microsoft Entra ID do Secure Cloud User Integration. Domyślnym atrybutem dopasowania grupy jest displayName. Atrybuty wybrane jako właściwości dopasowywania są używane do dopasowywania grup w ramach Secure Cloud User Integration na potrzeby operacji aktualizacji. Wybierz pozycję Zapisz , aby zatwierdzić wszelkie zmiany.

    Attribute	Typ	Obsługiwane przy dopasowywaniu/filtrowaniu	Wymagane przez integrację użytkownika Secure Cloud	Notes
    displayName	String	Yes	Yes	Zmapowano z displayName.
    members	Reference			Zmapowano z members.
    externalId	String			Zmapowano z objectId.
    urn:ietf:params:scim:schemas:extension:opentext:2.0:Mailbox:proxyAddresses	String			Mapowane z Join(",", [proxyAddresses]).

17. Ustaw Zakres na Synchronizowanie tylko przypisanych użytkowników i grup (zalecane). Jeśli używasz opcji Synchronizuj wszystkich użytkowników i grup, użyj filtrów określania zakresu, aby ograniczyć aprowizowane obiekty. Aby skonfigurować filtry określania zakresu, postępuj zgodnie z instrukcjami w temacie Aprowizowanie aplikacji opartej na atrybutach z filtrami określania zakresu.

18. Użyj aprowizowania na żądanie, aby zweryfikować początkową synchronizację z niewielką liczbą użytkowników testowych przed szerszym wdrożeniem. Uwzględnij jednorazowe konto testowe na potrzeby testu deprowizjonowania.

19. Zachowaj zakres aprowizacji ograniczony do użytkowników i grup testowych, a następnie wybierz pozycję Rozpocznij aprowizację na stronie Przegląd .

20. Zaktualizuj atrybuty użytkownika testowego w Microsoft Entra ID i sprawdź, czy zmiany są synchronizowane z Secure Cloud User Integration.

21. Usuń przypisanie aplikacji tymczasowego użytkownika testowego i zezwól na odpowiedni cykl aprowizacji w celu przetworzenia usunięcia przypisania. Sprawdź, czy użytkownik jest wycofany z aprowizacji zgodnie ze skonfigurowanym zachowaniem aprowizacji. Początkowa operacja aprowizacji na żądanie nie weryfikuje deaprowizacji.

22. Przed rozwinięciem zakresu obsługi zasobów dla szerszego wdrożenia wykonaj te testy weryfikacyjne.

Krok 6. Monitorowanie wdrożenia

Po skonfigurowaniu aprowizacji użyj następujących zasobów, aby monitorować wdrożenie:

1. Użyj dzienników przydzielania , aby określić, którzy użytkownicy zostali pomyślnie przydzieleni lub dla których proces przydzielania się nie powiódł.
2. Sprawdź pasek postępu , aby zobaczyć stan cyklu wdrażania i sprawdzić, jak blisko jest do zakończenia.
3. Jeśli konfiguracja aprowizacji wydaje się być w złej kondycji, aplikacja przechodzi do kwarantanny. Dowiedz się więcej o stanach kwarantanny z artykułu dotyczącego statusu kwarantanny podczas aprowizacji aplikacji.

Aby potwierdzić wyniki w sekcji Bezpieczna integracja użytkowników chmury, przejdź do Administracja usługąUżytkownicy>>, aby sprawdzić aprowizowanych użytkowników, oraz do Administracja usługąUżytkownicy>>, aby sprawdzić aprowizowane grupy i członkostwa.

Przed szerszym wdrożeniem sprawdź również oczekiwane atrybuty i członkostwa w grupach użytkowników testowych.

Troubleshooting

Secure Cloud User Integration nie jest wyświetlana w aplikacjach dla przedsiębiorstw

• Przyczyna: Aplikacja dla przedsiębiorstw jest tworzona dopiero po tym, jak administrator zaloguje się przy użyciu Microsoft Entra ID i udzieli zgody.
• Rozwiązanie:
  1. Powtórz logowanie w kroku 3.
  2. Upewnij się, że wybrano pozycję Akceptuj na stronie Uprawnienia wymagane i przekierowano Cię z powrotem do Secure Cloud User Integration.

Użytkownicy nie mogą udzielić zgody

• Objaw: Użytkownicy widzą komunikat, że wymagane jest zatwierdzenie przez administratora.
• Rozwiązanie: Sprawdź ustawienia zgody dzierżawcy lub poproś administratora aplikacji w chmurze o udzielenie zgody w imieniu organizacji. Aby uzyskać więcej informacji, zobacz Omówienie zgody użytkownika i administratora.

Użytkownik nie może się zalogować

• Rozwiązanie: Sprawdź, czy użytkownik istnieje w Secure Cloud User Integration, czy adres e-mail użytkownika jest zgodny z kontem Microsoft Entra i czy włączono opcję Włącz uwierzytelnianie Microsoft Entra.

Test połączenia nie powodzi się

• Rozwiązanie:
  1. Upewnij się, że adres URL dzierżawy, punkt końcowy tokenu, identyfikator klienta i klucz tajny klienta zostały skopiowane dokładnie z planu aprowizacji Secure Cloud User Integration.
  2. Upewnij się, że opcja Włącz inicjowanie obsługi Microsoft Entra jest włączona w planie.
  3. Upewnij się, że dostęp sieciowy do punktu końcowego SCIM Secure Cloud User Integration jest dostępny.

Użytkownicy lub grupy nie są obsługiwani administracyjnie

• Rozwiązanie:
  1. Upewnij się, że stan inicjowania ma wartość Włączone.
  2. Upewnij się, że użytkownicy lub grupy są przypisani bezpośrednio do aplikacji Secure Cloud User Integration i znajdują się w skonfigurowanym zakresie.
  3. Sprawdź dzienniki prowizjonowania pod kątem błędów.

Znane ograniczenia

• Microsoft Entra ID nie aprowizuje użytkowników, którzy są członkami przypisanej grupy wyłącznie poprzez grupy zagnieżdżone. Przypisz wszystkich wymaganych użytkowników lub grupy, do których ci użytkownicy należą bezpośrednio, do aplikacji.
• Usługi wybrane w planie aprowizacji Secure Cloud User Integration są przypisywane tylko do nowo aprowizowanych użytkowników. Istniejący użytkownicy nie są zmieniani.

Dodatkowe zasoby

• Zarządzanie aprowizowaniem konta użytkownika dla aplikacji dla przedsiębiorstw
• Co to jest dostęp do aplikacji i logowanie jednokrotne przy użyciu identyfikatora Microsoft Entra ID?

Treści powiązane

• Przeglądanie dzienników i uzyskiwanie raportów dotyczących działań obsługi aprowizacji