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.
The three apps at a glance
Section titled “The three apps at a glance”| 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.
Sign-in
Section titled “Sign-in”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.
How to consent
Section titled “How to consent”- 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.
- Open it and sign in with an account that may consent (see the table).
- Check the requested permissions and choose “Accept”.
- 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.
The mailbox
Section titled “The mailbox”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.
Business Central
Section titled “Business Central”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.
What is in your tenant afterwards
Section titled “What is in your tenant afterwards”- 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.
What fineelik stores
Section titled “What fineelik stores”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.