{"id":917519,"date":"2026-10-29T17:59:19","date_gmt":"2026-10-29T17:59:19","guid":{"rendered":"https:\/\/www.ninjaone.com\/blog\/api-server-ninjaone\/"},"modified":"2026-10-29T17:59:20","modified_gmt":"2026-10-29T17:59:20","slug":"api-server-ninjaone","status":"publish","type":"post","link":"https:\/\/www.ninjaone.com\/it\/blog\/api-server-ninjaone\/","title":{"rendered":"Come configurare un API server in NinjaOne"},"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>Se stai creando automazioni che richiamano l\u2019API di NinjaOne oppure importi dati da strumenti come Microsoft Defender o Tenable, ti serve un posto dove eseguire quegli script e un posto dove conservare le credenziali che utilizzano. Eseguire tutto questo da una workstation qualsiasi o dal tuo account da tecnico \u00e8 il modo pi\u00f9 rapido per far trapelare le credenziali o per vederle usate in modi difficili da tracciare.<\/p>\n<p>Un API server risolve il problema. \u00c8 un dispositivo Windows dedicato, isolato in un\u2019organizzazione e in un ruolo propri, che conserva le credenziali API in campi personalizzati sicuri visibili solo ai System Administrator. Questa guida ti accompagna nella configurazione da zero.<\/p>\n<h2>Requisiti per l\u2019API server di NinjaOne<\/h2>\n<p>Ti serviranno:<\/p>\n<ul>\n<li>Un dispositivo o una virtual machine con Windows. Vanno bene una macchina fisica, una virtual machine HyperV o una virtual machine nel cloud: ci\u00f2 che conta \u00e8 il sistema operativo.<\/li>\n<li>Accesso come System Administrator in NinjaOne.<\/li>\n<li>Un elenco chiaro dei servizi con cui questo server deve interagire (come minimo l\u2019API di NinjaOne, pi\u00f9 eventuali altri servizi come Defender o Tenable).<\/li>\n<\/ul>\n<p>L\u2019unico requisito irrinunciabile: nessuno, a parte i tuoi system administrator di NinjaOne, deve avere accesso a questo dispositivo. Conterr\u00e0 credenziali con permessi a livello di system administrator.<\/p>\n<h2>Passo dopo passo: come configurare l\u2019API server<\/h2>\n<h3>Passaggio 1: crea un\u2019organizzazione dedicata<\/h3>\n<p>Crea una nuova organizzazione che ospiti il tuo API server. In questo modo resta completamente separato dalle altre organizzazioni e non compare mischiato ai dati reali di clienti o endpoint.<\/p>\n<p>Per creare una nuova organizzazione:<\/p>\n<p>Fai clic sul \u201c+\u201d in alto a destra &gt; seleziona <strong>Organizzazione<\/strong> &gt; assegnale un nome come <strong>\u201cAPI Server\u201d<\/strong> &gt; fai clic su <strong>Salva<\/strong> in alto a destra.<\/p>\n<h3>Passaggio 2: crea un ruolo dispositivo personalizzato<\/h3>\n<p>Vai su <strong>Amministrazione &gt; Dispositivi &gt; Ruoli<\/strong>.<\/p>\n<p>Fai clic su <strong>Windows Systems<\/strong> per espanderlo &gt; passa il mouse su Windows Server (oppure su <strong>Windows Desktops and Laptops<\/strong>, se il tuo API server usa Windows 11), fai clic sui tre puntini &gt; fai clic su <strong>Aggiungi ruolo figlio<\/strong>.<\/p>\n<p>Chiama il ruolo <strong>\u201cAPI Server\u201d<\/strong> e crealo sotto il ruolo padre corrispondente al tuo sistema operativo.<\/p>\n<h3>Passaggio 3: crea i campi personalizzati sicuri<\/h3>\n<p>Sempre nella pagina Ruoli, nel menu a sinistra vai su <strong>Campi personalizzati dispositivo<\/strong> e crea tre nuovi campi, tutti di tipo <strong>Secure<\/strong>.<\/p>\n<p>Fai clic su <strong>Aggiungi campo personalizzato<\/strong> &gt; seleziona <strong>Secure<\/strong> &gt; nell\u2019etichetta inserisci <strong>\u201cNinjaOne Instance.\u201d<\/strong><\/p>\n<p>Nel menu a sinistra vai su <strong>Autorizzazioni<\/strong> &gt; imposta <strong>Automazioni su Sola lettura<\/strong> &gt; imposta <strong>API<\/strong> su <strong>Nessuno<\/strong> &gt; imposta <strong>Accesso di tutti i tecnici<\/strong> su <strong>Modificabile<\/strong> &gt; fai clic su <strong>Invia<\/strong>.<\/p>\n<p>Ripeti esattamente la stessa procedura per i due campi seguenti, cambiando solo le etichette:<\/p>\n<ul>\n<li><strong>NinjaOne Client ID<\/strong><\/li>\n<li><strong>NinjaOne Client Secret<\/strong><\/li>\n<\/ul>\n<p>Scrivi le etichette esattamente come indicato sopra. NinjaOne converte automaticamente l\u2019etichetta in un nome di campo in camelCase, e quel nome distingue maiuscole e minuscole quando lo richiami in uno script.<\/p>\n<p>Imposta l\u2019autorizzazione <strong>API<\/strong> su <strong>Nessuno<\/strong> per tutti e tre i campi. Non c\u2019\u00e8 alcun motivo per consentire un accesso a livello di API a un campo che contiene proprio le credenziali usate per autenticare le tue chiamate API.<\/p>\n<p><strong>Consiglio:<\/strong> se prevedi di importare dati da altri servizi come Defender o Tenable, ripeti questa procedura e crea campi personalizzati sicuri dedicati alle credenziali di ciascuno.<\/p>\n<h3>Passaggio 4: assegna i campi al tuo ruolo<\/h3>\n<p>Torna su <strong>Ruoli<\/strong> nel menu a sinistra &gt; espandi <strong>Windows Systems<\/strong> &gt; espandi il ruolo padre &gt; individua <strong>API Server<\/strong> e fai clic sui tre puntini a destra &gt; fai clic su <strong>Modifica<\/strong>.<\/p>\n<p>Fai clic su <strong>Gestisci schede<\/strong> in alto a destra &gt; fai clic su <strong>Aggiungi scheda<\/strong> e crea una nuova scheda (per esempio <strong>\u201cAPI Credentials\u201d<\/strong>) &gt; una volta creata, fai clic sul menu a discesa in alto a destra e passa alla nuova scheda &gt; nella barra di ricerca a sinistra digita <strong>\u201cNinjaOne\u201d<\/strong> &gt; aggiungi i tre campi personalizzati sicuri creati al Passaggio 3 &gt; fai clic su <strong>Salva modifiche<\/strong> in alto a destra.<\/p>\n<h3>Passaggio 5: crea e applica la policy<\/h3>\n<p>Vai su <strong>Policy<\/strong> &gt; fai clic su <strong>Aggiungi policy agente<\/strong> &gt; chiamala <strong>\u201cAPI Server\u201d<\/strong> &gt; come Ruolo seleziona il ruolo Windows Server (o Windows Desktop) sotto cui hai creato il ruolo personalizzato &gt; fai clic su <strong>Crea<\/strong> &gt; una volta aperta, fai clic su <strong>Chiudi<\/strong> in alto a destra.<\/p>\n<p>Poi vai su <strong>Organizzazioni<\/strong> &gt; seleziona l\u2019organizzazione <strong>API Server<\/strong> &gt; fai clic su <strong>Policy<\/strong> a sinistra &gt; individua la riga <strong>API Server<\/strong> e apri il menu a discesa &gt; assegna la policy appena creata &gt; fai clic su <strong>Salva<\/strong> in alto a destra &gt; una volta salvato, fai clic su <strong>Chiudi<\/strong>.<\/p>\n<h3>Passaggio 6: crea una categoria di automazione<\/h3>\n<p>In <strong>Amministrazione<\/strong>, vai su <strong>Libreria<\/strong> &gt; fai clic su <strong>Automazione<\/strong> a sinistra &gt; seleziona la scheda <strong>Categorie<\/strong> &gt; fai clic su <strong>Crea categoria<\/strong> all\u2019estrema destra &gt; assegnale un nome come <strong>\u201cAPI Scripts\u201d<\/strong> &gt; fai clic su <strong>Crea<\/strong>.<\/p>\n<p>In questo modo i tuoi script legati alle API restano organizzati e ottieni una categoria che potrai poi riservare ai soli System Administrator.<\/p>\n<h3>Passaggio 7: installa l\u2019agente<\/h3>\n<p>Scarica l\u2019installer dell\u2019agente NinjaOne per la tua organizzazione API Server ed eseguilo sul dispositivo o sulla virtual machine dedicata. In alternativa, se stai riutilizzando un dispositivo esistente, spostalo nell\u2019organizzazione API Server, aggiorna il suo ruolo e verifica che la policy <strong>API Server<\/strong> venga applicata tramite la nuova assegnazione.<\/p>\n<p>In NinjaOne, fai clic sul segno <strong>\u201c+\u201d<\/strong> in alto a destra &gt; fai clic su <strong>Dispositivo<\/strong> &gt; fai clic su <strong>Computer<\/strong> &gt; seleziona l\u2019organizzazione <strong>API Server<\/strong> e il ruolo API server &gt; fai clic su <strong>Genera installer<\/strong> &gt; poi scarica l\u2019installer oppure copia il link ed eseguilo sul tuo dispositivo.<\/p>\n<p>Aspetta che il dispositivo sia completamente registrato prima di proseguire.<\/p>\n<p>Se stai riutilizzando un dispositivo esistente, puoi farlo dalla griglia di ricerca dei dispositivi:<\/p>\n<p>Nel pannello di navigazione blu a sinistra, seleziona la <strong>scheda Dispositivi<\/strong> &gt; nell\u2019elenco dei dispositivi individua quello esistente &gt; seleziona la casella accanto al nome del dispositivo &gt; fai clic su <strong>Modifica<\/strong> &gt; fai clic su <strong>Organizzazione\/Sede<\/strong> e passa all\u2019organizzazione <strong>API Server<\/strong> &gt; fai clic su <strong>Aggiorna<\/strong><\/p>\n<p>Con il dispositivo ancora selezionato, fai clic su <strong>Modifica<\/strong> &gt; fai clic su <strong>Ruolo dispositivo<\/strong> e scegli il ruolo <strong>API<\/strong> personalizzato &gt; fai clic su <strong>Aggiorna<\/strong>.<\/p>\n<p>Con il dispositivo ancora selezionato, fai clic su <strong>Modifica<\/strong> &gt; fai clic su <strong>Policy<\/strong> e scegli la policy <strong>API<\/strong> Server &gt; fai clic su <strong>Aggiorna<\/strong>.<\/p>\n<h3>Passaggio 8: crea le credenziali API<\/h3>\n<p>Una volta che il dispositivo \u00e8 connesso, vai su <strong>Amministrazione &gt; App &gt; API<\/strong> e fai clic su <strong>Aggiungi app client<\/strong> in alto a destra.<\/p>\n<p>Seleziona <strong>API Services (machine-to-machine)<\/strong> e crea un\u2019app client con:<\/p>\n<ul>\n<li>Scope: Monitoring and Management<\/li>\n<li>Grant Type: Client credentials<\/li>\n<li>Redirect URL: lascia vuoto<\/li>\n<\/ul>\n<p>Fai clic su <strong>Aggiungi<\/strong>. NinjaOne generer\u00e0 un client ID e un client secret.<\/p>\n<h3>Passaggio 9: compila i campi personalizzati<\/h3>\n<p>Copia il client ID e il client secret dall\u2019app appena creata &gt; vai al dispositivo API Server &gt; passa il mouse sulla scheda personalizzata e seleziona la scheda <strong>API Credentials<\/strong> &gt; fai clic sull\u2019icona di modifica all\u2019estrema destra &gt; incolla il client ID e il client secret nei campi corrispondenti.<\/p>\n<p>Nel campo dell\u2019istanza, inserisci la tua region NinjaOne (la trovi nell\u2019URL di login):<\/p>\n<ul>\n<li>app.ninjarmm.com oppure us2 per le istanze USA<\/li>\n<li>ca.ninjarmm.com per le istanze Canada<\/li>\n<li>eu.ninjarmm.com per le istanze Europa<\/li>\n<li>oc.ninjarmm.com per le istanze Asia-Pacifico sud-orientale<\/li>\n<li>jp.ninjarmm.com per le istanze Giappone<\/li>\n<li>fed.ninjarmm.com per le istanze FedRAMP Moderate<\/li>\n<\/ul>\n<p><strong>Consiglio:<\/strong> questi nomi di campo distinguono maiuscole e minuscole una volta convertiti in camelCase (<strong>ninjaoneClientId<\/strong>, <strong>ninjaoneClientSecret<\/strong>, <strong>ninjaoneInstance<\/strong>). Se i tuoi script richiamano i campi ma non restituiscono nulla durante l\u2019esecuzione, verifica che le etichette corrispondano esattamente.<\/p>\n<p>Una volta inserite e testate le credenziali, torna su <strong>Amministrazione &gt; Dispositivi &gt; Campi personalizzati dispositivo &gt; cerca \u201cninjaone\u201d<\/strong> e fai clic sul nome dei campi per riportare l\u2019autorizzazione <strong>Accesso di tutti i tecnici<\/strong> su tutti e tre i campi da <strong>Modificabile<\/strong> a <strong>Sola lettura<\/strong>, cos\u00ec i valori non potranno essere alterati dopo la configurazione.<\/p>\n<h3>Passaggio 10: limita l\u2019accesso dei tecnici<\/h3>\n<p>\u00c8 questo il passaggio che rende sicura la configurazione. Senza di esso, qualsiasi tecnico pu\u00f2 visualizzare credenziali con accesso a livello di system administrator.<\/p>\n<p>Vai su <strong>Amministrazione &gt; Account &gt; Ruoli tecnico<\/strong>.<\/p>\n<p>Per ogni ruolo tecnico che non deve avere accesso (nella maggior parte dei casi, tutti tranne i system administrator):<\/p>\n<p>Fai clic sul ruolo desiderato per aprire l\u2019editor &gt; vai su <strong>Organizzazioni<\/strong> nel menu a sinistra.<\/p>\n<ul>\n<li>In Organizzazioni, imposta l\u2019organizzazione API Server su Nessun accesso.<\/li>\n<li>In Dispositivi, imposta il ruolo API Server su Nessun accesso.<\/li>\n<li>In Policy, imposta la policy API Server su Nessun accesso.<\/li>\n<li>Nella libreria di automazione, imposta la categoria API Scripts su Nessun accesso<\/li>\n<\/ul>\n<p>Come verificare la configurazione del tuo API server Una volta terminato, dovresti avere:<\/p>\n<ul>\n<li>Un\u2019organizzazione dedicata che contiene un solo dispositivo, il tuo API server.<\/li>\n<li>Un ruolo personalizzato con campi sicuri che conservano client ID, client secret e istanza.<\/li>\n<li>Una policy applicata solo a quell\u2019organizzazione.<\/li>\n<li>Una categoria di automazione bloccata per i tuoi script API.<\/li>\n<li>Tutti i ruoli tecnico non amministrativi impossibilitati a vedere l\u2019organizzazione, il ruolo dispositivo, la policy e la categoria di automazione.<\/li>\n<\/ul>\n<p>Se un tecnico di livello 1 riesce ad accedere all\u2019organizzazione API Server e a vedere qualcosa, torna al Passaggio 10.<\/p>\n<h2>Perch\u00e9 \u00e8 importante<\/h2>\n<p>Le credenziali API con grant type client credentials hanno un peso concreto. A seconda degli scope selezionati, chi le possiede pu\u00f2 leggere e scrivere dati in tutto il tuo ambiente NinjaOne. Conservare quelle credenziali in un campo personalizzato normale su un dispositivo condiviso, o lasciarle visibili a ogni tecnico, trasforma una configurazione di automazione utile in un rischio.<\/p>\n<p>Creare un API server dedicato richiede forse venti minuti la prima volta. In cambio ottieni una struttura pulita e verificabile: un unico posto per le credenziali, un\u2019unica policy che le governa e un modello di permessi per i tecnici che tiene tutto sotto controllo. Una volta realizzato, aggiungere una nuova integrazione significa semplicemente creare qualche campo personalizzato in pi\u00f9 e inserire lo script nella categoria API Scripts.<\/p>\n<p>Alcuni esempi di utilizzo di questa configurazione:<\/p>\n<p>Importazione dei dati sulle vulnerabilit\u00e0 da Microsoft Defender, cos\u00ec i risultati delle scansioni arrivano direttamente in NinjaOne invece di restare in una console separata.<br \/>\n<a href=\"https:\/\/github.com\/jeffhunterninja\/NinjaOne-Scripts\/tree\/main\/Vulnerability%20Import\/Microsoft%20Defender\" target=\"_blank\" rel=\"noopener\">Importazione delle vulnerabilit\u00e0 da Microsoft Defender<\/a><\/p>\n<p>Reportistica delle patch per Windows OS, che raccoglie lo stato delle patch di tutto l\u2019ambiente in una vista consolidata.<br \/>\n<a href=\"https:\/\/github.com\/jeffhunterninja\/NinjaOne-Scripts\/tree\/main\/Windows%20OS%20Patch%20Reporting\" target=\"_blank\" rel=\"noopener\">Reportistica delle patch per Windows OS<\/a><\/p>\n<p>Sincronizzazione dello stato delle patch, per mantenere i dati sulle patch allineati tra NinjaOne e un\u2019altra fonte attendibile, senza dover ricorrere a controlli manuali.<br \/>\n<a href=\"https:\/\/github.com\/jeffhunterninja\/NinjaOne-Scripts\/tree\/main\/Patch%20Status%20Sync\" target=\"_blank\" rel=\"noopener\">Sincronizzazione dello stato delle patch<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Se stai creando automazioni che richiamano l\u2019API di NinjaOne oppure importi dati da strumenti come Microsoft Defender o Tenable, ti serve un posto dove eseguire quegli script e un posto dove conservare le credenziali che utilizzano. Eseguire tutto questo da una workstation qualsiasi o dal tuo account da tecnico \u00e8 il modo pi\u00f9 rapido per [&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":[4338],"tags":[],"class_list":["post-917519","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-documentazione-it"],"acf":[],"modified_by":null,"_links":{"self":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts\/917519","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/users\/35"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/comments?post=917519"}],"version-history":[{"count":1,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts\/917519\/revisions"}],"predecessor-version":[{"id":917520,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts\/917519\/revisions\/917520"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/media\/857219"}],"wp:attachment":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/media?parent=917519"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/categories?post=917519"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/tags?post=917519"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}