Vai al contenuto

Autenticazione

Tutte le richieste all'API NSE devono essere autenticate. NSE supporta due metodi di autenticazione per l'accesso all'API:

  1. 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.
  2. 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).


Metodo 1: account di servizio (JWT tramite Client Credentials)

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.

Creazione di un account di servizio

  1. Accedere a Impostazioni dell'organizzazione → Utenti → Account di servizio.
  2. Fare clic su Crea account di servizio e indicare un ID client (deve essere univoco).
  3. 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.

Ottenere un token

Utilizzare il grant Client Credentials per ottenere un token JWT Bearer.


Metodo 2: token di accesso personale (PAT)

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).

Creazione di un PAT

  1. Accedere a Impostazioni → Account utente → Token di accesso personali.
  2. Fare clic su Nuovo token di accesso personale, indicare un Nome e una Data di scadenza (entrambi obbligatori).
  3. 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.

Utilizzo di un PAT

Inviare il PAT in un header dedicato, non in Authorization:

Personal-Access-Token: nse_pat_<value>