Konfigurowanie aplikacji Xledger na potrzeby automatycznej aprowizacji użytkowników przy użyciu Microsoft Entra ID

W tym artykule opisano kroki, które należy wykonać zarówno w Xledger, jak i w Microsoft Entra ID, aby skonfigurować automatyczną aprowizację użytkowników. Po skonfigurowaniu usługa Microsoft Entra ID automatycznie aprowizuje i usuwa aprowizację użytkowników oraz grup do Xledger przy użyciu usługi aprowizacji Microsoft Entra. Aby uzyskać ważne szczegółowe informacje na temat działania tej usługi oraz odpowiedzi na często zadawane pytania, sprawdź Automatyzuj aprowizację użytkowników i deaprowizację w aplikacjach SaaS za pomocą Microsoft Entra ID.

Obsługiwane funkcje

Wymagania wstępne

W scenariuszu opisanym w tym artykule przyjęto założenie, że masz już następujące wymagania wstępne:

• A Microsoft Entra tenant
• Jedną z następujących ról: administrator aplikacji , administrator aplikacji w chmurze lub właściciel aplikacji .
• Konto użytkownika w aplikacji Xledger z uprawnieniami administratora.

Krok 1: Zaplanuj wdrożenie zaopatrzenia

1. Dowiedz się, jak działa usługa aprowizacji.
2. Określ, kogo dotyczy zakres udostępniania.
3. Określ, jakie dane mają być mapowane między Microsoft Entra ID i Xledger.

Krok 2. Konfigurowanie aplikacji Xledger do obsługi aprowizacji przy użyciu Microsoft Entra ID

1. Zaloguj się do Xledger z rolą administratora domeny (lub podobnej) i przejdź do Administracja > Dostęp do systemu > Tokeny dostępu do interfejsu API.

2. Generowanie tokenu tajnego i zanotuj go

   

3. Zanotuj adres URL dzierżawy

   

Te wartości są używane na karcie Provisioning aplikacji Xledger. (Krok 5)

Krok 3. Dodawanie aplikacji Xledger z galerii aplikacji Microsoft Entra

Dodaj aplikację Xledger z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem w aplikacji Xledger. Jeśli wcześniej skonfigurowano aplikację Xledger na potrzeby logowania jednokrotnego, możesz użyć tej samej aplikacji. Zaleca się jednak utworzenie oddzielnej aplikacji podczas początkowego testowania integracji. Dowiedz się więcej o dodawaniu aplikacji z galerii tutaj.

Krok 4. Określ, kto jest objęty zakresem udostępniania

Usługa aprowizacji Microsoft Entra umożliwia określenie, kto jest aprowizowany na podstawie przypisania do aplikacji lub atrybutów użytkownika czy grupy. Jeśli zdecydujesz się określić, kto ma dostęp do Twojej aplikacji, opierając się na przypisaniu, możesz użyć kroków przypisywania użytkowników i grup do aplikacji. Jeśli zdecydujesz się określić zakres, kto jest aprowizowany 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 automatycznego provisioningu użytkowników do Xledger

Ta sekcja zawiera instrukcje konfigurowania usługi aprowizacji Microsoft Entra w celu tworzenia, aktualizowania i wyłączania użytkowników i/lub grup w aplikacji TestApp na podstawie przypisań użytkowników i/lub grup w Microsoft Entra ID.

Konfigurowanie automatycznej aprowizacji użytkowników dla aplikacji Xledger w Microsoft Entra ID

1. Zaloguj się do centrum administracyjne Microsoft Entra jako co najmniej Administrator aplikacji w chmurze.

2. Przejdź do Entra ID> Aplikacje dla przedsiębiorstw

   

3. Na liście aplikacji wybierz pozycję Xledger.

   

4. Wybierz kartę Konfiguracja.

   

5. Wybierz + Nową konfigurację.

   

6. W polu Adres URL dzierżawy wprowadź Adres URL dzierżawy Xledger i Token Sekretny. Wybierz pozycję Test Connection aby upewnić się, że Microsoft Entra ID może nawiązać połączenie z aplikacją Xledger. Jeśli połączenie nie powiedzie się, upewnij się, że twoje konto Xledger ma wymagane uprawnienia administratora i spróbuj ponownie.

   

7. Wybierz pozycję Utwórz , aby utworzyć konfigurację.

8. Wybierz Właściwości na stronie Przegląd.

9. Wybierz ikonę Edytuj , aby edytować właściwości. Włącz wiadomości e-mail z powiadomieniami i podaj wiadomość e-mail, aby otrzymywać powiadomienia o kwarantannie. Włącz zapobieganie przypadkowym usunięciom. Wybierz Zastosuj, aby zapisać zmiany.

   

10. Wybierz Mapowanie atrybutów w panelu po lewej stronie i wybierz użytkownicy.

11. Przejrzyj atrybuty użytkownika zsynchronizowane z Microsoft Entra ID do Xledger w sekcji Attribute-Mapping. Atrybuty wybrane jako pasujące właściwości są używane do dopasowania kont użytkowników w xledger na potrzeby operacji aktualizacji. Jeśli zdecydujesz się zmienić pasujący atrybut docelowy, musisz upewnić się, że interfejs API Xledger obsługuje filtrowanie użytkowników na podstawie tego atrybutu. Wybierz przycisk Zapisz , aby zatwierdzić wszelkie zmiany.

    Atrybut	Typ	Obsługa filtrowania	Wymagane przez xledger
    userName	Sznurek	✓	✓
    aktywny	logiczny
    nazwa wyświetlana	Sznurek
    emails[typ eq "praca"].wartość	Sznurek
    phoneNumbers[rodzaj eq "praca"].value	Sznurek
    urn:ietf:params:scim:schemas:extension:xledger:2.0:User:accessFromDate	Data i Czas
    urn:ietf:params:scim:schemas:extension:xledger:2.0:User:accessToDate	Data i Czas

12. Wybierz pozycję Grupy.

13. Przeanalizuj atrybuty grupy synchronizowane z Microsoft Entra ID do Xledger w sekcji Attribute-Mapping. Atrybuty wybrane jako dopasowujące właściwości są używane do dopasowywania grup w Xledger podczas operacji aktualizacji. Wybierz przycisk Zapisz , aby zatwierdzić wszelkie zmiany.

    Atrybut	Typ	Obsługa filtrowania	Wymagane przez xledger
    nazwa wyświetlana	Sznurek	✓	✓
    Członkowie	Źródło

14. Aby skonfigurować filtry określania zakresu, zapoznaj się z instrukcjami podanymi w artykule Określanie filtrów zakresu.

15. Użyj prowizjonowania na żądanie, aby zweryfikować synchronizację z niewielką liczbą użytkowników przed wdrożeniem na szerszą skalę w organizacji.

16. Gdy wszystko będzie gotowe do aprowizacji, wybierz pozycję Rozpocznij aprowizację na stronie Przegląd .

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.

Więcej zasobów

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

Treści powiązane

• Dowiedz się, jak przeglądać dzienniki i uzyskiwać raporty dotyczące czynności związanych z aprowizacją