Konfigurowanie aplikacji Yellowbox 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 aplikacji Yellowbox, jak i Microsoft Entra ID w celu skonfigurowania automatycznej aprowizacji użytkowników. Po skonfigurowaniu Microsoft Entra ID automatycznie aprowizuje użytkowników i grupy do Yellowbox, korzystając z 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 możliwości

  • Tworzenie użytkowników w aplikacji Yellowbox
  • Usuń użytkowników w aplikacji Yellowbox, gdy nie będą już wymagać dostępu
  • Zachowaj synchronizację atrybutów użytkownika między Microsoft Entra ID i Yellowbox

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 .
  • Yellowbox wystawił token internetowy JSON na potrzeby autoryzacji względem punktu końcowego aprowizacji SCIM

Krok 1: Zaplanuj wdrożenie zaopatrzenia

  1. Dowiedz się, jak działa usługa wdrażania.
  2. Określ, kto jest objęty zakresem udostępniania.
  3. Określ, które dane mapować między Microsoft Entra ID a Yellowbox.

Krok 2. Konfigurowanie aplikacji Yellowbox w celu obsługi aprowizacji przy użyciu Microsoft Entra ID

  • Użyj https://australia-southeast1-yellowbox-f4c6e.cloudfunctions.net/scim jako adresu URL dzierżawy.
  • Uzyskaj token autoryzacji JWT z aplikacji yellowbox, kontaktując się z pomocą techniczną aplikacji Yellowbox, jeśli token jeszcze nie został wystawiony.

Dodaj Yellowbox z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie udostępnianiem zasobów do Yellowbox. Jeśli wcześniej skonfigurowano aplikację Yellowbox dla logowania jednokrotnego, możesz użyć tej samej aplikacji. Zalecamy jednak utworzenie oddzielnej aplikacji podczas początkowego testowania integracji. Więcej informacji o dodawaniu aplikacji z galerii znajdziesz 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ć, 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 aprowizacji użytkowników do Yellowbox

W tej sekcji przedstawiono procedurę konfigurowania usługi aprowizacji Microsoft Entra w celu tworzenia, aktualizowania i wyłączania użytkowników i/lub grup w aplikacji Yellowbox na podstawie przypisań użytkowników i/lub grup w Microsoft Entra ID.

Konfigurowanie automatycznej aprowizacji użytkowników dla aplikacji Yellowbox 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

    Zrzut ekranu przedstawiający blok Aplikacje dla przedsiębiorstw.

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

    Zrzut ekranu przedstawiający link Yellowbox na liście aplikacji.

  4. Wybierz zakładkę Provisioning.

    Zrzut ekranu zakładki Konfigurowanie.

  5. Wybierz + Nową konfigurację.

    Zrzut ekranu przedstawiający nową konfigurację.

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

    Zrzut ekranu przedstawiający połączenie testowe aprowizacji.

  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.

    Zrzut ekranu przedstawiający właściwości prowizjonowania.

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

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

    Atrybut Typ Obsługa filtrowania Wymagane przez Yellowbox
    userName Sznurek
    roles[główna równa się "True"].value Sznurek
    aktywny logiczny
    nazwa wyświetlana Sznurek
    Identyfikator zewnętrzny Sznurek
  12. Aby skonfigurować filtry określania zakresu, zapoznaj się z instrukcjami podanymi w artykule Określanie filtrów zakresu.

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

  14. 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