/ docs
ProduktWiedzaDeweloperzy
Platforma Control
Konfiguracja SSO

Konfiguracja logowania jednokrotnego (SSO) z Azure AD i OpenID Connect dla platformy eConnect.

Dzięki logowaniu jednokrotnemu (SSO) użytkownicy mogą logować się do platformy eConnect za pomocą istniejącego konta firmowego, bez oddzielnego hasła. Połączenie działa przez OpenID Connect i jest najczęściej używane z Microsoft Azure AD (Entra ID). Po konfiguracji użytkownicy logują się swoim znanym kontem Microsoft i są automatycznie rozpoznawani w eConnect.

W skrócie: rejestruje Pan/Pani aplikację w Azure AD, wprowadza dane na platformie eConnect i testuje logowanie. Cały proces trwa około 15 minut, jeśli posiada Pan/Pani odpowiednie uprawnienia.

Czego Pan/Pani potrzebuje?
  • Aktywna subskrypcja Azure z Azure AD (Entra ID)
  • Uprawnienia administratora w dzierżawie Azure AD
  • Konto eConnect z rolą Administrator (Administracja > Użytkownicy)
  • Opcja konfiguracji IDP musi być aktywna na koncie (proszę skontaktować się z eConnect, jeśli jest niedostępna)
Konfiguracja Azure AD
Krok 1: Rejestracja aplikacji w Azure AD

Proszę otworzyć Azure AD i przejść do App registrations. Proszę kliknąć New registration i wypełnić formularz:

  • Name: eConnect
  • Supported account types: proszę wybrać typ odpowiedni dla organizacji
  • Redirect URI's (Web):
ŚrodowiskoURI'sProdukcjahttps://platform.econnect.eu/openid i https://identity.econnect.eu/signin-oidcPilothttps://pilot-platform.econnect.eu/openid i https://accp-identity.econnect.eu/signin-oidc

Proszę kliknąć Register. Proszę skopiować Application (client) ID z przeglądu i zapisać go.

Krok 2: Utworzenie client secret

Proszę przejść do Certificates & secrets i kliknąć New client secret. Proszę ustawić datę wygaśnięcia na maksymalnie 24 miesiące. Proszę natychmiast skopiować Value utworzonego sekretu (później nie będzie on widoczny).

Krok 3: Ustawienia uwierzytelniania

Proszę przejść do Authentication i włączyć ID tokens w sekcji Implicit grant and hybrid flows. Tutaj można również dodać dodatkowe redirect URI's, jeśli chce Pan/Pani połączyć zarówno produkcję, jak i pilot.

Krok 4: Konfiguracja uprawnień API

Proszę przejść do API permissions i kliknąć Add a permission:

  1. Proszę wybrać Microsoft Graph
  2. Proszę wybrać Delegated permissions
  3. Proszę wybrać uprawnienia: email, openid i profile
  4. Proszę kliknąć Add permissions

Uwaga: Proszę poprosić administratora Azure o udzielenie Admin consent dla tych uprawnień, jeśli jeszcze tego nie zrobiono.

Krok 5: Pobranie metadanych OpenID Connect

Proszę wrócić do przeglądu aplikacji i kliknąć Endpoints. Proszę skopiować URL dokumentu OpenID Connect metadata document. Będzie on potrzebny do konfiguracji w eConnect.

Konfiguracja platformy eConnect
Krok 1: Otwarcie konfiguracji IDP

Proszę zalogować się do platformy eConnect jako administrator. Proszę przejść do Administratie > IDP-configuratie. Jeśli ta opcja nie jest dostępna, eConnect musi ją najpierw aktywować dla Państwa konta.

Krok 2: Dodanie IDP

Proszę kliknąć przycisk +, aby dodać nowy IDP. Proszę wybrać Microsoft jako typ i zaakceptować sugerowane ustawienia.

Krok 3: Wprowadzenie danych

Proszę wypełnić następujące pola:

PoleWartośćNameNa przykład Microsoft AD – [nazwa organizacji]DescriptionKrótki opis połączeniaDiscovery Document URLURL metadanych OpenID Connect z Azure ADOAuth Client IDApplication (client) ID z Azure ADOAuth Client SecretKeyUtworzony client secret

Proszę kliknąć Fetch details, aby automatycznie pobrać konfigurację z dokumentu metadanych. Następnie proszę kliknąć Save.

Krok 4: Testowanie

Proszę się wylogować i przetestować logowanie SSO. Na ekranie logowania pojawi się teraz opcja logowania przez Microsoft.

Bezpośredni URL logowania

Czy chce Pan/Pani, aby użytkownicy pominęli standardowy ekran logowania i zostali przekierowani bezpośrednio przez SSO? Jest to możliwe dzięki bezpośredniemu URL logowania. URL ma następujący format:

https://platform.econnect.eu/login/{domena}/

Za pośrednictwem tego linku użytkownicy trafiają bezpośrednio na stronę logowania Azure AD, bez wyświetlania ekranu logowania eConnect. Proszę skontaktować się z działem wsparcia eConnect, aby skonfigurować bezpośredni URL logowania dla organizacji.

Wskazówka: Bezpośredni URL logowania jest idealny do umieszczenia w firmowym intranecie lub na pasku zakładek, aby pracownicy mogli uzyskać dostęp do platformy eConnect jednym kliknięciem.

Synchronizacja on-premise AD

Czy korzysta Pan/Pani z on-premise Active Directory? Azure AD obsługuje synchronizację przez Azure AD Connect, dzięki czemu istniejący użytkownicy stają się automatycznie dostępni w Azure AD. Więcej informacji można znaleźć w dokumentacji Microsoft dotyczącej integracji katalogów.

Najczęściej zadawane pytania
Czy mogę połączyć SSO ze standardowym logowaniem?

Tak. Po dodaniu IDP standardowe logowanie eConnect pozostaje dostępne. Na ekranie logowania użytkownicy wybierają, czy chcą zalogować się kontem Microsoft, czy hasłem eConnect. Jeśli chce Pan/Pani, aby możliwe było wyłącznie logowanie SSO (ograniczenie IdP), proszę skontaktować się z eConnect.

Czy SSO działa również z innymi dostawcami tożsamości?

Platforma eConnect obsługuje każdego dostawcę tożsamości zgodnego z OpenID Connect. Najczęściej używany jest Azure AD, ale Google Workspace i Apple ID są również obsługiwane jako standardowe metody logowania. Proszę skontaktować się z eConnect, aby podłączyć innego dostawcę.

Co jeśli moja dzierżawa Azure AD korzysta z innej domeny?

To nie ma znaczenia. Połączenie opiera się na URL metadanych OpenID Connect i nie zależy od konkretnej nazwy domeny. Dopóki redirect URI's są poprawnie skonfigurowane, logowanie SSO działa.

Czy chce Pan/Pani, aby eConnect skonfigurował SSO? Proszę skontaktować się z naszym zespołem wsparcia.

Skontaktuj się

PreviousFleetFlow
NextAutopilot