Denna artikel är avsedd för:
- Org Säkerhetsadministratörer
Skapa ett beviljande av API
För åtkomst till alla Workiva API:er behöver användare ett API beviljande för auktorisering. När du som Org Security Admin skapar ett API-bidrag för en användare kan du redigera bidragets detaljer eller ta bort bidraget. Det är dock bara användaren som kan se hemligheten bakom sitt beviljande genom att återskapa det i sin användarprofil.
För att börja skapa ett API beviljande:
- Klicka på användarikonen uppe till höger och välj Admin i rullgardinsmenyn.
- Välj sedanOrganisationsadministratöri rullgardinsmenyn.
- På sidan Organisationsadministration väljer du Säkerheti den vänstra menyrutan och väljer sedan fliken Provisionering.
- Under Skapa identitetsleverantör eller API-tilldelningklickar du på Lägg till identitet eller API.
-
Välj API-tilldelning i rullgardinsmenyn.
Följande instruktioner gäller för ett API-bidrag. För en identitetsleverantör, se Hantera och etablera användare med SCIM.
- Ange följande information för API-bidraget:
- I Klientnamnanger du ett namn som hjälper dig att identifiera detta bidrag.
- I Arbetsytaanger du den arbetsyta som detta bidrag ska tillskrivas.
-
I Workiva Användarnamnanger du användarnamnet för den användare som behöver tillståndet för API:et.
Endast den här användaren kan se hemligheten för detta API-bidrag i Min profil > Säkerhet.Obs: Av säkerhetsskäl ogiltigförklaras den nuvarande hemligheten om du ändrar Workiva-användarnamnet och endast det nya användarnamnet kommer att ha åtkomst till den nya hemligheten
- I Scopesanger du den/de åtgärder systemet kan vidta å användarens vägnar.
För Spreadsheets API, lägg till Spreadsheets (Läs) och Spreadsheets (Skriv) så att användaren kan komma åt och redigera kalkylblad. - I Expiresanger du när beviljandet ska upphöra att gälla, baserat på din organisations säkerhetspolicyer och inställningar.
- (Valfritt) Ange en kommaseparerad lista med IP-adresser i IP-tillåtelselista för beviljandet.
- Klicka på Lägg till bidrag för att avsluta.
Hantera beviljande av API
Du kan redigera informationen om ett specifikt bidrag eller ta bort ett bidrag genom att klicka på respektive åtgärd i rullgardinsmenyn Åtgärder för det bidraget.
Visa hemlighet för beviljande av API
För att visa API-hemligheten,
- Klicka på användarikonen uppe till höger och välj Min profili rullgardinsmenyn.
- Klicka på fliken Säkerhet.
- Leta reda på det API-tillstånd som du vill ha hemligheten för.
- Klicka på Återskapa i rullgardinsmenyn Åtgärder bredvid bidraget.
Viktiga anmärkningar
- Endast den användare som anges i API-tillståndets detaljer kan se sitt tilldelnings hemlighet.
- Du kan bara se hemligheten en gång, så du måste kopiera ner hemligheten på en säker plats.
Om du förlorar hemligheten måste du skapa den på nytt och sedan fylla i alla platser som behöver den med den nya hemligheten. - Tips: Hemligheten börjar med "wk_secret:"