Per accedere alle API di Workiva, gli utenti devono ottenere una concessione API per l'autorizzazione. In qualità di Amministratore della sicurezza dell'organizzazione, se crei una concessione API per un utente, potrai modificare i dettagli della concessione o cancellarla. Tuttavia, solo l'utente potrà visualizzare il segreto della sua concessione rigenerandola nel suo profilo utente.
Crea una concessione API
Per iniziare a creare una concessione API:
- In alto a destra, clicca sull'icona dell'utente e seleziona Amministratore organizzazione dal menu a tendina Amministratore.
- Seleziona Sicurezza e clicca sulla scheda Provisioning.
- Clicca su Aggiungi identità o API.
- Seleziona Concessione API nel menu a tendina.
- Inserisci le seguenti informazioni per la concessione API:
- Per Nome cliente, inserisci un nome che ti aiuti a identificare questa concessione.
- Per Workspace, inserisci il workspace a cui sarà attribuita questa concessione.
- Per Nome utente Workiva, inserisci il nome utente dell'utente che ha bisogno della concessione per l'API. Solo questo utente potrà visualizzare il segreto di questa concessione API in Il mio profilo > Sicurezza.
Nota: Per motivi di sicurezza, se in un secondo momento cambi il nome utente Workiva, il segreto attuale non sarà più valido e solo il nuovo utente avrà accesso al nuovo segreto.
- Per Scope, specifica le azioni che il sistema può intraprendere per conto dell'utente. Ad esempio, con l'API Fogli di calcolo, aggiungi Fogli di calcolo (Lettura) e Fogli di calcolo (Scrittura) in modo che l'utente possa accedere a e modificare i fogli di calcolo.
- Per Scadenza, imposta quando la concessione deve scadere, in base ai criteri e alle preferenze di sicurezza della tua organizzazione.
- Se necessario, inserisci un elenco di indirizzi IP separati da virgole nella lista Elenco dei permessi IP per la concessione.
- Clicca su Aggiungi concessione per concludere.
Gestisci le concessioni API
Puoi modificare i dettagli di una specifica concessione o cancellarla cliccando sulla rispettiva azione nel menu a tendina Azioni.
Visualizza il segreto della concessione API
Solo l'utente specificato nei dettagli della concessione API può visualizzare il segreto della propria concessione andando su Il mio profilo, selezionando la scheda Sicurezza e cliccando Rigenera nel menu a tendina Azioni accanto alla concessione. L'utente può visualizzare il segreto solo una volta, quindi dovrà copiare il segreto in un luogo sicuro. Se si perde il segreto, sarà necessario rigenerarlo di nuovo.
Nota: Il segreto inizia con "wk_secret:"