Account di servizio

Un'identità per il software — un'integrazione, un'esportazione programmata, il servizio di assistenza — che detiene ruoli come una persona, non effettua mai l'accesso alla console e non richiede mai un secondo passaggio.

L'autenticazione a due fattori è adatta a ogni persona ma inadatta a ogni script: un programma che effettua l'accesso con una password si vede richiedere un codice che non può digitare. Un account di servizio è l'identità che il software utilizza al suo posto. Detiene ruoli e aziende esattamente come una persona, quindi ogni concessione di schermo, limitazione dell'unità organizzativa e regola di incarico si applica ad esso, ma non ha una password nota a nessuno, il modulo di accesso lo rifiuta e non può utilizzare le parti personali o interattive della console (preferenze, personalizzazione, dashboard, assistente, configurazione a due fattori, console di sistema).

1. Apri Piattaforma → Accesso e sicurezza → Accesso → Account di servizio (accanto a Utenti) e scegli Nuovo account di servizio.
2. Assegna un indirizzo che ne indichi lo scopo (ad esempio, nightly-export@service.yourcompany), un nome e una breve descrizione della sua funzione.
3. Seleziona i suoi ruoli. Assegna il ruolo più specifico che svolga la funzione richiesta: un ruolo con la sola visualizzazione degli ordini di acquisto è una chiave in grado di leggere esclusivamente gli ordini di acquisto.
4. È possibile, facoltativamente, limitarne l'utilizzo agli indirizzi (un IP o un intervallo IPv4 come 203.0.113.0/24), ridurne la durata o assegnargli una data di scadenza.
5. Crealo. Il segreto viene mostrato UNA SOLA VOLTA: copialo nel programma che lo utilizzerà. Viene memorizzato solo come impronta digitale e non può essere letto.

Il programma scambia il segreto con un token che dura alcuni minuti e invia il token a ogni chiamata come qualsiasi altro token bearer:

POST /api/auth/service-token
{ "client_id": "nightly-export@service.yourcompany", "secret": "txs_…" }

→ { "token": "…", "expires_in": 3600, "companies": [ … ] }

GET /api/scm/purchase-orders
Authorization: Bearer <token>
X-Company: <company id>

• Il nuovo segreto emette un token sostitutivo e blocca immediatamente il precedente. I token già emessi scadranno a meno che non vengano annullati.
• La revoca interrompe il segreto E termina ogni token attivo alla successiva richiesta.
• La disattivazione elimina l'account; il suo nome rimane comunque presente in ogni riga di controllo in cui è stato scritto.
• Ogni token rappresenta una sessione: appare in Piattaforma → Accesso → Sessioni Web e Utente e può essere terminato da lì come qualsiasi altra sessione.
• L'inserimento di segreti errati comporta lo stesso rischio di blocco di un accesso tramite password errata, e ogni scambio viene registrato nel registro di controllo.
• Una persona che gestisce gli account di servizio ma non è un amministratore può assegnare solo i ruoli che detiene personalmente, e mai il ruolo di Amministratore.

L'account del servizio di assistenza

Ogni implementazione include un account di servizio che non è stato necessario creare: support-desk@service.tranxact. Viene fornito dall'implementazione stessa tramite una chiave segreta impostata dal fornitore al momento dell'installazione, quindi nessuno nella tua azienda deve eseguire alcuna operazione per ricevere risposta ai ticket. Questo account detiene il ruolo di supporto tecnico in ogni azienda, che consente di leggere e rispondere ai ticket di supporto e ai relativi allegati, senza aprire alcun modulo o altra schermata. Viene indicato come "impostato dall'implementazione"; la revoca è una tua decisione e l'implementazione non la sovrascriverà.