# Enterprise Connectors

Zarządzanie konektorami lokalnymi, które łączą sieć organizacji z platformą na potrzeby uwierzytelniania, synchronizacji i aprowizacji.

**Enterprise Connector** to lekkie oprogramowanie instalowane we własnej sieci. Otwiera ono trwałe połączenie wychodzące do platformy i utrzymuje je aktywne; po stronie organizacji nic nie nasłuchuje połączeń przychodzących, a zapora sieciowa nie wymaga żadnej reguły przychodzącej. Żądania do Active Directory lub LDAP są przesyłane tym połączeniem do konektora, który komunikuje się z katalogiem lokalnie. Wszystkie konektory są zarządzane w jednym miejscu, w sekcji **Katalogi → Konektory Enterprise**, z przeglądem każdego konektora, jego statusu i przeznaczenia.

## Typy konektorów

Typ wybiera się podczas tworzenia konektora i **nie można go później zmienić**:

| Typ | Przeznaczenie | Powiązanie |
|---|---|---|
| **Uwierzytelnianie** | Weryfikuje logowania względem Active Directory / LDAP i synchronizuje użytkowników katalogu firmowego. | Dokładnie jeden katalog użytkowników. |
| **Aprowizacja** | Kieruje aprowizację wychodzącą (SCIM) do aplikacji działających w sieci organizacji. | Brak katalogu; wybierają go aplikacje. |

Konektor uwierzytelniania musi być powiązany z jednym katalogiem. Katalog może mieć **kilka** konektorów uwierzytelniania: każde żądanie logowania i synchronizacji trafia do konektora o najniższym zmierzonym w danej chwili opóźnieniu, a gdy jeden konektor przestaje działać, przejmują je pozostałe.

## Tworzenie i rejestracja konektora

1. Otwórz **Katalogi → Konektory Enterprise** i wybierz utworzenie nowego konektora.
2. Wprowadź **Nazwa** i wybierz **Typ**.
3. W przypadku konektora typu **Uwierzytelnianie** wybierz **Katalog**, który będzie obsługiwał. Jest to wymagane: pierwszy konektor uwierzytelniania katalogu ustanawia bezpieczny klucz, którym katalog chroni hasła end-to-end, dlatego musi wiedzieć, do którego katalogu należy.
4. Zapisz. Konektor pojawi się z **Adres URL aprowizacji** i statusem oczekiwania.
5. Zainstaluj oprogramowanie konektora we własnej sieci i zarejestruj je przy użyciu tego adresu URL aprowizacji. Po nawiązaniu połączenia status zmieni się na **Ready**. Pełną procedurę, w tym wymagania i pobieranie instalatora, opisano w sekcji [Instalowanie konektora Enterprise](https://dts-identity.com/pl/docs/directories/enterprise-connector-installation.md).

Adres URL aprowizacji jest jednorazowy i wygasa po kilku dniach. Jeśli wygaśnie przed rejestracją, usuń oczekujący konektor i utwórz nowy.

### Wiele konektorów i wspólny klucz

Wszystkie konektory uwierzytelniania tego samego katalogu muszą działać z **tą samą parą kluczy**. Pierwszy rejestrowany konektor ustala klucz katalogu; każdy kolejny musi przedstawić ten sam klucz, w przeciwnym razie rejestracja zostanie odrzucona. Dzięki temu ochrona haseł pozostaje spójna niezależnie od tego, który konektor obsługuje dane logowanie.

## Status i monitorowanie

Każdy konektor pokazuje swój bieżący stan:

- **Ready**: połączony i dostępny.
- **Połączono**: połączony, ale jeszcze nie w pełni zainicjowany.
- **Oczekujące**: utworzony, ale jeszcze niezarejestrowany.
- **Rozłączono**: obecnie niepołączony.

Po otwarciu konektora widoczne są szczegóły hosta, wersja, czas ostatniej aktywności oraz, gdy konektor jest połączony, wykres czasu odpowiedzi (round-trip time) na żywo.

Każda zmiana stanu jest zapisywana w dzienniku audytu jako `CONNECTOR_ONLINE` / `CONNECTOR_OFFLINE`. Gdy większość zarejestrowanych konektorów uwierzytelniania katalogu jest offline, dodatkowe zdarzenie `DIRECTORY_DEGRADED` sygnalizuje, że logowanie względem katalogu może być utrudnione. Aby otrzymywać powiadomienia o tym zdarzeniu, użyj szablonu alarmu **Katalog w stanie obniżonej dostępności**.

### Powiadomienie o aktualizacji

Gdy dostępna jest nowsza wersja konektora, pulpit administratora wyświetla u góry strony ostrzeżenie z listą konektorów działających w starszej wersji, a pozycja **Konektory Enterprise** w nawigacji jest oznaczona czerwoną kropką. Konektory, które nigdy nie zgłosiły wersji lub nie były widoczne od 30 dni, nie są tam wymieniane. Lista konektorów oznacza każdy konektor w wersji starszej niż najnowsza plakietką **Dostępna aktualizacja**, także konektory, które są offline od dłuższego czasu. Powiadomienie znika, gdy każdy aktywny konektor działa w najnowszej wersji.

## Aprowizacja przez konektor

Gdy aplikacja aprowizuje użytkowników do systemu działającego w sieci organizacji, aprowizację można kierować przez jeden lub kilka konektorów typu **Aprowizacja**. Na karcie **Aprowizacja** aplikacji, w sekcji **Łączność**, wybierz konektory do użycia w kolejności priorytetu. Gdy wybrano konektory, aprowizacja odbywa się **wyłącznie** przez nie; gdy żaden nie jest wybrany, platforma łączy się z systemem docelowym bezpośrednio przez internet.

## Usuwanie konektora

Konektor można usunąć, gdy jest **Offline**. Najpierw rozłącz lub zatrzymaj konektor w swojej sieci, a następnie usuń go tutaj.

## Rozwiązywanie problemów

- **Konektor pozostaje w stanie oczekiwania**: adres URL aprowizacji nie został użyty na czas lub konektor nie może połączyć się z platformą. Sprawdź łączność wychodzącą, a jeśli adres URL wygasł, utwórz konektor ponownie.
- **Rejestracja kolejnego konektora odrzucona**: drugi konektor uwierzytelniania w tym samym katalogu musi używać tej samej pary kluczy co pierwszy. Użyj ponownie istniejącego klucza.
- **Konektor łączy się, ale jest odrzucany z powodu niezgodności klucza publicznego**: konektor używa innej pary kluczy niż ta zapisana dla jego katalogu. Zaimportuj do tego konektora wyeksportowaną parę kluczy pierwotnego konektora katalogu; jeśli ta para kluczy została utracona, usuń wszystkie konektory uwierzytelniania katalogu i zarejestruj je ponownie.
- **Nie można usunąć konektora**: jest nadal online. Najpierw go zatrzymaj, a następnie usuń.

Informacje o oprogramowaniu we własnej sieci zawierają strony [Instalowanie konektora Enterprise](https://dts-identity.com/pl/docs/directories/enterprise-connector-installation.md) oraz [Konfigurowanie i obsługa konektora Enterprise](https://dts-identity.com/pl/docs/directories/enterprise-connector-configuration.md).
