Questo articolo ti mostrerà come configurare le identità API per il Dalux Build API.
Le identità API forniscono un modo per accedere al Dalux Build API con permessi specifici.
Creando un'Identità API, puoi specificare il livello di accesso al sistema, sia che si tratti di accesso a tutti i dati aziendali attraverso tutti i progetti, sia un accesso limitato a determinati gruppi su progetti particolari.
Se vuoi saperne di più sulle API di Dalux, leggi questo articolo: Dalux API.
Note
Le identità API sostituiranno l'attuale funzione delle chiavi API. Tutte le chiavi API attuali nel profilo dell'azienda scadranno dopo il 28 febbraio 2026.
Tutte le chiavi API dovranno essere sostituite con identità API prima di questa data.
Come impostare le identità API
Le identità API sono impostate nel profilo dell'azienda.
Permessi
Solo gli amministratori aziendali possono impostare, modificare o rimuovere le identità API.
Per creare un'identità API, vai a Profilo dell'azienda
Impostazioni
'Identità API'.
Nella finestra delle identità API, puoi creare nuove identità e gestire quelle esistenti.
Puoi creare più identità per gestire i livelli di accesso secondo necessità. Per impostare una nuova identità API, fai clic su Crea.
- Nome - Il nome dell'identità API visualizzato nell'interfaccia. Si consiglia di scegliere un nome che sia sia descrittivo che chiaro.
- Email - L'email inserita qui è responsabile della convalida dell'API tramite un'email di conferma
- Azienda - Il nome dell'azienda a cui l'identità API si riferisce (metadati)
- Permessi aziendali - Imposta questo permesso solo quando l'identità API deve avere accesso ai dati su tutti i tuoi progetti. I permessi aziendali corrispondono a quelli dei ruoli del profilo dell'azienda (Amministratore dell'azienda e Osservatore dell'azienda). Questo può essere modificato dopo che l'identità è stata creata.
- Descrizione - Una breve descrizione che include dettagli sull'identità API, come ambito di accesso, info di contatto o altri dati rilevanti.
Dopo aver fornito le informazioni necessarie e aver accettato i Termini e Condizioni dell'identità API, verrà inviata un'email di verifica all'indirizzo email fornito. Se necessario, l'email può essere reinviata. Non puoi generare una chiave API fino a quando l'identità non è stata verificata.
Dopo aver verificato l'identità API, puoi aggiungere impostazioni di progetto, che consentono un accesso più specifico al progetto. Questo passaggio è necessario solo se non hai scelto alcun accesso aziendale.
Clicca su 'Aggiungi progetto' per continuare. Quindi seleziona il progetto e aggiungi i gruppi di utenti.
I permessi dei gruppi di utenti selezionati controllano a cosa l'identità API ha accesso sul progetto.
Quando hai finito, clicca 'Aggiungere'.
Ora puoi aggiungere una chiave API all'identità API. Clicca su 'Aggiungi chiave API' per procedere. Quando si aggiunge una chiave API, è necessario specificare la durata della sua validità.
Ora verrà generata una chiave API. Copia la chiave e conferma che la chiave è stata copiata, quindi clicca 'OK'.
IMPORTANTE
La chiave API deve essere copiata e memorizzata. Non sarà possibile accedere alla chiave API dopo che la finestra è stata chiusa.
L'identità API può ora essere utilizzata con il Dalux Build API.