Przejdź do treści

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 .