Configuration Raptor - BC
aptor 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 (!) so save them to your password manager
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 (technical who does the onboarding will provide this)
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 permissions sets are set up as in the following image
To successfully perform the taxonomy job, you sometimes need the SUPER (DATA) permission.
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)
Last updated