Questo articolo spiegherà come impostare le identità API in FM.
Utilizzare un'identità API consente un accesso granulare all'API di Dalux FM, utilizzando i ruoli utente esistenti e la logica di regione. Questo consente di limitare l'accesso API solo ai dati necessari.
Per saperne di più
Per ulteriori informazioni sulle API di Dalux, leggi questo articolo: Dalux API.
Come impostare le identità API
Informazioni Tecniche
Le identità API possono essere utilizzate per accedere all'API Dalux FM dalla versione 2.0.0 e successive.
Le identità API possono essere create e gestite solo dagli amministratori nell'istanza FM.
L'identità API non può utilizzare un'e-mail già associata a un utente registrato o invitato in Dalux FM. Allo stesso modo, un'e-mail per un'identità API non può essere usata per un utente Dalux FM.
Per creare un'identità API, vai su:
Impostazioni
Integrazioni
'Identità API':
Per creare una nuova identità API, clicca Aggiungi.
-
Tipo di identità - Hai due opzioni
- Generale - Accesso diretto ai dati nell'istanza FM
- Azienda - Accesso ai dati del fornitore esterno, configurato nelle impostazioni dell'azienda
- Nome - Nome dell'identità API (può essere modificato in seguito)
- Email - Email utilizzata per la comunicazione riguardante i servizi API Dalux e l'uso dell'identità API (non può essere cambiata una volta creata l'identità API)
- Amministratore - Sovrascrive le autorizzazioni di qualsiasi ruolo utente e dà accesso a tutti i dati. Per il tipo di identità 'Azienda', dà accesso da amministratore aziendale.
- Descrizione - Una descrizione opzionale per l'identità API per aiutarti e aiutare altri in seguito
Dopo aver compilato le informazioni richieste, letto e accettato i termini e le condizioni, fai clic su 'Crea' per continuare a configurare l'identità API.
Nota
Le chiavi API non vengono generate fino a quando non le aggiungi all'identità API successivamente nel processo.
Ora puoi assegnare ruoli utente e regioni all'identità API. Questi determinano quali dati sono accessibili tramite l'API. Ad esempio, non puoi accedere ai dati degli ordini di lavoro se i ruoli utente assegnati non hanno accesso agli ordini di lavoro.
Se l'identità API ha permessi da amministratore, sovrascrive qualsiasi permesso nei ruoli utente e dà accesso a tutti i dati.
Per aggiungere ruoli utente e regioni all'identità API, fai clic su 'Aggiungi' nell'area ruoli utente.
Puoi aggiungere ruoli utente separatamente oppure specificare anche una regione per il ruolo utente.
Una volta che hai aggiunto i tuoi ruoli utente, puoi iniziare a creare le chiavi API. Per creare chiavi API per l'identità API, fai clic su 'Aggiungi' nell'area chiavi API. Quando crei una chiave API, devi specificare il tempo di scadenza per la chiave.
Quando fai clic su 'Aggiungi', la chiave API verrà generata.
Copia la chiave e distribuiscila secondo i termini e le condizioni. L'identità API può ora usare la sua chiave API, limitata all'API specificata dall'accesso del ruolo utente.
Per saperne di più
Per ulteriori informazioni sulle API di Dalux, leggi questo articolo: Dalux API.