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

# Konfiguracja SSO i provisioningu SCIM

> Połącz dostawcę tożsamości z AhaSlides, aby włączyć SSO, wymagaj SSO dla swojej domeny e-mail i automatycznie dodawaj członków zespołu przez SCIM 2.0.

Jednokrotne logowanie (SSO) pozwala Twojemu zespołowi logować się do AhaSlides przez dostawcę tożsamości Twojej organizacji zamiast hasła AhaSlides, a provisioning SCIM tworzy i dezaktywuje ich konta u tego samego dostawcy. Używaj ich razem, gdy Twój dział IT potrzebuje jednego miejsca do kontrolowania, kto ma dostęp do AhaSlides.

## Zanim zaczniesz z SSO i SCIM

SSO i SCIM nie są dostępne w każdym planie. Aby dodać je do swojego zespołu, skontaktuj się z nami przez [formularz Enterprise](https://ahaslides.com/enterprise/) lub pod adresem [hi@ahaslides.com](mailto:hi@ahaslides.com).

W ustawieniach zespołu nie ma ekranu SSO ani SCIM. Ty konfigurujesz swojego dostawcę tożsamości, a nasz zespół kończy konfigurację po stronie AhaSlides za Ciebie:

| Krok | Ty | AhaSlides |
| - | - | - |
| Połączenie dostawcy tożsamości | Tworzysz aplikację AhaSlides u swojego dostawcy tożsamości i wysyłasz nam jej dane | Wysyła nazwę Twojego dostawcy i włącza SSO dla Twojego zespołu |
| Powiązanie domen e-mail | Podajesz nam domeny, z którymi loguje się Twój zespół | Wiąże je z Twoim zespołem |
| Wymaganie logowania tylko przez SSO | Prosisz nas o włączenie | Włącza lub wyłącza dla powiązanych domen |
| Provisioning SCIM | Wpisujesz adres URL SCIM i token u swojego dostawcy tożsamości | Generuje Twój token SCIM |

Potrzebujesz dostępu administratora do swojego dostawcy tożsamości oraz [zespołu](/pl/teams-and-enterprise/managing-your-team-members) AhaSlides, do którego dołączą Twoi członkowie.

## Połącz dostawcę tożsamości

AhaSlides współpracuje z dowolnym dostawcą tożsamości SAML 2.0, takim jak Okta, oraz z Microsoft Entra ID.

<Steps>
  <Step title="Poproś nas o włączenie SSO">
    Skontaktuj się z nami, podając nazwę zespołu i domeny e-mail, z których korzystasz. Odpowiemy, przesyłając **nazwę dostawcy** (provider name) — krótki identyfikator Twojej organizacji, który pojawia się w adresach SSO.
  </Step>

  <Step title="Utwórz aplikację AhaSlides u swojego dostawcy tożsamości">
    Dla dostawcy SAML 2.0 utwórz aplikację SAML z tymi wartościami:

    | Pole | Wartość |
    | - | - |
    | Single sign-on URL (ACS URL) | `https://presenter.ahaslides.com/p/saml/your-provider-name/login/callback` |
    | Audience URI (SP entity ID) | Wartość, którą wyślemy Ci razem z nazwą dostawcy |
    | Name ID | Adres e-mail użytkownika |

    Możesz też pobrać nasze metadane dostawcy usług z `https://presenter.ahaslides.com/p/saml/your-provider-name/metadata`.

    W przypadku Microsoft Entra ID zarejestruj zamiast tego aplikację. Prześlemy Ci URI przekierowania, który należy do niej dodać.
  </Step>

  <Step title="Wyślij nam dane swojego dostawcy tożsamości">
    W przypadku SAML wyślij adres URL logowania dostawcy tożsamości, wystawcę (issuer) i certyfikat podpisu X.509 albo plik metadanych, który je zawiera. Jeśli chcesz, aby imię i nazwisko były uzupełniane, powiedz nam, które atrybuty je zawierają.

    W przypadku Microsoft Entra ID wyślij identyfikator dzierżawy (tenant ID), identyfikator klienta (client ID) i sekret klienta (client secret).
  </Step>

  <Step title="Przypisz osoby i przetestuj">
    Przypisz aplikację osobom, które mają korzystać z AhaSlides. Gdy potwierdzimy, że połączenie działa, przetestuj je, wykonując kroki z sekcji Logowanie przez SSO.
  </Step>
</Steps>

## Powiąż domeny e-mail ze swoim zespołem

SSO działa tylko dla adresów e-mail w domenie powiązanej z Twoim zespołem, a domeny powiązujemy my. Wyślij nam każdą domenę, z którą logują się Twoi członkowie.

* Domena może być powiązana tylko z jednym zespołem.
* Osoba, której e-mail należy do niepowiązanej domeny, nie może zalogować się przez Twoje SSO.

## Logowanie przez SSO

<Steps>
  <Step title="Otwórz stronę SSO">
    Na [stronie logowania AhaSlides](https://presenter.ahaslides.com/pages/login) kliknij **Zaloguj się przez SSO** (Log in with SSO).
  </Step>

  <Step title="Wpisz służbowy adres e-mail">
    Wpisz swój adres e-mail i kliknij **Zaloguj się** (Log in). AhaSlides przekieruje Cię na stronę logowania Twojej organizacji.
  </Step>

  <Step title="Zaloguj się przez swoją organizację">
    Po zalogowaniu się tam trafisz do AhaSlides.
  </Step>
</Steps>

Gdy ktoś loguje się przez SSO po raz pierwszy, AhaSlides tworzy jego konto, jeśli go nie ma, i dodaje go do Twojego zespołu z rolą **członek** (Member). Nigdy nie ustawia on hasła AhaSlides.

## Wymagaj SSO dla swojej domeny

Domyślnie skonfigurowanie SSO dodaje sposób logowania; nie usuwa pozostałych. Każdy, kto ma już hasło AhaSlides, nadal może z niego korzystać. Jeśli Twoja organizacja wymaga, aby SSO było jedyną drogą, poproś nas o włączenie logowania tylko przez SSO dla powiązanych domen. Najpierw potrzebne jest działające połączenie SSO.

Po jego włączeniu każdy, kto używa adresu e-mail w powiązanej domenie, zobaczy:

| Gdzie | Co widzi |
| - | - |
| Strony logowania, rejestracji i resetowania hasła | Okno zatytułowane **Twoja organizacja wymaga jednokrotnego logowania (SSO)** (Your organisation requires single sign-on) po wpisaniu adresu e-mail. **Kontynuuj z SSO** (Continue with SSO) przenosi na stronę SSO; **Użyj innego adresu e-mail** (Use a different email) czyści pole. |
| Strona SSO | Komunikat „Your organisation requires single sign-on. Please continue below to sign in." z uzupełnionym adresem e-mail |
| Ustawienia konta | Brak sekcji **Hasło** (Password), a adresu e-mail nie można edytować |

Dotyczy to każdego adresu w powiązanej domenie, w tym osób, które jeszcze nie dołączyły do Twojego zespołu.

## Konfiguracja provisioningu użytkowników SCIM

SCIM pozwala Twojemu dostawcy tożsamości tworzyć, aktualizować i dezaktywować konta AhaSlides za Ciebie. AhaSlides obsługuje SCIM 2.0 dla użytkowników.

<Steps>
  <Step title="Poproś nas o token SCIM">
    Generujemy token i wysyłamy go Tobie. Przechowuj go w bezpiecznym miejscu: zachowujemy tylko jego skrót, więc nie możemy pokazać go ponownie. Jeśli go zgubisz lub mógł zostać ujawniony, poproś nas o nowy.
  </Step>

  <Step title="Wpisz dane połączenia u swojego dostawcy tożsamości">
    | Ustawienie | Wartość |
    | - | - |
    | SCIM base URL | `https://presenter.ahaslides.com/api/scim/v2` |
    | Uwierzytelnianie | Token typu Bearer, wysyłany jako `Authorization: Bearer your-token` |
    | Unikalny identyfikator | `userName` |
  </Step>

  <Step title="Zmapuj atrybuty użytkowników">
    Zmapuj atrybuty wymienione w sekcji Obsługiwane atrybuty SCIM, a następnie włącz tworzenie, aktualizowanie i dezaktywowanie użytkowników. Synchronizację haseł pozostaw wyłączoną.
  </Step>

  <Step title="Przypisz użytkowników">
    Przypisz osoby lub grupy do aplikacji AhaSlides. Twój dostawca tożsamości utworzy wtedy ich konta.
  </Step>
</Steps>

### Obsługiwane atrybuty SCIM

| Atrybut SCIM | Do czego służy |
| - | - |
| `userName` | Adres e-mail członka. Identyfikuje użytkownika i jest zapisywany małymi literami. |
| `name.givenName`, `name.familyName` | Imię i nazwisko |
| `displayName` | Używany dla imienia i nazwiska tylko wtedy, gdy nie wysłano `name`: pierwsze słowo staje się imieniem, a reszta nazwiskiem |
| `active` | `true` utrzymuje konto aktywne; `false` dezaktywuje je i wylogowuje członka |
| `externalId` | Zwracany w odpowiedzi bez zmian |

### Obsługiwane operacje SCIM

| Metoda | Endpoint | Co robi |
| - | - | - |
| `GET` | `/Users` | Wyświetla użytkowników Twojego zespołu. Akceptuje `filter=userName eq "name@example.com"`, `startIndex` i `count` (domyślnie 10). |
| `GET` | `/Users/{id}` | Zwraca jednego użytkownika |
| `POST` | `/Users` | Tworzy użytkownika |
| `PATCH` | `/Users/{id}` | Aktualizuje wybrane atrybuty, na przykład `active` |
| `PUT` | `/Users/{id}` | Zastępuje atrybuty użytkownika |

Grupy i `DELETE` nie są obsługiwane. Aby odebrać komuś dostęp, ustaw `active` na `false`, co większość dostawców tożsamości wysyła po cofnięciu przypisania użytkownika.

Użytkownik utworzony przez SCIM dołącza do Twojego zespołu z rolą **członek** (Member). Jeśli adres e-mail należy już do konta AhaSlides, które nie jest w zespole, to konto jest dodawane do Twojego zespołu zamiast tworzenia nowego.

### Co zmienia się na stronie zespołu

Gdy SCIM jest włączony, Twój dostawca tożsamości jest miejscem do zarządzania członkostwem. Na stronie zespołu przycisk **Zaproś** (Invite) nie jest już wyświetlany, a członkowie nie mogą edytować własnego adresu e-mail w ustawieniach konta.

## Rozwiązywanie problemów z SSO i SCIM

### Test połączenia SCIM zwraca 401

Token jest brakujący, błędnie wpisany lub nieaktywny. Sprawdź, czy jest wysyłany jako token Bearer bez niczego dodanego wokół niego. Jeśli nadal nie działa, poproś nas o nowy token.

### Imię i nazwisko zaprowizjonowanego członka są błędne lub puste

Wyślij `name.givenName` i `name.familyName`. Gdy wysłano tylko `displayName`, AhaSlides dzieli go przy pierwszej spacji, co błędnie przypisuje imiona i nazwiska składające się z więcej niż dwóch części.

### Członek nie może zalogować się przez SSO

Sprawdź, czy członek jest przypisany do aplikacji AhaSlides u Twojego dostawcy tożsamości i czy jego domena e-mail jest jedną z tych, które poprosiłeś nas o powiązanie. Jeśli dodałeś nową domenę, daj nam znać, abyśmy mogli ją powiązać.

## Często zadawane pytania

<AccordionGroup>
  <Accordion title="Czy jedna domena e-mail może być powiązana z dwoma zespołami?">
    Nie. Każda domena należy do jednego zespołu, więc wszyscy z tej domeny logują się do tego samego zespołu.
  </Accordion>

  <Accordion title="Czy SCIM usuwa konta AhaSlides?">
    Nie. SCIM dezaktywuje konto i wylogowuje członka. Jego prezentacje pozostają na koncie.
  </Accordion>

  <Accordion title="Używam SSO i zapomniałem hasła. Co robić?">
    Nie masz hasła AhaSlides do zresetowania. Zaloguj się przez **Zaloguj się przez SSO** (Log in with SSO), a w artykule [Zmiana lub reset hasła](/pl/account-management/change-or-reset-your-password) przeczytasz, jak reset hasła traktuje konta SSO.
  </Accordion>
</AccordionGroup>

**Masz pytanie?**

Skontaktuj się z naszym zespołem wsparcia: jeśli jesteś zalogowany, użyj ikony czatu w prawym dolnym rogu panelu; w przeciwnym razie [napisz do nas tutaj](https://ahaslides.com/contact-us/) lub wyślij e-mail na adres [hi@ahaslides.com](mailto:hi@ahaslides.com).

Chcesz porozmawiać z innymi użytkownikami? Dołącz do [społeczności AhaSlides](https://community.ahaslides.com/), aby dzielić się wskazówkami, zgłaszać pomysły na funkcje i sprawdzać, jak inni angażują swoją publiczność.


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