Konfigurowanie i obsługa konektora Enterprise
Źródło danych, TLS, status, logi i diagnostyka w aplikacji Enterprise Connector na Twojej własnej maszynie.
Gdy konektor jest już zarejestrowany, jego konfiguracja znajduje się w aplikacji konektora na maszynie w Twojej sieci, a nie w konsoli. Ta strona opisuje tę aplikację.
Okno aplikacji
W lewym górnym rogu przełącznik konektorów wybiera, który z zainstalowanych konektorów właśnie oglądasz. Każda strona poniżej przełącznika dotyczy wybranego konektora, sprawdź go więc najpierw, gdy strona pokazuje nieoczekiwane wartości.
Dostępne strony zależą od typu wybranego konektora:
| Obszar | Strony | Dostępne dla |
|---|---|---|
| Home | Agents, Status | Każdego konektora |
| Configure | Data source, Identity | Konektorów uwierzytelniania |
| Configure | Provisioning target, Identity | Konektorów aprowizacji |
| Insight | Logs, Diagnostics | Diagnostics dla konektorów uwierzytelniania, Logs dla każdego konektora |
| Explore | Users, Groups, Directory structure | Konektorów uwierzytelniania |
| Update | Release notes, Update | Każdego konektora |
Data source (konektory uwierzytelniania)
Configure → Data source zawiera połączenie z Active Directory albo LDAP. Zmiany działają bez ponownego uruchamiania usługi.
Połączenie
| Pole | Znaczenie |
|---|---|
| Protocol | ldaps:// (szyfrowane, zalecane) albo ldap://. Wybór wariantu nieszyfrowanego pokazuje ostrzeżenie, ponieważ poświadczenia bind i dane katalogowe biegną wtedy jawnym tekstem. |
| Host, Port | Adres kontrolera domeny albo serwera LDAP, zwykle port 636 dla LDAPS i 389 dla LDAP. |
| Bind DN, Bind password | Konto usługi, którym uwierzytelnia się konektor. Dostęp do odczytu wystarcza, dopóki nie są włączone Synchronizacja upstream ani Password writeback. |
| Base DN | Korzeń poddrzewa, w którym pracuje konektor. |
| Custom CA certificates (PEM) | Certyfikaty urzędów, którym połączenie LDAPS ma ufać dodatkowo względem magazynu zaufania systemu. Niezależne od certyfikatów skonfigurowanych dla połączenia z platformą. |
| Ignore invalid certificates | Wyłącza weryfikację certyfikatów dla połączenia LDAPS. Stosuj to wyłącznie jako rozwiązanie tymczasowe. |
Users i Groups przyjmują każde po jednej additional base DN dołączanej do base DN oraz filtr. Razem decydują, które obiekty konektor przekazuje platformie. Wąskie filtry utrzymują szybką synchronizację i zapobiegają temu, by konta usługowe albo systemowe trafiały do platformy jako użytkownicy.
Test settings uruchamia test połączenia na wartościach aktualnie wpisanych w formularzu i raportuje wynik wraz z liczbą obiektów. Korzystaj z niego po każdej zmianie, przed zapisaniem.
Operacje katalogowe używają domyślnie limitu czasu wynoszącego dziesięć sekund, co pokrywa obciążony kontroler domeny na wolnym łączu. Logowanie użytkownika, które go przekroczy, jest raportowane jako nieudane logowanie, dlatego powtarzające się przekroczenia limitu badaj po stronie katalogu, zamiast podnosić tolerancję.
Provisioning target (konektory aprowizacji)
Configure → Provisioning target steruje tym, co konektor aprowizacji może osiągnąć:
- Allowed target origins to lista systemów, do których ten konektor może przekazywać żądania aprowizacji, po jednym wpisie w wierszu. Wpis może wskazywać origin, na przykład
https://scim.example, albo origin z prefiksem ścieżki, aby zawęzić go jeszcze bardziej. Pusta lista odrzuca wszystko, i taki jest zamierzony stan, dopóki świadomie nie dopuścisz celu. - Custom CA certificates i Ignore invalid certificates działają jak ich odpowiedniki na stronie źródła danych, w odniesieniu do połączenia z celem.
Lista dopuszczonych celów jest granicą ograniczającą: wyznacza, które systemy w Twojej sieci są przez ten konektor w ogóle osiągalne. Utrzymuj ją tak wąską, jak pozwala na to integracja.
Identity (połączenie z platformą)
Configure → Identity obejmuje sposób, w jaki konektor komunikuje się z platformą:
- Custom CA certificates (PEM) to certyfikaty urzędów, którym ma ufać połączenie z platformą. Są potrzebne, gdy Twoja sieć przechwytuje ruch TLS albo certyfikat platformy pochodzi z prywatnego urzędu certyfikacji. To ustawienie jest stosowane przez usługę konektora przy starcie, więc po zmianie trzeba ponownie uruchomić usługę.
- Ignore invalid certificates wyłącza weryfikację tego połączenia. Stosuj to wyłącznie jako rozwiązanie tymczasowe.
- Export keypair pakuje parę kluczy konektora w blok zaszyfrowany hasłem zabezpieczającym. Potrzebujesz go, aby zarejestrować kolejny konektor dla tego samego katalogu albo przenieść ten konektor na inną maszynę. Hasło zabezpieczające chroni klucz prywatny i nie da się go odzyskać, przechowuj więc obie części bezpiecznie i usuń wyeksportowany blok, gdy zostanie użyty.
Status
Home → Status pokazuje trzy wskaźniki dla wybranego konektora: lokalną usługę Service, połączenie z Identity oraz połączenie ze Data source lub Provisioning target. Poniżej na żywo pojawia się ostatnia aktywność: przebiegi synchronizacji z liczbą użytkowników, udane i nieudane logowania, zmiany haseł oraz ruch aprowizacji z liczbą błędów.
To najszybszy sposób, aby odróżnić problem konektora od problemu platformy. Konektor, którego usługa jest dostępna, a połączenie z platformą działa, ale którego źródło danych jest rozłączone, wskazuje na usługę katalogową albo poświadczenia na stronie źródła danych.
Przeglądanie katalogu
Explore → Users, Groups i Directory structure pokazują prosto ze źródła, co konektor faktycznie widzi przy bieżących base DN i filtrach. Używaj ich, aby zweryfikować filtr przed włączeniem synchronizacji oraz sprawdzić, czy użytkownika brakującego w platformie brakuje już w źródle, czy też wyklucza go filtr.
Logi
Insight → Logs wymienia pliki logów wybranego konektora i udostępnia widok Live, który śledzi bieżący plik. Pliki logów są rotowane i ograniczone rozmiarem, nie mogą więc rosnąć bez końca.
Logi pozostają na maszynie. Nic z nich nie trafia do platformy, dopóki nie wyślesz pakietu diagnostycznego.
Diagnostyka
Insight → Diagnostics buduje pakiet wsparcia z wybranych przez Ciebie kategorii:
| Kategoria | Zawartość |
|---|---|
| Logs | Pliki logów konektora. Dołączane domyślnie. |
| Settings | Konfiguracja źródła danych: host, bind DN, base DN i filtry. Bind password zostaje pominięte. |
| Connection test | Wynik świeżego testu połączenia. |
| Users, Groups, Directory structure | Dane katalogowe tak, jak odczytuje je konektor. Niedołączane domyślnie, ponieważ zawierają dane osobowe. |
Download zapisuje pakiet lokalnie, dzięki czemu możesz go sprawdzić przed przekazaniem. Upload to support przesyła go bezpośrednio. Przejrzyj wybrane kategorie przed wysłaniem: kategorie katalogowe niosą dane osobowe Twoich użytkowników.
Uwagi eksploatacyjne
- Konektory działają jako usługi Windows i pracują dalej po zamknięciu okna aplikacji.
- Zatrzymanie konektora uwierzytelniania zatrzymuje logowania jego katalogu, chyba że inny konektor tego katalogu jest online.
- Źródło danych, cel aprowizacji i filtry katalogu działają natychmiast. Certyfikaty dla połączenia z platformą działają po ponownym uruchomieniu usługi.
- Strona Update → Release notes wymienia zmiany w każdej wersji.
Rozwiązywanie problemów
- Identity jest połączone, ale konektor nie jest użyteczny. Konektor osiągnął platformę, ale nie został zaakceptowany. Zwykle następuje to po usunięciu albo ponownym utworzeniu rekordu konektora w konsoli. Zarejestruj konektor ponownie nowym adresem URL aprowizacji.
- Źródło danych pokazuje stan rozłączony. Przetestuj połączenie na stronie źródła danych. Częste przyczyny to wygasłe hasło konta bind, reguła zapory między maszyną a kontrolerem domeny oraz certyfikat LDAPS, któremu maszyna nie ufa.
- Logowania się nie udają, choć synchronizacja działa. Konto bind może czytać, ale użytkownicy nie mogą się związać albo wyklucza ich filtr użytkowników. Sprawdź filtr użytkowników na stronie źródła danych i zweryfikuj konto w Explore → Users.
- Po synchronizacji brakuje użytkowników. Sprawdź najpierw additional base DN i filtr użytkowników, a potem potwierdź w Explore → Users, że konektor w ogóle widzi te konta.
- Zmiana hasła zostaje odrzucona. W katalogu z ochroną haseł end-to-end politykę haseł wymusza konektor. Zaktualizuj konektor, gdy komunikat nie odpowiada polityce skonfigurowanej w konsoli.
Zobacz też
- Instalowanie konektora Enterprise: wymagania, instalacja, aktualizacje i usuwanie.
- Enterprise Connectors: część konsolowa.
- Katalogi użytkowników: synchronizacja, Password writeback i same ustawienia katalogu.