Skip to content

Microsoft consent for IT

This page is for the IT department of a fineelik customer. fineelik uses up to three separate apps from eelik. Each needs your consent once, as an administrator in Microsoft Entra ID, but only if you use the respective function.

App What for Requested permission Who may consent
Sign-in Colleagues sign in with Microsoft Microsoft Graph, delegated: openid, profile, email Cloud Application Administrator, Application Administrator, Privileged Role Administrator or Global Administrator
Mailbox fineelik collects invoices from a mailbox Microsoft Graph, application: Mail.ReadWrite Only Privileged Role Administrator or Global Administrator
Business Central fineelik reads and writes in Business Central Dynamics 365 Business Central, application: API.ReadWrite.All Cloud Application Administrator, Application Administrator, Privileged Role Administrator or Global Administrator

The reason for the differences lies with Microsoft: Only a Privileged Role Administrator (or a Global Administrator) may grant permissions of the type “application” on Microsoft Graph. For all other permissions, the Cloud Application Administrator and the Application Administrator are enough as well. The details come from the Microsoft documentation on admin consent (learn.microsoft.com, “Grant tenant-wide admin consent to an application”).

Publisher of the apps: eelik d.o.o., publisher domain fineelik.com.

With this, fineelik signs a person in and learns their name and email address.

  • Not requested: access to emails, calendar, files, Teams, the profile photo or other users. No access without a signed-in person.
  • Until the publisher verification is complete, Microsoft marks the app as “unverified”. Depending on the setting of your tenant, users may not consent to it themselves. That is why you give this one-time consent.
  1. You get the link from the fineelik administrator at your company. It is in fineelik under Settings, Users and access on the “Microsoft sign-in” card. It appears as soon as the domain has been entered there and the organisation has been found. Next to it are Copy link and Copy text for IT.
  2. Open it and sign in with an account that may consent (see the table).
  3. Check the requested permissions and choose “Accept”.
  4. You land on the fineelik page “Microsoft consent”, which shows the result. After that the fineelik administrator signs in with Microsoft again to complete the connection.

If you set up the mailbox with the fineelik app (Settings, Mailbox), this app needs the application permission Mail.ReadWrite. It lets fineelik read emails and move them to the target folder without anyone being signed in. The app may not send.

Important: Without further measures, this permission applies to all mailboxes of your tenant. So restrict it to the one mailbox in which your invoices arrive.

  • Application Access Policy: This is the way that fineelik recommends in the settings. You create a policy in Exchange Online that only allows the app the mailboxes of a certain group.
  • RBAC for Applications in Exchange Online: This is the newer method from Microsoft that is meant to replace the policy. You assign the app the role “Application Mail.ReadWrite” with a scope. Important here: Afterwards remove the unrestricted permission in Entra ID, otherwise access to all mailboxes remains.
  • Checking: Click Check connection in fineelik. fineelik shows whether the app also sees other mailboxes.

The details are in the Microsoft documentation (learn.microsoft.com, “Role Based Access Control for Applications in Exchange Online”). You find the consent link for the mailbox in fineelik under Settings, Mailbox (Open consent). The steps there are described under Setting up the mailbox.

The connection to Business Central uses an app of its own with the application permission API.ReadWrite.All on the Business Central API. Because this is not a permission on Microsoft Graph, the Cloud Application Administrator and the Application Administrator may consent here as well. You find the consent link and the further steps in Business Central under Settings, Leading system, see Leading system.

  • Up to three enterprise applications from eelik: one for sign-in, one for the mailbox and one for Business Central. Only those that you use appear.
  • For sign-in you control who may sign in: set “Assignment required” to Yes and assign users or groups.
  • Your policies also apply to sign-in: Microsoft requires multifactor authentication and conditional access before sign-in. fineelik does not ask for a second factor of its own on a Microsoft sign-in.
  • Revoking: Delete or disable the enterprise application of the respective function. If you delete the sign-in app, nobody comes to fineelik through Microsoft any more. Accounts with a password are not affected. If you delete the mailbox app, fineelik collects no more emails.

For each signed-in person: name, email address and the identifier of the person in your tenant. The tenant ID of your organisation is stored once when your fineelik instance is connected. fineelik only accepts accounts of your tenant. A sign-in from another tenant is rejected and logged. Whoever signs in for the first time has no rights in fineelik until a fineelik administrator grants them.