Configuration Raptor - BC

Raptor setup: configuration

Go to https://raptor.9altitudes.com

1. Add Business Central as an external system

Configuration -> external systems -> add an external system (BC)

• make sure the 'Public'-toggle is on

Add the ID and secret to your password manager

• These are application keys, and you will see them only now (!)

• Once you have created the system, you must add at least one user to the system.

• Important note: button ‘Renew secrets’ : use this ONLY when the secret is compromised

2. Set up the Raptor users

Make sure to do this for every user

• Step 1 - 3: add a user

• Step 4: fill in the general information

  • Make sure to use the email address linked to the BC environment

• Step 5: switch the 'Enabled' toggle on

  • Note: we do not remove users, because we always need the reference so we can show information about i.e.: the uploader of a document. A disabled user will not be able to login to the UI, or get any data from the API gateway

• Step 6: add one or more roles

  • Basic = default role that is added automatically to a new user

  • You can also assign the administrator role

• Step 7: assign at least one external system to the user

  • In this case: assign BC as an external system

  • This is the system you want the user to be able to access Raptor directly from within that system

Check Azure App Registration

Note: the set up is normally already done by a technical, so you just need to check it

Go to https://entra.microsoft.com

1. Check the application ID

2. Check API permissions

This normally happens automatically

API permissions should include

• API.ReadWrite.All (= access to APIs and webservices)

• Automation.ReadWrite.All (= full access to automation)

BC setup: configuration

1. Set up users in BC

User setup - page -> New

• User ID: add the BC ID that you wish to add as a Raptor User

• 9A Raptor User Login: add the same email address you set up as a user in Raptor

2. User permissions

Users - page -> User Card -> User Permission Sets (FastTab)

Make sure the following permission sets are delegated to the user

• NAL Raptor Core

• NAL Raptor Email

• NAL Raptor Output

3. 9A Raptor Integration Setup

9A Raptor Integration Setup - page -> General FastTab

• System ID: enter the ID of your external system

• Secret: Azure app registration secret

• URL: https://raptor.9altitudes.com

  • Make sure it is always this URL

  • Not raptor.adultima.com

• Active: toggle on will automatically be triggered when the setup is completed

4. Set up the Microsoft Entra Application

Microsoft Entra Application - page

• Client ID = Azure Application ID

• Make sure the user groups and user permissions sets are set up as in the following image

5. Test connection

9A Raptor Integration Setup - page

• Click on the ‘Test Connection’-action

• When the connection failed, make sure to run through the steps again about the setup (in Raptor and BC)