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 Amministratore dal menu a tendina.
- Quindi selezionaAmministratore organizzazionedal menu a tendina.
- Nella pagina Amministrazione organizzazione, seleziona Sicurezzanel riquadro del menu a sinistra e quindi seleziona la scheda Provisioning.
- In Crea provider di identità o concessione API, fai clic su Aggiungi identità o API.
-
Seleziona API Grant nel menu a tendina.
Le seguenti istruzioni si riferiscono a una concessione API. Per un provider di identità, fare riferimento a Gestire e fornire utenti con SCIM.
- Inserisci le seguenti informazioni per la concessione API:
- In Nome cliente, inserisci un nome che ti aiuti a identificare questa sovvenzione.
- In Workspace, inserisci l'area di lavoro a cui sarà attribuita questa sovvenzione.
-
In Workiva Username, inserire il nome utente dell'utente che necessita dell'autorizzazione per l'API.
Solo questo utente può visualizzare il segreto di questa concessione 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 Fogli di calcolo, aggiungi Fogli di calcolo (lettura) e Fogli di calcolo (scrittura) in modo che 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.
- Fai clic su Aggiungi sovvenzione per terminare.
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:".