Konfigurowanie platformy YardiOne 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 YardiOne, jak i Microsoft Entra ID w celu skonfigurowania automatycznej aprowizacji użytkowników. Po skonfigurowaniu Microsoft Entra ID automatycznie aprowizuje i cofa aprowizację użytkowników do YardiOne za pomocą 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 usłudze YardiOne.
  • Usuń użytkowników w YardiOne, gdy nie będą już wymagać dostępu.
  • Zachowaj synchronizację atrybutów użytkownika między Microsoft Entra ID i YardiOne.
  • jednokrotne logowanie do YardiOne (zalecane).

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 YardiOne z uprawnieniami administratora.

Krok 1: Zaplanuj wdrożenie zaopatrzenia

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

Skontaktuj się z pomocą techniczną YardiOne, aby skonfigurować usługę YardiOne do obsługi aprowizacji przy użyciu Microsoft Entra ID.

Dodaj aplikację YardiOne z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem w usłudze YardiOne. Jeśli wcześniej skonfigurowano aplikację YardiOne dla logowania jednokrotnego, możesz użyć tej samej aplikacji. Zaleca się 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ę ustalić, kto ma mieć dostęp do Twojej aplikacji na podstawie przypisania, możesz skorzystać z kroków , aby przypisać użytkowników i grupy do aplikacji. Jeśli zdecydujesz się określić zakres przyznawania zasobów wyłącznie na podstawie atrybutów użytkownika lub grupy, możesz użyć filtru 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. Jeśli zakres aprowizacji jest ustawiony na przypisanych użytkowników i grupy, możesz to kontrolować, przypisując jednego lub dwóch użytkowników lub grup do aplikacji. W przypadku ustawienia zakresu na wszystkich użytkowników i wszystkie grupy, możesz określić filtrowanie zakresu na podstawie atrybutów.

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

Krok 5: Konfigurowanie automatycznego przydzielania użytkowników w usłudze YardiOne

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

Konfiguracja automatycznego aprowizowania użytkowników dla platformy YardiOne 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ę YardiOne.

    zrzut ekranu przedstawiający link YardiOne na liście aplikacji.

  4. Wybierz kartę Zapewnianie zasobów.

    Zrzut ekranu zakładki Konfiguracja.

  5. Wybierz + Nową konfigurację.

    Zrzut ekranu przedstawiający nową konfigurację.

  6. W polu Adres URL najemcy wprowadź adres URL najemcy YardiOne i sekretny token. Wybierz pozycję Test Connection aby upewnić się, że Microsoft Entra ID może nawiązać połączenie z usługą YardiOne. Jeśli połączenie nie powiedzie się, upewnij się, że konto YardiOne 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 synchronizowane z Microsoft Entra ID do YardiOne w sekcji Attribute-Mapping. Atrybuty wybrane jako właściwości Matching są używane do dopasowania kont użytkowników w YardiOne na potrzeby operacji aktualizacji. Jeśli zdecydujesz się na zmianę pasującego atrybutu docelowego , musisz zapewnić, że interfejs API YardiOne obsługuje filtrowanie użytkowników na podstawie tego atrybutu. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.

    Atrybut Typ Obsługa filtrowania Wymagane przez YardiOne
    userName (nazwa użytkownika) Sznurek ✓ ✓
    aktywny logiczny
    nazwa.imię Sznurek
    imię.nazwisko Sznurek
  12. Wybierz pozycję Grupy.

  13. Przejrzyj atrybuty grupy, które są synchronizowane z Microsoft Entra ID do YardiOne w sekcji Attribute-Mapping. Atrybuty wybrane jako dopasowujące się do właściwości są używane do łączenia grup w YardiOne w celu przeprowadzania operacji aktualizacji. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.

    Atrybut Typ Obsługa filtrowania Wymagane przez YardiOne
    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 w artykule dotyczącym udostępniania aplikacji i statusu kwarantanny.

Więcej zasobów