MS Graph - příprava schránky

Obecně

TAS se může napojit na Microsoft Graph API skrze naši integraci. Tato integrace umožňuje stahování a přesouvání e-mailů a příloh v definovaných schránkách, se kterými se dále zachází podle nastavených byznys pravidel.

Aby se TAS úspěšně napojil a manipuloval s obsahem těchto schránek, je třeba udělit integraci dostatečné oprávnění pro dané schránky (ať už vlastní nebo sdílené).

Zajištění oprávnění

1. Přihlaste se na https://portal.azure.com/#home.
2. V menu vyberte Azure Active Directory.
3. Zvolte možnost Přidat – registrace aplikace pro spuštění registrace aplikace (TASu).

1. Zadejte Název a ponechte volbu Single tenant only. Dokončete registraci kliknutím na Zaregistrovat.

1. Pro oprávnění ke čtení e-mailů vyberte v levém menu Oprávnění rozhraní API.

   

2. V okně Oprávnění API klikněte na Přidat oprávnění a v Microsoft APIs zvolte Microsoft Graph.

   

3. Následně v Request API permission zvolte Oprávnění aplikace, vyhledejte a zaškrtněte oprávnění Mail.ReadWrite. Následně dokončete přidávání.

   

4. Následně odebrat defaultní oprávnění User.read, které pro MS Graph není potřeba

1. V levém menu vyberte Certifikáty a tajné kódy.

1. V záložce Tajné kódy klienta (0) zvolte Nový Tajný kód klienta. Zadejte potřebné údaje a přidejte kód tlačítkem Přidat. Upozornění: po vypršení platnosti tohoto kódu je nutné přidat nový, jinak aplikace (TAS) ztratí přístup do schránky.

1. Schválení oprávnění administrátorem. Po schválení se změní výstražný trojúhelník u Oprávnění rozhraní API.

1. Omezení přístupu ke konkrétní schránce

Výše nastavené oprávnění poskytuje aplikaci přístup ke všem schránkám v doméně. Pro omezení přístupu pouze na zamýšlenou schránku je nutné nastavit přístupová pravidla pomocí PowerShellu.

Connect-ExchangeOnline -UserPrincipalName admin@domain.xyz
New-ApplicationAccessPolicy -AppId CLIENT_ID -PolicyScopeGroupId email@domain.xyz -AccessRight RestrictAccess -Description "Restrict this app to email@domain.xyz."

1. Pro úspěšnou konfiguraci ze strany TAS je potřeba tenant_id, client_id a client_secret:
   
   • tenant_id najdete zde:

   

   • client_id najdete zde:

   

   • client_secret alias tajný kód:

   

Zadání konfigurace

Zadání konfigurace cronu pro manipulaci s příchozími emaily je vysvětleno v tomto manuálu.