Sei già un cliente NinjaOne? Effettua il login per visualizzare le altre guide e gli ultimi aggiornamenti.

Integrazioni supporto dei confini nel modello di responsabilità condivisa

Argomento

Questo articolo descrive l'ambito delle responsabilità di supporto di NinjaOne relative alle nostre varie integrazioni, comprese le limitazioni e cosa aspettarsi nel caso in cui un problema esuli dal nostro ambito di competenza.

Ambiente

  • Integrazioni NinjaOne
  • A Autotask
  • ConnectSecure
  • ConnectWise Control
  • ConnectWise Manage
  • Duo
  • FreshService
  • ITGlue
  • Microsoft Defender
  • Qualys
  • Rapid7
  • ServiceNow
  • Splashtop
  • Tenable
  • RepairShopr
  • WinGet
  • Xero (fatturazione)
  • Zendesk

Descrizione

Quando colleghi NinjaOne a una piattaforma di terze parti tramite le nostre applicazioni di integrazione, il tuo lavoro si sincronizza tra due prodotti distinti, due base di codice separate e due organizzazioni di assistenza diverse. Questa interazione offre strumenti appositamente progettati per ogni attività, ma significa anche che, in caso di problemi, devi individuare l’origine del problema prima di poterlo risolvere.

Indice

Seleziona una categoria per ulteriori informazioni:

Principio fondamentale

Pensate a un'integrazione NinjaOne come a un ponte tra due piattaforme. NinjaOne possiede ed è responsabile della nostra parte del ponte, della sua costruzione, della sua Manutenzione e del traffico che vi facciamo transitare. Le piattaforme di terze parti possiedono la loro parte del ponte. Voi, in qualità di partner, decidete quali dati attraversano il ponte e come configurare il traffico su ciascuna estremità.

Quando si verifica un malfunzionamento, è importante determinare su quale lato del ponte si è verificato il problema, poiché disponiamo solo degli strumenti, dell’accesso e del contesto necessari per risolvere i problemi che si verificano dalla nostra parte.

Il nostro impegno

Il nostro obiettivo è non lasciarti mai senza una via d’uscita. Anche quando un problema esula dal nostro ambito di competenza, il nostro compito è aiutarti a capire dove si trova e come risolverlo. Quando contatti l’assistenza di NinjaOne per un problema di integrazione, provvederemo a:

  • Indagheremo sul problema per confermare se è causato da NinjaOne o vi reindirizzeremo alle Terze parti.
  • Spiegheremo chiaramente perché un problema esula dal nostro ambito.
  • Vi aiuteremo a formulare la domanda e il riepilogo corretti da sottoporre al fornitore di terze parti, affinché il passaggio di mano sia produttivo.
  • Vi forniremo supporto se vi trovate in una situazione di stallo tra due fornitori. Vi aiuteremo a identificare il percorso di escalation corretto e ci assicureremo di coprire tutte le fasi.
  • Ci assumeremo la responsabilità di qualsiasi bug di integrazione che troveremo e comunicheremo le sequenze temporali di risoluzione.
  • Garantire che questo articolo rimanga accurato e aggiornato man mano che le nostre integrazioni si evolvono.

Fornire feedback su questo articolo

Se ti imbatti in uno scenario che non abbiamo trattato in questo articolo, o se ritieni che un limite sia poco chiaro o impreciso, ti invitiamo a segnalarcelo tramite il tuo rappresentante dell’assistenza NinjaOne. Questo articolo è una risorsa in continua evoluzione e migliora grazie ai contributi provenienti dal mondo reale.

Matrice delle responsabilità

La tabella seguente definisce la proprietà nei principali livelli di ciascuna integrazione realizzata da NinjaOne.

AreaAspettative in materia di responsabilità
Disponibilità e tempo di funzionamento del connettore di integrazioneProprietà di NinjaOne
Infrastruttura dell’Interfaccia di Programmazione Applicativa (API) lato NinjaOneProprietà di NinjaOne
Sviluppo delle funzionalità di integrazione e correzione dei bugDi proprietà di NinjaOne
Compatibilità con la versione di integrazione attualeNinjaOne è responsabile di quest'area e ne cura la gestione; il partner si occupa degli aggiornamenti
Autenticazione e configurazione delle credenziali in NinjaOneNinjaOne guida il partner attraverso la Documentazione, mentre il partner gestisce la configurazione
Autenticazione e configurazione delle credenziali in una piattaforma di terze partiNinjaOne fornisce al partner le indicazioni necessarie tramite la Documentazione, mentre il partner gestisce la configurazione
Mappature dei campi e regole di trasformazione dei datiNinjaOne guida il partner attraverso la documentazione, mentre il partner gestisce la configurazione
Coordinamento dell’assistenza e contatto con i fornitoriNinjaOne supporta il partner nella diagnostica, mentre il partner gestisce o si occupa del contatto con i fornitori
Configurazione e impostazioni delle piattaforme di terze partiIl partner gestisce le configurazioni di installazione
Flussi di lavoro personalizzati, automazioni e script in una piattaforma di terze partiIl partner gestisce le configurazioni di installazione
Precisione dei dati e pulizia dei recordIl partner gestisce le configurazioni di impostazione
Licenze e autorizzazioni della piattaforma di terze partiIl partner gestisce le configurazioni di installazione
Funzionamento delle funzionalità delle piattaforme di terze partiProprietà di terze parti
Disponibilità e tempo di funzionamento della piattaforma di terze partiProprietà di terze parti
Comportamento delle API delle piattaforme di terze parti e limiti di velocitàProprietà di terze parti

Responsabilità relativa alla documentazione

NinjaOne fornirà la documentazione nel proprio Dojo per aiutarti a configurare un'integrazione connessa tramite NinjaOne. Alcune di queste integrazioni comportano flussi di lavoro che richiedono l'esecuzione di azioni sulla piattaforma di terze parti; in questi casi, NinjaOne fornirà anche la documentazione necessaria per aiutarti a completare tali passaggi.

NinjaOne non fornirà documentazione relativa alle piattaforme di terze parti se ciò non influisce direttamente sull’integrazione in NinjaOne, ma potremmo fornire link esterni a determinate risorse, ove applicabile. Per assistenza sull’utilizzo del prodotto di terze parti, è necessario fare riferimento alla documentazione proprietaria della stessa.

In che modo NinjaOne ti guida

Quando apri una richiesta di assistenza relativa a un’integrazione, NinjaOne intraprenderà le seguenti azioni a seconda del problema:

  • Verifica che il connettore di integrazione funzioni come previsto. Potremo confermare che la nostra parte dell’integrazione sia attiva, che il connettore stia trasmettendo i dati e che la versione dell’integrazione in uso sia aggiornata e supportata.
  • Confronteremo la tua configurazione con quella predefinita (OOTB). Utilizzando la nostra documentazione come riferimento, ti guideremo attraverso i passaggi di configurazione standard per verificare che la configurazione da parte di NinjaOne corrisponda alla configurazione OOTB da noi consigliata. Se necessario, aggiorneremo la nostra documentazione per fornire chiarimenti o indicazioni per la risoluzione dei problemi.
  • Tenteremo di riprodurre il problema in un ambiente di test, ove disponibile. Se un comportamento sembra essere un bug all’interno del livello di integrazione di NinjaOne, tenteremo di riprodurlo utilizzando le impostazioni predefinite (OOTB) e, se confermato, segnaleremo il problema al nostro team di ingegneri. Tieni presente che ciò richiederà tempo; gli ambienti di laboratorio non riflettono sempre le configurazioni reali, i dati diagnostici del report originale potrebbero essere incompleti e la disponibilità del team di ingegneri varia. Ti terremo aggiornato sullo stato e sulle tempistiche durante l’intero processo.
  • Identificheremo e documenteremo i bug di integrazione. Se individuiamo un difetto nella nostra parte dell’integrazione, ce ne assumeremo la responsabilità; lo registreremo, comunicheremo le tempistiche previste per le correzioni e forniremo soluzioni alternative, ove possibile, fino alla completa risoluzione del problema.
  • Assistenza nella configurazione dell’autenticazione e della connettività. Vi guideremo nella generazione delle credenziali API, nella configurazione della connessione in NinjaOne e nel test della connettività di base.
  • Forniremo documentazione specifica per l’integrazione e guide alla configurazione. Il nostro Dojo contiene istruzioni di configurazione passo dopo passo per ogni integrazione supportata, comprese le indicazioni sulla mappatura dei campi per le configurazioni predefinite.

Limiti del supporto NinjaOne

Le sezioni seguenti descrivono le aree che esulano da ciò che l’assistenza NinjaOne può diagnosticare, modificare o risolvere. In ciascun caso, il vincolo è l’accesso; non possiamo visualizzare gli strumenti, i dati o i sistemi necessari per indagare poiché sono di proprietà di terze parti.

Configurazione di piattaforme di terze parti

Non possiamo accedere alle informazioni del tuo account all’interno di una piattaforma di un fornitore, pertanto non possiamo visualizzare i flussi di lavoro configurati, le autorizzazioni, le configurazioni dei campi o le regole personalizzate. Quando il comportamento appare corretto in NinjaOne ma non funziona come previsto sulla piattaforma di terze parti, è necessario rivolgersi al team di assistenza di terze parti.

Un ticket creato in NinjaOne è visibile in Zendesk, ma è mancante nella vista prevista di Zendesk. NinjaOne ha completato il proprio compito poiché i dati hanno attraversato il ponte. Zendesk gestisce la logica di visualizzazione, pertanto il team di Supporto di Zendesk è l’interlocutore corretto a cui rivolgersi.

Flussi di lavoro personalizzati, automazioni e regole aziendali

Molti partner estendono le proprie piattaforme ITSM o PSA con automazioni personalizzate, trigger, regole di business o script. Questi elementi esulano completamente dalla visibilità e dal controllo di NinjaOne. Quando un flusso di lavoro personalizzato interagisce in modo imprevisto con i dati inviati da NinjaOne, il debug di tale flusso di lavoro richiede l’accesso alla piattaforma di terze parti, di cui dispongono solo voi o il team di assistenza di quella piattaforma.

Si configura un avviso da NinjaOne per creare un ticket in FreshService, ma una regola di automazione configurata in FreshService provoca la chiusura del ticket. Poiché la regola di business che ha chiuso il ticket risiede in FreshService, solo un amministratore di FreshService può esaminare o modificare la regola.

Comportamento delle API delle piattaforme di terze parti e limiti di frequenza

Ogni piattaforma di terze parti applica le proprie politiche API, inclusi limiti di frequenza, requisiti di autenticazione, vincoli sul payload e programmi di obsolescenza. Quando una piattaforma modifica il comportamento della propria API, o quando il tuo account raggiunge un limite di frequenza imposto dal fornitore di terze parti, NinjaOne non può ignorare tali vincoli. Adatteremo la nostra integrazione quando le piattaforme apportano modifiche significative alle API, ma non possiamo controllare i tempi né il comportamento stesso.

La creazione di ticket tramite l’API di ConnectWise Manage inizia a fallire con l’errore 429: Too Many Requests. Questo errore indica che ConnectWise sta applicando un limite di frequenza al tuo account. NinjaOne non ha apportato alcuna modifica; contatta ConnectWise per discutere delle loro regole relative alla capacità o alle licenze.

Configurazioni non predefinite, mappature dei campi e personalizzazioni dell’ambiente

NinjaOne fornisce integrazioni con una serie di mappature dei campi e impostazioni predefinite progettate per funzionare immediatamente. Supportiamo e documentiamo queste configurazioni predefinite e ne verifichiamo il comportamento previsto presso la nostra base di partner. Quando personalizzi le mappature, aggiungi trasformazioni dei campi o instradi i dati in modi che si discostano dalle impostazioni predefinite documentate, la manutenzione e la risoluzione dei problemi relativi a tali personalizzazioni diventano di tua responsabilità.

Tale personalizzazione va oltre le modifiche evidenti come le mappature dei campi. Le modifiche agli elenchi di controllo degli accessi (ACL), alle autorizzazioni basate sui ruoli, agli ambiti degli utenti API o alle politiche di sicurezza a livello di piattaforma nell’ambiente di terze parti possono impedire silenziosamente il corretto funzionamento dei comportamenti di integrazione predefiniti, anche quando tutto da parte di NinjaOne è corretto. Queste modifiche sono spesso invisibili a noi e potrebbero essere visibili solo all’amministratore o al team che le ha create.

Questo limite esiste perché la nostra convalida avviene solo in ambienti predefiniti (OOTB). Quando le impostazioni predefinite funzionano in migliaia di implementazioni dei partner, un problema isolato a un singolo ambiente è da attribuire a quell’ambiente, non all’integrazione. Le modifiche alle ACL, alle autorizzazioni o alle politiche di sicurezza della piattaforma possono compromettere silenziosamente il comportamento previsto, anche se ritenete che la vostra configurazione sia rimasta invariata. La diagnosi di tali modifiche spetta all’amministratore della vostra piattaforma o al team di assistenza di terze parti.

Licenze e autorizzazioni di accesso delle piattaforme di terze parti

Se l’integrazione smette di funzionare a causa di una credenziale API revocata, di un account utente disattivato, di un accesso all’abbonamento insufficiente o di una modifica alle autorizzazioni effettuata nella piattaforma di terze parti, si tratta di modifiche a livello di account che rientrano nella vostra gestione o nel supporto del fornitore di terze parti.

L’integrazione con Autotask smette di sincronizzarsi. Il connettore di NinjaOne è funzionante e invia richieste, ma riceve l’errore 401: Non autorizzato. Probabilmente le credenziali utente dell’API associate alla vostra integrazione con Autotask sono state disattivate, oppure qualcuno ha modificato le autorizzazioni in Autotask; questo tipo di modifica è visibile solo a un amministratore di Autotask.

Interruzioni di servizio e prestazioni delle piattaforme di terze parti

Se si verifica un'interruzione del servizio o un deterioramento delle prestazioni sulla piattaforma di terze parti, NinjaOne non è in grado di risolvere la situazione. Si consiglia di aggiungere ai preferiti le pagine di stato delle piattaforme integrate, riportate nella sezione del presente articolo intitolata “Pagine di stato per le integrazioni supportate”, in modo da poter escludere rapidamente questa causa durante la risoluzione dei problemi.

Supporto dell’assistenza e passaggi di consegne

L’assistenza NinjaOne opera all’interno dell’ambiente NinjaOne e il nostro accesso all’assistenza è strettamente limitato a tale ambiente. La tabella seguente descrive cosa possiamo o non possiamo fare per vostro conto quando si verificano problemi al di fuori dell’ambiente NinjaOne.

AzioneCapacità o limitazione di NinjaOne
Intervento diretto con le terze partiL'assistenza NinjaOne non può aprire o gestire ticket con fornitori di terze parti per vostro conto.
Riepilogo diagnosticoSe stabiliamo che il problema risiede in una piattaforma di terze parti, vi forniremo un Riepilogo diagnostico. Questo riepilogo include codici errore specifici e timestamp che abbiamo identificato nei log. Dovrete fornire questo riepilogo al team di assistenza del fornitore di terze parti per garantire un'indagine efficace.
Sicurezza dell’autenticazionePer la vostra sicurezza, il supporto NinjaOne non richiederà mai, e voi non dovrete mai fornire, le credenziali di accesso amministrative relative alle vostre piattaforme di terze parti integrate.

Come identificare l’origine di un problema

Prima di aprire un caso di assistenza, sia con NinjaOne che con un fornitore, esegui i seguenti passaggi per identificare la proprietà, in modo da poter contattare rapidamente il team corretto.

  1. Verifica lo stato della piattaforma: visita la pagina di stato della tua piattaforma integrata. Se è presente un incidente attivo, la pagina di stato dovrebbe riportarlo.
  2. Verifica la versione dell’integrazione sulla piattaforma di terze parti: NinjaOne installa solitamente un’integrazione come app client all’interno della piattaforma di terze parti. Accedi alle impostazioni dell’app o del connettore in quella piattaforma per confermare le impostazioni e verificare che tu stia utilizzando la versione corrente. Le integrazioni non aggiornate possono causare comportamenti imprevisti, e questa è una delle prime cose che il nostro team di assistenza vorrà verificare.
  3. Testare il problema con le impostazioni predefinite: se sono state apportate personalizzazioni (mappature di campi personalizzate, flussi di lavoro modificati o simili), disattivarle temporaneamente e eseguire un test utilizzando l'impostazione predefinita. Se il problema scompare, la causa probabile è la personalizzazione.
  4. Verifica i registri delle attività di integrazione di NinjaOne: NinjaOne fornisce registri delle attività e degli errori per ogni integrazione. Se i registri mostrano che i payload in uscita da NinjaOne sono stati inviati con successo, il problema è probabilmente dal lato ricevente. Queste informazioni costituiranno la base del tuo Riepilogo diagnostico nel caso in cui sia necessario segnalare il problema a una terza parte.
  5. Verifica i registri di audit o di attività della piattaforma di terze parti: la maggior parte delle piattaforme mantiene un registro delle attività API o un registro di audit. Se NinjaOne mostra che stiamo inviando i dati con successo, ma la piattaforma di terze parti non mostra alcuna traccia della ricezione o segnala errori al momento della ricezione, questo è un segnale chiaro su dove concentrare l’attenzione.

Pagine di stato per le integrazioni supportate

Utilizza la tabella seguente come guida per accedere alle pagine di stato dei vari fornitori.

Fornitore o PiattaformaURL della pagina di stato (link esterni)
A Autotaskhttps://status.autotask.net/
ConnectWise Managehttps://status.connectwise.com/
FreshServicehttps://status.freshworks.com/
ServiceNowhttps://status.servicenow.com
Zendeskhttps://status.zendesk.com/

Quando rivolgersi al supporto NinjaOne rispetto al supporto di terze parti

Utilizza la tabella seguente come guida per determinare quando rivolgerti al Supporto NinjaOne o a un fornitore di supporto di terze parti.

ProblemaResponsabile probabileRaccomandazione consigliata
L’integrazione è disconnessa o inattiva in NinjaOneNinjaOneContattare il supporto di NinjaOne
NinjaOne ha indicato che la funzionalità è supportata, ma non funzionaNinjaOneContatta il supporto di NinjaOne
Le impostazioni di integrazione di NinjaOne presentano errori o causano arresti anomaliNinjaOneContatta il supporto NinjaOne
L'autenticazione non riesce dopo la configurazione inizialeEntrambiContatta l'assistenza NinjaOne per verificare i requisiti, il che potrebbe comportare l'escalation al fornitore
I dati arrivano sulla piattaforma di terze parti, ma sono malformati o inseriti nei campi sbagliatiEntrambiContatta l'assistenza di NinjaOne se stai utilizzando l'impostazione predefinita, oppure contatta le terze parti se utilizzi una mappatura personalizzata
NinjaOne invia i dati, ma questi non compaiono nella piattaforma di terze partiTerze partiContatta l'assistenza del fornitore di terze parti
L'automazione o il flusso di lavoro in una piattaforma di terze parti si comporta in modo imprevistoFornitori terziContattare l'assistenza della piattaforma di terze parti
Si verificano errori relativi ai limiti di velocità o alle quote API da parte della piattaforma di terze partiTerze partiContattare il supporto del fornitore di terze parti
La piattaforma di terze parti è lenta o non disponibileTerze partiContatta il supporto della piattaforma di terze parti

Risorse aggiuntive

Consulta la sezione Integrazioni/Applicazioni di terze parti: Catalogo delle risorse per ulteriori informazioni sulle nostre integrazioni.

Domande frequenti

Passi successivi