Microsoft Graph API
Połącz skrzynkę przez aplikację zarejestrowaną w Microsoft Entra ID, nadaj uprawnienia Graph i zapisz identyfikatory oraz sekret w Mint Service Desk.
Po kliknięciu tego przycisku pojawi się formularz:
Rejestracja aplikacji
Otwórz https://portal.azure.com, zaloguj się i przejdź do usługi Microsoft Entra ID.
Otwórz aplikacje i rejestrację aplikacji.
Pojawi się poniższy formularz.
Uzupełnij go:
- W polu nazwy wpisz wybraną nazwę.
- Pozostaw domyślny wybór obsługiwanych typów kont.
- Dla adresu przekierowania wybierz typ Web.
Skopiuj identyfikator aplikacji, czyli klienta, oraz identyfikator katalogu, czyli dzierżawy.
Wklej je tutaj:
Uprawnienia API
Po rejestracji otwórz Zarządzaj → Uprawnienia API w lewym menu.
Kliknij przycisk i w panelu po prawej wybierz Microsoft Graph.
Z dwóch opcji wybierz uprawnienia aplikacji po prawej stronie.
W sekcji poczty wybierz poniższe opcje:
Zapisz uprawnienia przyciskiem .
Możesz napotkać poniższą sytuację:
Nadanie uprawnień odczytu, zapisu i wysyłania wymaga zgody administratora domeny. Zaleca się ograniczenie dostępu aplikacji Graph do potrzebnych adresów e-mail. Domyślnie uprawnienia obejmują całą domenę, czyli wszystkie jej skrzynki.
Polityka dostępu aplikacji
Aby skonfigurować politykę dostępu aplikacji i ograniczyć zakres uprawnień:
Połącz się z Exchange Online PowerShell:
- Aby wymagać podpisu zaufanego wydawcy dla skryptów PowerShell pobranych z internetu, uruchom poniższe polecenie w oknie Windows PowerShell otwartym jako administrator.
Set-ExecutionPolicy RemoteSigned
- Zainstaluj moduł ExchangeOnlineManagement do zarządzania Exchange Online.
Install-Module -Name ExchangeOnlineManagement
- Zaloguj się do Exchange Online PowerShell. Pojawi się okno logowania.
Connect-ExchangeOnline -UserPrincipalName {your-admin-account@your-domain.com}
Ustal identyfikator klienta aplikacji oraz grupę zabezpieczeń z obsługą poczty, do której ograniczysz dostęp. Identyfikator aplikacji znajdziesz w portalu rejestracji Azure. Utwórz grupę lub użyj istniejącej i ustal jej adres e-mail:
- Dostęp do centrum administracyjnego Exchange wymaga uprawnień administratora Microsoft 365. Szczegóły opisują uprawnienia Exchange Online.
- Zaloguj się do Microsoft 365 lub Office 365 kontem służbowym albo szkolnym i wybierz kafelek administratora.
- W centrum administracyjnym wybierz Centra administracyjne → Exchange.
- W centrum Exchange przejdź do Odbiorcy → Grupy.
- Wybierz Nowy → Grupy zabezpieczeń i uzupełnij wymagane pola.
Utwórz politykę dostępu aplikacji.
- Uruchom poniższe polecenie, zastępując argumenty AppId, PolicyScopeGroupId i Description.
- New-ApplicationAccessPolicy -AppId e7e4dbfc-046f-4074-9b3b 2ae8f144f59b -PolicyScopeGroupId EvenUsers@contoso.com -AccessRight RestrictAccess -Description “Restrict this app to members of distribution group EvenUsers.”
Uwaga: zmiany polityk dostępu aplikacji mogą zacząć działać w wywołaniach Microsoft Graph REST API dopiero po ponad godzinie.
Sekret klienta i zapis
Następnie przejdź do certyfikatów i sekretów.
Kliknij przycisk .
W wysuniętym panelu wpisz opis ułatwiający rozpoznanie sekretu. W polu wygaśnięcia pozostaw domyślne 6 miesięcy lub wybierz inny okres.
Zatwierdź przyciskiem .
Po zapisaniu skopiuj wartość sekretu.
Wartość sekretu klienta jest widoczna tylko bezpośrednio po utworzeniu. Zapisz ją przed opuszczeniem strony.
Wklej skopiowaną wartość w polu Client Secret w MINT.
Konfiguracja powinna wyglądać podobnie do poniższej:
Zapisz konfigurację skrzynki przyciskiem .