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, fare clic sull'icona dell'utente e selezionare Admin dal menu a tendina.
- Quindi selezionare Organization admin dal menu a tendina.
- Nella pagina Organization Admin, selezionare Security nel riquadro del menu a sinistra e quindi selezionare la scheda Provisioning.
- In Create Identity Provider or API Grant, fare clic su Add Identity or API.
-
Selezionare API Grant nel menu a tendina.
Le seguenti istruzioni riguardano una sovvenzione API. Per un Identity Provider, fare riferimento a Gestire e fornire utenti con SCIM.
- Inserisci le seguenti informazioni per la concessione API:
- In Nome del cliente, inserite un nome che vi 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 del grant 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 di 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, aggiungere Spreadsheets (Read) e Spreadsheets (Write) 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.
- Fare clic su Add Grant 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:".