Dostawcy tożsamości
Podręcznik Mint Service Desk 3.4.2: instalacja, administracja oraz praca agentów i klientów.
Azure AD
Rejestracja aplikacji
Otwórz https://portal.azure.com, zaloguj się i przejdź do Microsoft Entra ID.
Otwórz aplikacje i rejestrację aplikacji.
Pojawi się poniższy formularz.
Uzupełnij go:
-
Wpisz wybraną nazwę.
-
Pozostaw domyślne obsługiwane typy kont.
-
Jako adres przekierowania podaj https://{your.mintsd.domain}/external/signin-{your-scheme}.
- Zastąp {your.mintsd.domain} własną domeną.
- Zastąp {your.scheme} nazwą schematu używaną w dalszej konfiguracji.
-
Po rejestracji otwórz kartę Uwierzytelnianie.
W sekcji przyznawania niejawnego zaznacz tokeny identyfikacyjne ID.
Deklaracje i uprawnienia API
Otwórz kartę konfiguracji tokenów.
Kliknij dodawanie opcjonalnego oświadczenia.
Wybierz token ID oraz oświadczenia email, given_name i family_name.
Jeśli potrzebujesz mapowania grup, dodaj oświadczenie grup, zaznacz wszystkie pola i kliknij „Dodaj”.
Przejdź do uprawnień API.
- Kliknij dodawanie uprawnienia.
- Wybierz Microsoft Graph.
- Wybierz uprawnienia delegowane i zaznacz email oraz profile.
Sekret klienta
Otwórz kartę certyfikatów i sekretów.
Dodaj nowy sekret klienta odpowiednim przyciskiem.
Skopiuj jego wartość przyciskiem kopiowania.
Konfiguracja dostawcy w Mint
W MINT otwórz Dostawcy tożsamości → Dostawcy OpenID i kliknij . Pojawi się formularz.
Uzupełnij pola:
- Nazwa: tekst widoczny na ekranie logowania.
- Schemat: wartość {your.scheme} z wcześniejszego kroku.
- Typ: AzureAd.
- Client Secret: skopiowany sekret z karty certyfikatów i sekretów.
- Client ID: identyfikator z podsumowania zarejestrowanej aplikacji.
- Tenant ID: identyfikator dzierżawy z podsumowania aplikacji.
- Oświadczenie grup: wpisz groups. Pojawią się pola mapowania grup. Wklej identyfikator grupy Azure w polu grup i wybierz rolę agenta, aby je powiązać. Przyciskiem dodawania można powiązać więcej grup w ramach jednego oświadczenia.
Identyfikator grupy znajdziesz w Azure AD pod ścieżką: Strona główna → Microsoft Entra ID → Zarządzaj → Grupy → Wszystkie grupy.
LDAP
Integracja LDAP umożliwia logowanie kontami domenowymi oraz synchronizację danych użytkowników, takich jak imię, nazwisko, e-mail i grupy.
Główny ekran pokazuje zapisane konfiguracje. Można dodawać nowe, edytować i usuwać istniejące, wyszukiwać oraz dodawać kolumny podobnie jak na pulpicie zgłoszeń.
Aby dodać konfigurację, kliknij przycisk . Otworzy się strona ustawień.
Poniżej opisano pola.
Pola konfiguracji
Pierwsza sekcja określa połączenie i uwierzytelnianie Mint Service Desk w katalogu LDAP: host, port, zabezpieczenia, Bind DN, dane logowania, certyfikaty oraz zakres pobieranych danych: bazę i filtr wyszukiwania oraz właściwość synchronizacji. Podstawą połączenia są host, port i zabezpieczenia. Dostępne są dwa warianty: bezpośrednie łączenie kontem użytkownika, wymagające bazy i filtra wyszukiwania, albo użycie konta domenowego do przeszukiwania katalogu, wymagające dodatkowo Bind DN i jego hasła.
| Pole | Opis | Przykład Active Directory |
|---|---|---|
| Host | Adres serwera LDAP. | ldap.example.com |
| Port | Port LDAP, 389, lub LDAPS, 636. | 636 |
| Aktywna | Włączenie lub wyłączenie integracji. | ✓ |
| Zabezpieczenia | Brak, StartTLS albo SSL/TLS. | SSL/TLS |
| Ufaj wszystkim certyfikatom | Akceptowanie wszystkich certyfikatów SSL, także niezaufanych. | ✓ |
| Wyłącz odwołania | Wyłączenie odwołań LDAP między serwerami. | ✓ |
| Bind DN | Konto techniczne odczytujące dane z LDAP. | CN=ldapuser,OU=ServiceAccounts,DC=example,DC=com |
| Dane logowania Bind | Hasło konta Bind DN. | •••••• |
| Baza wyszukiwania | Początek drzewa katalogu dla wyszukiwania użytkowników. | OU=Users,DC=example,DC=com |
| Filtr wyszukiwania | Filtr LDAP określający pobierane obiekty. | (&(objectClass=user)(sAMAccountName={0})(memberOf=CN=Helpdesk,OU=Groups,DC=example,DC=com)) |
| Właściwość synchronizacji | Unikalny atrybut identyfikujący użytkowników: nazwa użytkownika lub e-mail. | Wybierz nazwę użytkownika lub e-mail. |
Mapowanie danych użytkownika
Ta sekcja przypisuje atrybuty LDAP, takie jak sAMAccountName, mail i givenName, do pól Service Desk: loginu, adresu e-mail, imienia, nazwiska i grup. Można też mapować grupy na role użytkowników oraz dodatkowe atrybuty LDAP na pola niestandardowe profilu.
| Pole Service Desk | Atrybut LDAP | Opis |
|---|---|---|
| Nazwa użytkownika | sAMAccountName | Login do uwierzytelniania domenowego. |
mail | Adres e-mail użytkownika. | |
| Imię | givenName | Imię. |
| Nazwisko | sn | Nazwisko. |
| Przełożony | manager | Atrybut przechowujący przełożonego. |
| Grupy | memberOf | Atrybut przechowujący grupy użytkownika. |
| Mapowanie grup, widoczne po uzupełnieniu grup | OU=Users | Parametr z pola grup mapowany na role Mint Service Desk. |
| Mapowanie atrybutów, widoczne po uzupełnieniu grup | telephoneNumber | Dodatkowy atrybut LDAP mapowany na niestandardowe pole użytkownika. |
Przy skonfigurowanym mapowaniu ról system nadaje odpowiednie role przy każdym logowaniu i pobraniu grup użytkownika. Obowiązują wtedy role pobrane z LDAP, a nie ręczne zmiany w panelu administracyjnym.