{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/it/products/namirialsignenterprise/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Autenticazione","description":"Integration and usage documentation."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"autenticazione","__idx":0},"children":["Autenticazione"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tutte le richieste all'API NSE devono essere autenticate. NSE supporta due metodi di autenticazione per l'accesso all'API:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"metodo-1-account-di-servizio-jwt-tramite-client-credentials","__idx":1},"children":["Metodo 1: account di servizio (JWT tramite Client Credentials)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creazione-di-un-account-di-servizio","__idx":2},"children":["Creazione di un account di servizio"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Accedere a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Impostazioni dell'organizzazione"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Utenti"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account di servizio"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fare clic su ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Crea account di servizio"]}," e indicare un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ID client"]}," (deve essere univoco)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Al salvataggio, NSE effettua il provisioning dell'account e restituisce una ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Chiave privata cliente"]},". Salvarla immediatamente: come una password, non è più recuperabile dopo aver lasciato la pagina."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gli account di servizio hanno come ambito l'organizzazione in cui sono stati creati e possono essere visualizzati, gestiti ed eliminati dalla stessa pagina ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account di servizio"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ottenere-un-token","__idx":3},"children":["Ottenere un token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Utilizzare il grant Client Credentials per ottenere un token JWT Bearer."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"metodo-2-token-di-accesso-personale-pat","__idx":4},"children":["Metodo 2: token di accesso personale (PAT)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un token di accesso personale autentica le richieste API ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["come l'utente che lo ha creato"]},": eredita l'insieme completo delle autorizzazioni di tale utente (senza scope separati)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"creazione-di-un-pat","__idx":5},"children":["Creazione di un PAT"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Accedere a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Impostazioni"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account utente"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token di accesso personali"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fare clic su ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Nuovo token di accesso personale"]},", indicare un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Nome"]}," e una ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data di scadenza"]}," (entrambi obbligatori)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fare clic su ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Salva"]},". Il valore completo del token viene mostrato ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["una sola volta"]},", nel formato ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nse_pat_<stringa di 40 caratteri>"]},". Copiarlo immediatamente: non è più recuperabile dopo aver lasciato la pagina."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"utilizzo-di-un-pat","__idx":6},"children":["Utilizzo di un PAT"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Inviare il PAT in un header dedicato, non in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Personal-Access-Token: nse_pat_<value>\n"},"children":[]}]},"headings":[{"value":"Autenticazione","id":"autenticazione","depth":1},{"value":"Metodo 1: account di servizio (JWT tramite Client Credentials)","id":"metodo-1-account-di-servizio-jwt-tramite-client-credentials","depth":2},{"value":"Creazione di un account di servizio","id":"creazione-di-un-account-di-servizio","depth":3},{"value":"Ottenere un token","id":"ottenere-un-token","depth":3},{"value":"Metodo 2: token di accesso personale (PAT)","id":"metodo-2-token-di-accesso-personale-pat","depth":2},{"value":"Creazione di un PAT","id":"creazione-di-un-pat","depth":3},{"value":"Utilizzo di un PAT","id":"utilizzo-di-un-pat","depth":3}],"frontmatter":{"seo":{"title":"Autenticazione"}},"lastModified":"2026-10-19T12:00:38.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/it/products/namirialsignenterprise/namirialsignenterprise-knowledge-center/03-developer-documentation/01-api-reference/authentication","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}