> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Konfiguracja integracji

> Przygotuj dane uwierzytelniające dostawcy, połącz obsługiwany system, włącz jego strumienie danych i zweryfikuj pierwszą udaną synchronizację.

Ten przewodnik opisuje typową ścieżkę konfiguracji integracji wymienionych w sekcji **Ustawienia → Integracje → Katalog**. Pola specyficzne dla dostawcy, uprawnienia i kroki uwierzytelniania znajdują się w przewodniku konfiguracji, do którego prowadzi link na karcie danego dostawcy w Katalogu.

## Wymagania wstępne

| Rola | Zakres odpowiedzialności |
| - | - |
| [**Właściciel programu**](/pl/reference/glossary#w%C5%82a%C5%9Bciciel-programu) | Wybiera źródło, łączy je w Living Security, włącza strumienie i weryfikuje wynik |
| [**Administrator systemu**](/pl/reference/glossary#administrator-systemu) | Tworzy lub zatwierdza dane uwierzytelniające i zakresy uprawnień w systemie źródłowym |

Te role może pełnić jedna osoba. Osoba wprowadzająca dane uwierzytelniające w Living Security musi mieć rolę administratora, która umożliwia zarządzanie integracjami; nie zapraszaj administratora systemu źródłowego do Living Security wyłącznie w założeniu, że istnieje rola konfiguracyjna o wąskim zakresie uprawnień.

Przed rozpoczęciem:

* Wybierz organizację i środowisko Living Security, do których ma należeć połączenie.
* Otwórz przewodnik dostawcy w Katalogu i zbierz wymagane zakresy uprawnień, adresy URL przekierowania oraz wymagania dotyczące list dozwolonych.
* Jeśli dane uwierzytelniające tworzy i wprowadza różne osoby, skorzystaj z zatwierdzonego w Twojej organizacji procesu udostępniania sekretów.
* Nigdy nie wysyłaj haseł, sekretów klienta, kluczy prywatnych ani wartości kluczy dostępu w wiadomości e-mail ani w zgłoszeniu do pomocy technicznej.

## 1. Przygotowanie danych uwierzytelniających dostawcy

Otwórz **Ustawienia → Integracje → Katalog**, znajdź dostawcę i przed utworzeniem danych uwierzytelniających przeczytaj jego przewodnik konfiguracji.

Uwierzytelnianie u dostawcy może korzystać ze zgody OAuth, tokenu API, identyfikatora klienta i sekretu, konta usługi lub innej metody obsługiwanej przez dostawcę. Twórz wyłącznie dane uwierzytelniające i zakresy uprawnień wskazane w przewodniku danego dostawcy.

<Warning>
  Nie kopiuj uprawnień od innego dostawcy i nie przyznawaj szerokich uprawnień
  zapisu „na wszelki wypadek”. Brakujące uprawnienia zwykle powodują czytelny
  błąd 401 lub 403, który można poprawić; nadmiarowe uprawnienia stwarzają
  ryzyko, którego można uniknąć.
</Warning>

## 2. Połączenie z dostawcą

<Steps>
  <Step title="Otwórz Katalog">
    Przejdź do **Ustawienia → Integracje → Katalog** i wybierz dostawcę.
  </Step>

  <Step title="Rozpocznij połączenie">
    Wybierz **Połącz**. Przejdź przez proces OAuth lub wprowadź pola wymagane w
    oknie połączenia. Przewodnik dostawcy wyjaśnia, skąd pochodzi każda wartość.
  </Step>

  <Step title="Zakończ uwierzytelnianie">
    Jeśli dotyczy, zatwierdź ekran zgody dostawcy. Po pomyślnym uwierzytelnieniu Living Security otwiera nowe połączenie lub wyświetla je na liście w sekcji **Połączono**.
  </Step>
</Steps>

Jeśli dostawca odrzuci uwierzytelnianie, przerwij konfigurację i przed kontynuowaniem popraw dane uwierzytelniające, dzierżawę, region, adres URL przekierowania lub uprawnienia w systemie źródłowym.

## 3. Włączanie strumieni danych

Otwórz połączenie w sekcji **Ustawienia → Integracje → Połączono**. Living Security wykrywa szablony synchronizacji dostępne dla danego dostawcy i wyświetla je jako strumienie.

1. Sprawdź nazwę i przeznaczenie każdego strumienia.
2. Włącz tylko te strumienie, których potrzebuje Twój program.
3. Pozostaw niezwiązane strumienie wstrzymane.
4. Jeśli opcja jest dostępna, użyj **Zsynchronizuj teraz**, aby zażądać pierwszego uruchomienia.

Nie każdy dostawca oferuje te same strumienie ani elementy sterujące harmonogramem. Korzystaj z elementów sterujących wyświetlanych przy połączeniu i nie oczekuj uniwersalnego kreatora częstotliwości, zakresu, mapowania pól, wersji roboczej ani aktywacji.

## 4. Weryfikacja pierwszego uruchomienia

Samo uwierzytelnienie połączenia nie dowodzi, że dane są przesyłane.

<Steps>
  <Step title="Sprawdź kondycję połączenia">
    Upewnij się, że połączenie jest w dobrym stanie i nie wymaga ponownej autoryzacji.
  </Step>

  <Step title="Sprawdź stan strumienia">
    Upewnij się, że wymagany strumień jest włączony, a nie wstrzymany.
  </Step>

  <Step title="Sprawdź ostatnie uruchomienie">
    Otwórz strumień, link synchronizacji połączenia lub **Ustawienia** → **Integracje** → **Synchronizacja**. Poczekaj na pomyślny wynik końcowy i przejrzyj błędy dostawcy oraz liczbę rekordów, jeśli są dostępne.
  </Step>

  <Step title="Potwierdź dane docelowe">
    Otwórz odpowiedni obszar Living Security. Dane tożsamości powinny utworzyć oczekiwane osoby i tożsamości w sekcji Pracownicy; dane ze źródeł bezpieczeństwa powinny pojawić się w funkcji opisanej przez danego dostawcę.
  </Step>
</Steps>

W procesie wdrożenia zadania **Zweryfikuj przepływ danych tożsamości** oraz **Zweryfikuj przepływ danych integracji** na Mapie podróży kończą się na podstawie zaimportowanych danych. Nie zastępuj wyników tej weryfikacji zapisanym połączeniem.

## Strona szczegółów synchronizacji

W sekcji **Ustawienia** → **Integracje** → **Synchronizacja** otwórz dowolną synchronizację, aby zobaczyć w jednym miejscu jej konfigurację i historię uruchomień.

Strona szczegółów zawiera:

| Sekcja | Zawartość |
| - | - |
| **Nagłówek** | Nazwa synchronizacji, znacznik statusu i dostawca integracji |
| **Statystyki** | Model, ostatnia synchronizacja, zakończone uruchomienia i łączna liczba rekordów |
| **Historia uruchomień** | Ostatnie uruchomienia ze statusem, czasem i liczbą rekordów |
| **Działania** | **Odśwież**, **Pauza** / **CV** oraz **Zsynchronizuj teraz** |

Użyj **Zsynchronizuj teraz**, aby wywołać natychmiastowe uruchomienie, gdy synchronizacja jest aktywna. Wstrzymane synchronizacje trzeba wznowić, zanim rozpoczną się nowe uruchomienia zaplanowane lub ręczne.

Synchronizację można także otworzyć ze strony szczegółów połączenia, gdy integracja wyświetla aktywne strumienie.

## Operacje na połączeniu

Strona szczegółów połączenia udostępnia operacje obsługiwane przez daną integrację:

| Operacja | Skutek |
| - | - |
| **Zsynchronizuj teraz** | Żąda natychmiastowego uruchomienia dla wybranego strumienia |
| **Wstrzymaj strumień** | Zatrzymuje nowe uruchomienia tego strumienia, zachowując połączenie |
| **Wstrzymaj połączenie** | Zatrzymuje obsługiwaną aktywność połączenia bez usuwania konfiguracji |
| **CV** | Wznawia wstrzymany strumień lub połączenie |
| **Autoryzuj ponownie** | Powtarza uwierzytelnianie po zmianie danych uwierzytelniających lub zgody |
| **Usuń** | Po potwierdzeniu usuwa konfigurację połączenia |

Usunięcie połączenia nie jest równoznaczne z usunięciem danych już z niego zaimportowanych. Jeśli zasady przechowywania danych wpływają na Twoją decyzję, zapoznaj się z przewodnikiem dostawcy lub skontaktuj się z pomocą techniczną.

## Niestandardowe źródła push

Użyj opcji **Niestandardowe źródło push**, gdy system wysyła dane do Living Security, zamiast być odpytywanym przez konektor z Katalogu.

1. Utwórz źródło na dole **Katalogu**.
2. Otwórz jego stronę szczegółów w obszarze niestandardowych źródeł push.
3. Wybierz docelowy strumień.
4. Użyj **Prześlij plik CSV** dla ręcznej partii lub **Wyślij przez API** dla zautomatyzowanego nadawcy.
5. Po wysłaniu wyświetl podgląd pliku lub ładunku i przejrzyj historię uruchomień źródła.

Pełne informacje o punkcie końcowym, uwierzytelnianiu, ładunku, ponawianiu i weryfikacji znajdziesz w dokumencie [API niestandardowego źródła push](/pl/integrations/custom-push-source). Nie wnioskuj o tych szczegółach na podstawie starszego przewodnika integracji Unify.

Mechanizm przesyłania na stronie szczegółów źródła akceptuje źródłowy plik CSV o rozmiarze do 100 MB. Przed przesłaniem Pulpit dzieli go po stronie klienta na żądania o rozmiarze nie większym niż 10 MB i liczbie wierszy nie większej niż 10 000 każde. Ten mechanizm przesyłania specyficzny dla źródła jest oddzielony od ogólnej strony **Integracje → Przesyłanie** dla szablonów tożsamości i aktywności.

## Rozwiązywanie problemów

| Objaw | Co sprawdzić |
| - | - |
| `401 Unauthorized` | Wartość danych uwierzytelniających, wygaśnięcie, unieważnienie, dzierżawa dostawcy i stan ponownej autoryzacji |
| `403 Forbidden` | Wymagana rola u dostawcy, zakresy uprawnień, zgoda administratora i zasady dostępu w systemie źródłowym |
| Połączenie kończy się błędem od razu | Adres URL przekierowania, region, adres URL źródła, wymagania dotyczące sieci lub listy dozwolonych adresów IP |
| Połączenie jest w dobrym stanie, ale nie ma uruchomień | Wymagany strumień jest włączony, a dostawca udostępnia ten strumień |
| Udane uruchomienie nie zwraca rekordów | Konto źródłowe widzi oczekiwaną populację, a filtry po stronie dostawcy są poprawne |
| Dane pojawiają się przy niewłaściwej osobie | Atrybuty tożsamości i aliasy są spójne we wszystkich połączonych źródłach |
| Dane przestają się aktualizować | Strumień lub połączenie jest wstrzymane, dane uwierzytelniające wygasły albo ostatnie uruchomienie zakończyło się niepowodzeniem |

Kontaktując się z [pomocą techniczną Living Security](mailto:support@livingsecurity.com), podaj organizację, dostawcę, nazwę połączenia, strumień, czas ostatniego uruchomienia i widoczny błąd. Nie podawaj sekretów.

## Powiązane materiały

<CardGroup cols={2}>
  <Card title="Przegląd integracji" icon="grid-2" href="/pl/integrations/overview">
    Opis sekcji Połączono, Katalog, Synchronizacja, Działania i Przesyłanie.
  </Card>

  <Card title="Mapowanie danych" icon="arrows-left-right" href="/pl/integrations/managing/data-mapping">
    Poznaj obsługiwane atrybuty i mapowania, tam gdzie są dostępne.
  </Card>

  <Card title="Cykl życia integracji" icon="route" href="/pl/integrations/managing/lifecycle">
    Obsługa istniejącej integracji, w tym ponowna autoryzacja lub usunięcie.
  </Card>

  <Card title="Wdrożenie administratora" icon="circle-check" href="/pl/getting-started/onboarding">
    Wykonaj zadania weryfikacji danych tożsamości i danych bezpieczeństwa.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.