Authorize Microsoft
Organization authorization grants Stuut access to work with your Microsoft tenant and discover shared mailboxes. It is completed once by a Microsoft administrator.Before you begin
You will need:- A Stuut organization administrator account. Its login email must be on your organization’s email domain, because Stuut uses this domain to find your Microsoft tenant.
- A Microsoft administrator account permitted to grant tenant-wide consent
Authorize your organization
- Open Settings → Mail in the Stuut dashboard.
- Find Microsoft in the Providers section.
- Enable Microsoft if it is not already enabled.
- Click Authorize.
- Sign into Microsoft with an organization administrator account.
- Review and approve the requested permissions.
- Return to Stuut and confirm that Microsoft appears as Authorized.
- Wait 5 minutes before you add mailboxes. Microsoft needs this time to apply the new permissions.
Application permissions
Microsoft application permissions are tenant-wide by default. Stuut uses them only for connected shared mailboxes. To enforce this in Microsoft, see Limit Stuut to specific mailboxes.
Limit Stuut to specific mailboxes
Your Exchange administrator can limit Stuut to approved mailboxes with an Exchange Online application access policy. Do this after you authorize Microsoft and before you add mailboxes.- Ask your Stuut team for Stuut’s application (client) ID.
- Create a mail-enabled security group that contains the approved mailboxes.
-
In Exchange Online PowerShell, create the policy:
- Wait up to 4 hours. Microsoft can take this long to apply the policy.
Add mailboxes
After Microsoft is authorized, each shared or personal mailbox must be added to Stuut individually.Shared mailboxes
Shared Microsoft mailboxes use the organization-approved application permissions described above. No one needs to sign in as the shared mailbox or provide its password. Each shared mailbox must be selected and connected individually.Add a shared mailbox
- Open Settings → Mail.
- Click Add mailbox.
- Select Shared mailbox.
- Select Microsoft.
- Choose a shared mailbox discovered in your Microsoft tenant.
- Enter an optional display name.
- Choose whether to use it as a centralized inbox.
- Click Connect mailbox.
Personal mailboxes
Each user must sign into Microsoft and authorize their own mailbox. Personal mailboxes use delegated permissions associated with the signed-in user.Delegated permissions
These delegated permissions apply to the signed-in account and any shared mailboxes that account is already permitted to access. Connecting one personal mailbox does not automatically connect other mailboxes in the organization.Connecting a personal mailbox does not give Stuut organization-wide access. The connection uses the permissions and mailbox access already assigned to the signed-in Microsoft user.
Add a personal mailbox
- Open Settings → Mail.
- Click Add mailbox.
- Select Personal mailbox.
- Select Microsoft if prompted.
- Sign into the Microsoft account that owns the mailbox.
- Review and approve the requested access.
- Return to Stuut and confirm that the mailbox appears as connected.