Tutte le richieste all'API NSE devono essere autenticate. NSE supporta due metodi di autenticazione per l'accesso all'API:
- Account di servizio — un'identità macchina, con ambito limitato a un'organizzazione, autenticata tramite OAuth 2.0 Client Credentials e utilizzata con un token JWT Bearer. Destinata alle integrazioni backend/server-to-server non associate a un utente specifico.
- Token di accesso personale (PAT) — un token associato a un singolo utente, inviato tramite un header dedicato. Destinato a script, integrazioni rapide o automazioni eseguite a nome di quell'utente.
Non esiste alcun tipo di token che conceda un accesso illimitato, a livello di intera organizzazione, a tutte le pratiche, i modelli e i file. Ogni richiesta — sia autenticata tramite un account di servizio sia tramite un PAT — è limitata alle autorizzazioni dell'identità associata al token (rispettivamente l'account di servizio o l'utente proprietario).
Un account di servizio è un'identità creata e gestita all'interno di un'organizzazione, utilizzata per autenticare le integrazioni backend senza il login di un utente.
- Accedere a Impostazioni dell'organizzazione → Utenti → Account di servizio.
- Fare clic su Crea account di servizio e indicare un ID client (deve essere univoco).
- Al salvataggio, NSE effettua il provisioning dell'account e restituisce una Chiave privata cliente. Salvarla immediatamente: come una password, non è più recuperabile dopo aver lasciato la pagina.
Gli account di servizio hanno come ambito l'organizzazione in cui sono stati creati e possono essere visualizzati, gestiti ed eliminati dalla stessa pagina Account di servizio.
Utilizzare il grant Client Credentials per ottenere un token JWT Bearer.
Un token di accesso personale autentica le richieste API come l'utente che lo ha creato: eredita l'insieme completo delle autorizzazioni di tale utente (senza scope separati).
- Accedere a Impostazioni → Account utente → Token di accesso personali.
- Fare clic su Nuovo token di accesso personale, indicare un Nome e una Data di scadenza (entrambi obbligatori).
- Fare clic su Salva. Il valore completo del token viene mostrato una sola volta, nel formato
nse_pat_<stringa di 40 caratteri>. Copiarlo immediatamente: non è più recuperabile dopo aver lasciato la pagina.
La vista elenco mostra successivamente solo nome, data di creazione e data di scadenza, mai il valore del token stesso. I token possono essere eliminati in qualsiasi momento dalla stessa pagina.
Inviare il PAT in un header dedicato, non in Authorization:
Personal-Access-Token: nse_pat_<value>