{"id":940979,"date":"2026-11-13T17:39:29","date_gmt":"2026-11-13T17:39:29","guid":{"rendered":"https:\/\/www.ninjaone.com\/blog\/api-server-ninjaone-instellen\/"},"modified":"2026-11-13T17:39:30","modified_gmt":"2026-11-13T17:39:30","slug":"api-server-ninjaone-instellen","status":"publish","type":"post","link":"https:\/\/www.ninjaone.com\/nl\/blog\/api-server-ninjaone-instellen\/","title":{"rendered":"Zo stelt u een API-server in NinjaOne in"},"content":{"rendered":"<p><iframe title=\"How to Set Up an API Server\" width=\"800\" height=\"450\" src=\"https:\/\/www.youtube.com\/embed\/nuXa-bn32Iw?start=4&amp;feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe><\/p>\n<p>Bouwt u automatiseringen die de API van NinjaOne aanroepen of haalt u gegevens op uit tools als Microsoft Defender of Tenable? Dan hebt u een plek nodig om die scripts uit te voeren en een plek om de bijbehorende referenties op te slaan. Draait u dat vanaf een willekeurige werkplek of vanaf uw eigen technicusaccount dan lekken referenties uit of worden ze gebruikt op een manier die u niet goed kunt volgen.<\/p>\n<p>Een API-server lost dit op. Het is een speciaal ingericht Windows-device, ge\u00efsoleerd in een eigen organisatie en rol, dat uw API-referenties bewaart in beveiligde aangepaste velden die alleen systeembeheerders kunnen zien. In deze handleiding richt u er stap voor stap een in.<\/p>\n<h2>Vereisten voor een NinjaOne API-server<\/h2>\n<p>U hebt nodig:<\/p>\n<ul>\n<li>Een device of VM met Windows. Fysiek, een HyperV-VM of een cloud-VM werken allemaal, het gaat om het besturingssysteem.<\/li>\n<li>Toegang als systeembeheerder in NinjaOne.<\/li>\n<li>Een duidelijk overzicht van de diensten waarmee deze server moet communiceren (minimaal de API van NinjaOne, plus eventueel Defender of Tenable).<\/li>\n<\/ul>\n<p>De enige harde eis: niemand behalve uw NinjaOne-systeembeheerders mag toegang hebben tot dit device. Het bewaart straks referenties met rechten op systeembeheerdersniveau.<\/p>\n<h2>Stap voor stap: uw API-server inrichten<\/h2>\n<h3>Stap 1: maak een aparte organisatie aan<\/h3>\n<p>Maak een nieuwe organisatie aan voor uw API-server. Zo staat hij volledig los van uw andere organisaties en verschijnt hij niet tussen echte klant- of endpointgegevens.<\/p>\n<p>Een nieuwe organisatie aanmaken:<\/p>\n<p>Klik op de \u201c+\u201d rechtsboven &gt; selecteer <strong>Organization<\/strong> &gt; geef hem een naam als <strong>\u201cAPI Server\u201d<\/strong> &gt; klik rechtsboven op <strong>Save<\/strong>.<\/p>\n<h3>Stap 2: maak een aangepaste devicerol aan<\/h3>\n<p>Ga naar <strong>Administration &gt; Devices &gt; Roles<\/strong>.<\/p>\n<p>Klik op <strong>Windows Systems<\/strong> om het uit te klappen &gt; ga met de muis over Windows Server (of <strong>Windows Desktops and Laptops<\/strong> als uw API-server op Windows 11 draait) en klik op de drie puntjes &gt; klik op <strong>Add child role<\/strong>.<\/p>\n<p>Noem de rol <strong>\u201cAPI Server\u201d<\/strong> en maak hem aan onder het bovenliggende item dat bij uw besturingssysteem past.<\/p>\n<h3>Stap 3: maak beveiligde aangepaste velden aan<\/h3>\n<p>Ga binnen de pagina Roles links naar <strong>Device custom fields<\/strong> en maak drie nieuwe velden aan, allemaal van het veldtype <strong>Secure<\/strong>.<\/p>\n<p>Klik op <strong>Add custom field<\/strong> &gt; selecteer <strong>Secure<\/strong> &gt; vul als label <strong>\u201cNinjaOne Instance.\u201d<\/strong> in.<\/p>\n<p>Ga links naar <strong>Permissions<\/strong> &gt; zet <strong>Automations op Read Only<\/strong> &gt; zet <strong>API<\/strong> op <strong>None<\/strong> &gt; zet All <strong>technicians Access<\/strong> op <strong>Editable<\/strong> &gt; klik op <strong>Submit<\/strong>.<\/p>\n<p>Herhaal dit precies zo voor de volgende twee velden en wijzig alleen de labels:<\/p>\n<ul>\n<li><strong>NinjaOne Client ID<\/strong><\/li>\n<li><strong>NinjaOne Client Secret<\/strong><\/li>\n<\/ul>\n<p>Gebruik exact de labels zoals hierboven geschreven. NinjaOne zet het label automatisch om in een veldnaam in camelCase en die naam is hoofdlettergevoelig wanneer u er later in een script naar verwijst.<\/p>\n<p>Zet de rechten voor <strong>API<\/strong> op <strong>None<\/strong> bij alle drie de velden. Er is geen enkele reden voor toegang op API-niveau tot een veld dat juist de referenties bewaart waarmee uw API-aanroepen worden geauthenticeerd.<\/p>\n<p><strong>Tip:<\/strong> wilt u ook gegevens ophalen uit andere diensten zoals Defender of Tenable? Herhaal dit proces dan en maak aparte beveiligde aangepaste velden aan voor de referenties van elke dienst.<\/p>\n<h3>Stap 4: wijs de velden toe aan uw rol<\/h3>\n<p>Ga links terug naar <strong>Roles<\/strong> &gt; klap <strong>Windows Systems<\/strong> uit &gt; klap uw bovenliggende rol uit &gt; zoek <strong>API Server<\/strong> en klik rechts op de drie puntjes &gt; klik op <strong>Edit<\/strong>.<\/p>\n<p>Klik rechtsboven op <strong>Manage Tabs<\/strong> &gt; klik op <strong>Add tab<\/strong> en maak een nieuw tabblad aan (bijvoorbeeld <strong>\u201cAPI Credentials\u201d<\/strong>) &gt; klik na het aanmaken rechtsboven op de dropdown en schakel over naar het nieuwe tabblad &gt; typ in de zoekbalk links <strong>\u201cNinjaOne\u201d<\/strong> &gt; voeg de drie beveiligde aangepaste velden uit stap 3 toe &gt; klik rechtsboven op <strong>Save Changes<\/strong>.<\/p>\n<h3>Stap 5: stel uw beleid samen en pas het toe<\/h3>\n<p>Ga naar <strong>Policies<\/strong> &gt; klik op <strong>Add Agent policy<\/strong> &gt; noem het <strong>\u201cAPI Server\u201d<\/strong> &gt; selecteer bij Role de rol Windows Server (of Windows Desktop) waaronder u de aangepaste rol hebt aangemaakt &gt; klik op <strong>Create<\/strong> &gt; klik na het openen rechtsboven op <strong>Close<\/strong>.<\/p>\n<p>Ga vervolgens naar <strong>Organizations<\/strong> &gt; selecteer uw organisatie <strong>API Server<\/strong> &gt; klik links op <strong>Policies<\/strong> &gt; zoek de regel voor <strong>API Server<\/strong> en open de dropdown &gt; wijs het zojuist aangemaakte beleid toe &gt; klik rechtsboven op <strong>Save<\/strong> &gt; klik na het opslaan op <strong>Close<\/strong>.<\/p>\n<h3>Stap 6: maak een automatiseringscategorie aan<\/h3>\n<p>Ga in <strong>Administration<\/strong> naar <strong>Library<\/strong> &gt; klik links op <strong>Automation<\/strong> &gt; selecteer het tabblad <strong>Categories<\/strong> &gt; klik helemaal rechts op <strong>Create category<\/strong> &gt; geef hem een naam als <strong>\u201cAPI Scripts\u201d<\/strong> &gt; klik op <strong>Create<\/strong>.<\/p>\n<p>Zo houdt u uw API-scripts geordend en hebt u een categorie die u later kunt afschermen voor iedereen behalve systeembeheerders.<\/p>\n<h3>Stap 7: installeer de agent<\/h3>\n<p>Download de installateur van de NinjaOne Agent voor uw organisatie API Server en voer hem uit op uw speciaal ingerichte device of VM. Hergebruikt u een bestaand device? Verplaats het dan naar de organisatie API Server, werk de rol bij en controleer of het beleid <strong>API Server<\/strong> via de nieuwe toewijzing wordt toegepast.<\/p>\n<p>Klik in NinjaOne rechtsboven op het <strong>\u201c+\u201d<\/strong>-teken &gt; klik op <strong>Device<\/strong> &gt; klik op <strong>Computer<\/strong> &gt; selecteer uw organisatie <strong>API Server<\/strong> en de rol API-server &gt; klik op <strong>Generate Installer<\/strong> &gt; download daarna de installateur of kopieer de link en voer hem uit op uw device.<\/p>\n<p>Wacht tot het device volledig is geregistreerd voordat u verdergaat.<\/p>\n<p>Hergebruikt u een bestaand device dan kan dat via de Device Search Grid:<\/p>\n<p>Selecteer in het blauwe navigatievenster links het <strong>tabblad Devices<\/strong> &gt; zoek het bestaande device in de devicelijst &gt; klik op het selectievakje naast de devicenaam &gt; klik op <strong>Edit<\/strong> &gt; klik op <strong>Organization\/Location<\/strong> en schakel over naar de organisatie <strong>API Server<\/strong> &gt; klik op <strong>Update<\/strong><\/p>\n<p>Klik terwijl het device nog geselecteerd is op <strong>Edit<\/strong> &gt; klik op <strong>Device Role<\/strong> en kies de aangepaste rol <strong>API<\/strong> &gt; klik op <strong>Update<\/strong>.<\/p>\n<p>Klik terwijl het device nog geselecteerd is op <strong>Edit<\/strong> &gt; klik op <strong>Policy<\/strong> en kies het beleid <strong>API<\/strong> Server &gt; klik op <strong>Update<\/strong>.<\/p>\n<h3>Stap 8: maak API-referenties aan<\/h3>\n<p>Zodra uw device verbonden is, gaat u naar <strong>Administration &gt; Apps &gt; API<\/strong> en klikt u rechtsboven op <strong>Add client app<\/strong>.<\/p>\n<p>Selecteer <strong>API Services (machine-to-machine)<\/strong> en bouw een client-app met:<\/p>\n<ul>\n<li>Scopes: Monitoring and Management<\/li>\n<li>Grant Type: Client credentials<\/li>\n<li>Redirect URL: laat leeg<\/li>\n<\/ul>\n<p>Klik op <strong>Add<\/strong>. NinjaOne genereert een client-ID en een client secret.<\/p>\n<h3>Stap 9: vul uw aangepaste velden<\/h3>\n<p>Kopieer het client-ID en de client secret uit de app die u zojuist hebt aangemaakt &gt; ga naar uw device API Server &gt; ga met de muis over het aangepaste tabblad en selecteer het tabblad <strong>API Credentials<\/strong> &gt; klik helemaal rechts op het bewerkpictogram &gt; plak het client-ID en de client secret in de bijbehorende velden.<\/p>\n<p>Vul bij het instance-veld uw NinjaOne-regio in (te vinden in de login-URL):<\/p>\n<ul>\n<li>app.ninjarmm.com of us2 voor instances in de VS<\/li>\n<li>ca.ninjarmm.com voor instances in Canada<\/li>\n<li>eu.ninjarmm.com voor instances in Europa<\/li>\n<li>oc.ninjarmm.com voor instances in Zuidoost-Azi\u00eb en de Stille Oceaan<\/li>\n<li>jp.ninjarmm.com voor instances in Japan<\/li>\n<li>fed.ninjarmm.com voor instances met FedRAMP Moderate<\/li>\n<\/ul>\n<p><strong>Tip:<\/strong> deze veldnamen zijn hoofdlettergevoelig zodra ze zijn omgezet naar camelCase (<strong>ninjaoneClientId<\/strong>, <strong>ninjaoneClientSecret<\/strong>, <strong>ninjaoneInstance<\/strong>). Verwijzen uw scripts naar de velden maar krijgen ze bij uitvoering niets terug? Controleer dan of de labels exact overeenkomen.<\/p>\n<p>Zodra uw referenties zijn ingevuld en getest, gaat u terug naar <strong>Administration &gt; Devices &gt; Device custom fields &gt; zoek \u201cninjaone\u201d<\/strong> en klikt u op de veldnaam of veldnamen om bij alle drie de velden het recht <strong>All-technicians Access<\/strong> terug te zetten van <strong>Editable<\/strong> naar <strong>Read Only<\/strong>, zodat de waarden na de installatie niet meer gewijzigd kunnen worden.<\/p>\n<h3>Stap 10: zet de technicustoegang dicht<\/h3>\n<p>Dit is de stap die de inrichting veilig maakt. Zonder deze stap kan elke technicus referenties met toegang op systeembeheerdersniveau inzien.<\/p>\n<p>Ga naar <strong>Administration &gt; Accounts &gt; Technician Roles<\/strong>.<\/p>\n<p>Voor elke technicusrol die geen toegang hoort te hebben (in de meeste gevallen alle rollen behalve systeembeheerders):<\/p>\n<p>Klik op de gewenste rol om de editor te openen &gt; ga links naar <strong>Organizations<\/strong>.<\/p>\n<ul>\n<li>Zet onder Organizations de organisatie API Server op No Access.<\/li>\n<li>Zet onder Devices de rol API Server op No Access.<\/li>\n<li>Zet onder Policies het beleid API Server op No Access.<\/li>\n<li>Zet onder de automatiseringsbibliotheek uw categorie API Scripts op No Access<\/li>\n<\/ul>\n<p>Zo controleert u de configuratie van uw API-server. Als u klaar bent, hebt u:<\/p>\n<ul>\n<li>Een aparte organisatie met \u00e9\u00e9n device erin, uw API-server.<\/li>\n<li>Een aangepaste rol met beveiligde velden waarin uw client-ID, client secret en instance staan.<\/li>\n<li>Een beleid dat alleen op die organisatie wordt toegepast.<\/li>\n<li>Een afgeschermde automatiseringscategorie voor uw API-scripts.<\/li>\n<li>Elke technicusrol zonder beheerdersrechten geblokkeerd voor de organisatie, de devicerol, het beleid en de automatiseringscategorie.<\/li>\n<\/ul>\n<p>Kan een technicus van level 1 naar de organisatie API Server navigeren en daar iets zien? Ga dan terug naar stap 10.<\/p>\n<h2>Waarom dit belangrijk is<\/h2>\n<p>API-referenties met grant type client credentials wegen zwaar. Afhankelijk van de scopes die u selecteert kan degene die ze in handen heeft gegevens lezen en schrijven in uw volledige NinjaOne-omgeving. Bewaart u die referenties in een gewoon aangepast veld op een gedeeld device of laat u ze zichtbaar voor elke technicus dan verandert een nuttige automatiseringsopzet in een risico.<\/p>\n<p>Een eigen API-server bouwen kost de eerste keer zo\u2019n twintig minuten. Daar krijgt u een overzichtelijke, controleerbare structuur voor terug: \u00e9\u00e9n plek voor referenties, \u00e9\u00e9n beleid dat ze beheert en een rechtenmodel voor technici dat het geheel afgeschermd houdt. Zodra het staat, is een nieuwe integratie toevoegen niet meer dan een paar extra aangepaste velden aanmaken en het script in uw categorie API Scripts zetten.<\/p>\n<p>Een paar voorbeelden van waar deze opzet voor wordt gebruikt:<\/p>\n<p>Gegevens over kwetsbaarheden importeren uit Microsoft Defender, zodat scanresultaten rechtstreeks in NinjaOne terechtkomen in plaats van in een apart portaal.<br \/>\n<a href=\"https:\/\/github.com\/jeffhunterninja\/NinjaOne-Scripts\/tree\/main\/Vulnerability%20Import\/Microsoft%20Defender\" target=\"_blank\" rel=\"noopener\">Import van kwetsbaarheden uit Microsoft Defender<\/a><\/p>\n<p>Rapportage over Windows OS-patches, waarbij u de patchstatus uit uw hele omgeving in \u00e9\u00e9n overzicht samenbrengt.<br \/>\n<a href=\"https:\/\/github.com\/jeffhunterninja\/NinjaOne-Scripts\/tree\/main\/Windows%20OS%20Patch%20Reporting\" target=\"_blank\" rel=\"noopener\">Rapportage over Windows OS-patches<\/a><\/p>\n<p>Synchronisatie van de patchstatus, waarmee patchgegevens actueel blijven tussen NinjaOne en een andere bron van waarheid in plaats van dat u handmatig moet controleren.<br \/>\n<a href=\"https:\/\/github.com\/jeffhunterninja\/NinjaOne-Scripts\/tree\/main\/Patch%20Status%20Sync\" target=\"_blank\" rel=\"noopener\">Synchronisatie van de patchstatus<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Bouwt u automatiseringen die de API van NinjaOne aanroepen of haalt u gegevens op uit tools als Microsoft Defender of Tenable? Dan hebt u een plek nodig om die scripts uit te voeren en een plek om de bijbehorende referenties op te slaan. Draait u dat vanaf een willekeurige werkplek of vanaf uw eigen technicusaccount [&hellip;]<\/p>\n","protected":false},"author":35,"featured_media":857219,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","_lmt_disableupdate":"","_lmt_disable":"","footnotes":""},"categories":[4335],"tags":[],"class_list":["post-940979","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-it-documentatie"],"acf":[],"modified_by":null,"_links":{"self":[{"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/posts\/940979","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/users\/35"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/comments?post=940979"}],"version-history":[{"count":1,"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/posts\/940979\/revisions"}],"predecessor-version":[{"id":940980,"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/posts\/940979\/revisions\/940980"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/media\/857219"}],"wp:attachment":[{"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/media?parent=940979"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/categories?post=940979"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ninjaone.com\/nl\/wp-json\/wp\/v2\/tags?post=940979"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}