Questo articolo è per:
- Amministratori della sicurezza dell'organizzazione
Crea una concessione API
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.
Per iniziare a creare una concessione API:
- In alto a destra, fai clic sull'icona utente e seleziona Admin dal menu a discesa.
- Quindi seleziona Amministratore organizzazione nel menu a tendina.
- Nella pagina Amministratore organizzazione, seleziona Gestione identità e accessi > Identità > Provisioning.
- In Crea provider di identità o Concessione API, clicca su Aggiungi identità o API.
-
Seleziona Concessione API nel menu a tendina.
Le seguenti istruzioni sono per una Concessione API. Per un Provider di identità, fai riferimento a
Gestire e fornire utenti con SCIM. - Inserisci le seguenti informazioni per la concessione API:
- In Client Name, inserisci un nome che ti aiuterà a identificare questa concessione.
- In Workspace, inserisci l'area di lavoro a cui sarà attribuita questa sovvenzione.
-
In Workiva Username, inserisci il nome utente dell'utente che ha bisogno della sovvenzione per l'API.
Solo questo utente è in grado di visualizzare il segreto di questo grant API in Il mio profilo > Sicurezza.Nota: per motivi di sicurezza, la modifica del nome utente Workiva invalida il segreto corrente e solo il nuovo nome utente avrà accesso al nuovo segreto.
- In Scopes, specifica le azioni che il sistema può compiere per conto dell'utente.
Ad esempio, per l'API Spreadsheets, aggiungi Spreadsheets (Read) e Spreadsheets (Write) affinché l'utente possa accedere e modificare i fogli di calcolo. - In Expires, imposta la data di scadenza del finanziamento in base alle politiche e alle preferenze di sicurezza della tua organizzazione.
- (Facoltativo) Inserisci un elenco separato da virgole di indirizzi IP nella IP Allowlist per il sussidio.
- Clicca su Aggiungi concessione per concludere.
Gestisci le concessioni API
Puoi modificare i dettagli di una specifica sovvenzione o eliminare una sovvenzione facendo clic sull'azione corrispondente nel menu a tendina Actions per quella sovvenzione.
Visualizza il segreto della concessione API
Per visualizzare il segreto API,
- In alto a destra, clicca sull'icona dell'utente e seleziona Il mio profilo dal menu a tendina.
- Clicca sulla scheda Security.
- Individua il sussidio API per il quale vuoi ottenere il segreto.
- Clicca su Rigenerare nel menu a tendina Azioni accanto al sussidio.
Note importanti
- Solo l'utente specificato nei dettagli della sovvenzione API può visualizzare il segreto della propria sovvenzione.
- Puoi visualizzare il segreto solo una volta, quindi dovrai copiare il segreto in un luogo sicuro.
Se perdi il segreto, dovrai rigenerare il segreto e poi inserire il nuovo segreto in tutti i luoghi che lo richiedono. - Suggerimento: Il segreto inizia con "wk_secret:".