Skip to Content

Instalowanie konektora Enterprise

Wymagania, pobieranie, instalacja, rejestracja, aktualizacje, migracja i usuwanie konektora Enterprise on-premises.

Ta strona dotyczy warstwy oprogramowania: co instalujesz we własnej sieci, jak to rejestrujesz, utrzymujesz w aktualnej wersji i ponownie usuwasz. Część konsolową (tworzenie konektora, adres URL aprowizacji, status, usuwanie) opisano na stronie Enterprise Connectors.

Co zostaje zainstalowane

Jedna instalacja w systemie Windows obsługuje aplikację agenta oraz jeden lub kilka konektorów. To odrębne elementy:

KomponentCzym jestDziała
Aplikacja agentaOkno zarządzania otwierane na maszynie. Rejestruje konektory, przechowuje ich konfigurację, pokazuje status, logi i diagnostykę.Na żądanie, uruchamiana przez Ciebie.
Lokalna usługa brokeraRejestrowana przy pierwszym uruchomieniu jako usługa Windows iec-nats. Przenosi wewnętrzną komunikację między oknem a zainstalowanymi konektorami. Powiązana wyłącznie z maszyną lokalną.Stale, jako usługa Windows.
Usługa agentaJedna usługa Windows na każdy zarejestrowany konektor, o nazwie iec-agent-<agent id>. Utrzymuje połączenie wychodzące z platformą i wykonuje właściwą pracę.Stale, jako usługa Windows.

Ponieważ każdy konektor jest osobną usługą Windows, konektory działają dalej po zamknięciu okna aplikacji i uruchamiają się ponownie po restarcie maszyny. Okno jest potrzebne wyłącznie do konfigurowania, sprawdzania i aktualizowania konektorów.

Jedna maszyna może obsługiwać kilka konektorów, także konektory różnych typów oraz konektory wskazujące na różne katalogi.

Wymagania

  • Windows na x64. Instalator i aplikacja wymagają uprawnień lokalnego administratora, a aplikacja przy każdym uruchomieniu prosi o podniesienie uprawnień, ponieważ zarządza usługami Windows.
  • Wyłącznie wychodzący HTTPS. Konektor nawiązuje połączenie z hostem platformy na porcie 443 (HTTPS i WebSocket przez TLS) i utrzymuje je otwarte. Po Twojej stronie nie jest potrzebna ani reguła zapory dla ruchu przychodzącego, ani opublikowany port.
  • Osiągalność systemu źródłowego. Konektor uwierzytelniania musi osiągnąć kontroler domeny albo serwer LDAP, zwykle na porcie 636 dla LDAPS lub 389 dla LDAP. Konektor aprowizacji musi osiągnąć cel SCIM, który ma obsługiwać.
  • Konto usługi dla katalogu. Konektor uwierzytelniania łączy się z Active Directory albo LDAP przy użyciu dedykowanego konta z prawem odczytu (konto z prawem zapisu jest potrzebne tylko wtedy, gdy włączysz Synchronizację upstream albo Password writeback).
  • Brak dostępu przychodzącego do samej maszyny. Wewnętrzna komunikacja między oknem a usługami jest powiązana z maszyną lokalną i odrzucana na każdym innym adresie.

Wybierz maszynę, która działa nieprzerwanie i znajduje się blisko usługi katalogowej, na przykład serwer zarządzania w tej samej lokalizacji. Dla odporności na awarie zainstaluj drugi konektor tego samego katalogu na innej maszynie, zamiast drugiego konektora na tej samej.

Uwaga: instalator nie jest jeszcze podpisany cyfrowo, dlatego Windows SmartScreen ostrzega przy pierwszym uruchomieniu. Zanim przejdziesz dalej, zweryfikuj sumę kontrolną wyświetlaną obok pliku do pobrania.

Pobieranie instalatora

  1. W konsoli otwórz Katalogi → Konektory Enterprise i utwórz konektor, który chcesz zarejestrować (zobacz Enterprise Connectors).
  2. Otwórz nowo utworzony konektor. Dopóki nie jest zarejestrowany, jego strona udostępnia Download for Windows wraz z wersją i sumą kontrolną SHA-1 instalatora.
  3. Pobierz instalator i skopiuj go na maszynę docelową.

Jeśli karta pobierania nie jest wyświetlana, usługa pobierania nie jest skonfigurowana dla Twojej instancji. Poproś o pakiet instalacyjny swojego opiekuna wsparcia.

Instalowanie aplikacji

  1. Uruchom instalator na maszynie docelowej i potwierdź monit o podniesienie uprawnień. Instalacja obejmuje wszystkich użytkowników i tworzy skrót na pulpicie.
  2. Uruchom aplikację. Przy pierwszym uruchomieniu rejestruje ona i startuje lokalną usługę brokera.
  3. Przy pierwszym uruchomieniu aplikacja prosi o ustawienie hasła i pyta o nie przy każdym kolejnym starcie. Każdy, kto ma dostęp do maszyny i to hasło, może zarządzać znajdującymi się na niej konektorami, traktuj je więc jak poświadczenie administracyjne.

Hasło chroni wyłącznie lokalne okno zarządzania. Nie ma związku z Twoim kontem w konsoli i nie jest używane do połączenia z platformą.

Rejestrowanie konektora

Rejestracja wiąże lokalną instalację z rekordem konektora utworzonym w konsoli.

  1. W konsoli otwórz konektor i skopiuj jego adres URL aprowizacji. Jest on wyświetlany tylko administratorom, którzy mogą edytować katalog (a interfejs API zarządzania zwraca go tylko klientom z enterpriseConnectors.write), ponieważ pierwsza rejestracja ustawia klucz szyfrowania katalogu.
  2. W aplikacji otwórz Agents i wybierz Provision agent.
  3. Wklej adres URL aprowizacji i zatwierdź formularz.

Aplikacja generuje parę kluczy, wymienia ją na trwałe poświadczenia konektora, instaluje usługę konektora i uruchamia ją. W ciągu kilku sekund konsola pokazuje konektor jako Ready.

Adres URL aprowizacji jest jednorazowy i wygasa po kilku dniach. Konektora, który jest już zarejestrowany, nie da się zarejestrować po raz drugi tym samym adresem URL. Jeśli adres URL wygasł, usuń oczekujący konektor w konsoli i utwórz nowy.

Przechwytywanie TLS i prywatne urzędy certyfikacji

Jeśli Twoja sieć terminuje i ponownie podpisuje ruch TLS albo host platformy używa certyfikatu prywatnego urzędu certyfikacji, rozwiń podczas rejestracji advanced TLS options:

  • Custom CA certificates (PEM) pozwala wkleić certyfikaty urzędów, którym konektor ma ufać dodatkowo względem magazynu zaufania systemu Windows. To zalecana droga.
  • Ignore invalid certificates całkowicie wyłącza weryfikację, zarówno dla rejestracji, jak i dla stałego połączenia konektora. Stosuj to wyłącznie jako rozwiązanie tymczasowe.

Oba ustawienia można później zmienić na stronie Identity aplikacji. Zobacz Konfigurowanie i obsługa konektora Enterprise.

Kilka konektorów dla tego samego katalogu

Wszystkie konektory uwierzytelniania jednego katalogu muszą działać z tą samą parą kluczy: pierwszy zarejestrowany konektor ustanawia klucz dla katalogu, a rejestracja każdego kolejnego konektora zostaje odrzucona, gdy jego klucz się różni. Aby dodać drugi konektor do istniejącego katalogu:

  1. Na maszynie, na której działa już konektor, otwórz Identity, wprowadź hasło zabezpieczające i wybierz Export keypair. Przechowuj zaszyfrowany blok i hasło zabezpieczające w bezpiecznym miejscu.
  2. W konsoli utwórz drugi konektor i skopiuj jego adres URL aprowizacji.
  3. Na drugiej maszynie wybierz Provision agent, wklej adres URL, rozwiń keypair import i wklej wyeksportowany blok razem z jego hasłem zabezpieczającym.

Hasło zabezpieczające jest jedyną ochroną wyeksportowanego klucza prywatnego i jedynym sposobem, aby ponownie otworzyć ten blok. Usuń wyeksportowaną kopię, gdy drugi konektor już działa.

Przenoszenie konektora na inną maszynę

Wykonaj te same kroki eksportu i importu co powyżej, a następnie wycofaj starą instalację:

  1. Wyeksportuj parę kluczy na starej maszynie.
  2. Utwórz nowy konektor w konsoli i zarejestruj go na nowej maszynie przy użyciu wyeksportowanej pary kluczy.
  3. Sprawdź, czy nowy konektor zgłasza Ready i obsługuje logowania.
  4. Odinstaluj konektor na starej maszynie i usuń jego rekord w konsoli.

Migracja wcześniejszego konektora

Jeśli na maszynie zainstalowany jest konektor poprzedniej wersji głównej, strona Agents pokazuje baner Previous connector found. Wybranie Import previous connector przenosi jego rejestrację, parę kluczy i ustawienia katalogu, a następnie zatrzymuje i usuwa starą usługę Windows. Konektor zachowuje swoją tożsamość w konsoli, więc ponowna rejestracja ani nowy adres URL aprowizacji nie są potrzebne.

Wszystko, czego nie udało się przenieść, zostaje wypisane jako ostrzeżenie po imporcie, na przykład filtr katalogu zapisany w starym formacie, który trzeba utworzyć na nowo na stronie Data source. Sprawdź ustawienia źródła danych i wykonaj test połączenia, zanim uznasz migrację za zakończoną.

Utrzymywanie aktualności

Aktualizacje występują w dwóch warstwach, obie obsługiwane na stronie Update aplikacji:

  • Aktualizacja aplikacji obejmuje samo okno zarządzania. Wybierz Download update, a następnie Install & restart. Okno zamyka się na chwilę, usługi konektorów działają dalej.
  • Aktualizacje agentów obejmują pliki binarne usług. Każda wersja aplikacji zawiera pasujące pliki binarne konektorów, dlatego po aktualizacji aplikacji lista Agents oznacza objęte nią konektory etykietą update available. Wybierz Update przy poszczególnych konektorach albo skorzystaj z karty Agent updates na stronie Update. Usługa konektora uruchamia się ponownie w ramach aktualizacji.

Gdy katalog obsługuje kilka konektorów, aktualizuj je pojedynczo, aby logowania działały także podczas ponownego uruchamiania. Strona Release notes w aplikacji wymienia zmiany w każdej wersji.

Uruchamianie, zatrzymywanie i ponowne uruchamianie

Lista Agents udostępnia Start, Stop i Restart dla każdego zainstalowanego konektora. Zatrzymanie jest zapamiętywane: konektor pozostaje zatrzymany także po restarcie maszyny, dopóki nie uruchomisz go ponownie.

Dopóki konektor uwierzytelniania jest zatrzymany, jego katalog nie ma drogi do Active Directory ani LDAP, chyba że inny konektor tego katalogu jest online. Logowania użytkowników tego katalogu w tym czasie się nie udają, a zaplanowana synchronizacja jest pomijana.

Odinstalowywanie

Usuwanie pojedynczego konektora

  1. W aplikacji otwórz Agents i wybierz Stop dla konektora. Odinstalowanie jest oferowane wyłącznie dla zatrzymanego konektora.
  2. Wybierz Uninstall. Usługa Windows zostaje zatrzymana i usunięta, a lokalny folder konektora skasowany.
  3. W konsoli usuń rekord konektora w sekcji Katalogi → Konektory Enterprise.

Usunięcie ostatniego konektora uwierzytelniania danego katalogu pozostawia ten katalog bez połączenia ze źródłem: logowania i synchronizacja ustają, dopóki nie zostanie zarejestrowany kolejny konektor. Wspólny klucz katalogu przetrwa usunięcie, więc konektor zastępczy trzeba zarejestrować tą samą, wcześniej wyeksportowaną parą kluczy.

Usuwanie całej instalacji

  1. Najpierw odinstaluj w aplikacji każdy konektor, jak opisano powyżej. Deinstalator aplikacji usuwa aplikację i lokalną usługę brokera, ale nie usługi konektorów, które nadal są zarejestrowane.
  2. Odinstaluj aplikację przez Ustawienia → Aplikacje w systemie Windows.
  3. Usuń rekordy konektorów w konsoli.

Rozwiązywanie problemów

  • SmartScreen blokuje instalator. Porównaj sumę kontrolną SHA-1 wyświetloną w konsoli z pobranym plikiem, a potem przejdź dalej przez Więcej informacji → Uruchom mimo to.
  • Rejestracja kończy się błędem wygasłego lub nieznanego biletu. Adres URL aprowizacji jest jednorazowy i krótkotrwały. Usuń oczekujący konektor w konsoli, utwórz nowy i zarejestruj go jego nowym adresem URL.
  • Rejestracja zostaje odrzucona z powodu innego klucza publicznego. Inny konektor tego samego katalogu został zarejestrowany z inną parą kluczy. Wyeksportuj parę kluczy z działającego konektora i zaimportuj ją podczas rejestracji.
  • Rejestracja kończy się błędem certyfikatu. Twoja sieć przechwytuje ruch TLS albo certyfikat platformy pochodzi z prywatnego urzędu certyfikacji. Wklej certyfikaty urzędu w zaawansowanych opcjach TLS.
  • Usługa konektora nie startuje. Otwórz Insight → Logs w aplikacji dla tego konektora. Usługa, która nie może osiągnąć platformy, ponawia próby bez przerwy, więc trwałe niepowodzenie wynika zwykle z ograniczenia zapory wychodzącej albo serwera proxy na porcie 443.
  • Usługa Windows jest zgłaszana jako oznaczona do usunięcia. Zamknij otwartą konsolę Usługi oraz kartę Usługi w Menedżerze zadań i spróbuj ponownie. Jeśli stan się utrzymuje, uruchom maszynę ponownie.
  • Konsola pokazuje konektor jako offline, mimo że usługa działa. Konektor działa, ale nie może nawiązać połączenia wychodzącego. Sprawdź stronę Status aplikacji, a następnie logi.

Zobacz też

Na tej stronie