Dit artikel is voor:
- Organisatiebeveiligingsbeheerders
- Organisatiewerkruimtebeheerders
- Eigenaren van werkruimtes
Om toegang te krijgen tot de API's van Workiva, hebben gebruikers een API-toestemming nodig. Zodra je een API-machtiging voor een gebruiker hebt aangemaakt, kun je de details van de machtiging bewerken of de machtiging verwijderen. De gebruiker zelf kan echter alleen het geheim van zijn of haar machtiging bekijken door de machtiging opnieuw aan te maken in het gebruikersprofiel.
Maak een API-toestemming aan
Om een API-toekenning aan te maken:
- Ga in de werkruimte-instellingen naar het tabblad Beveiliging en selecteerAPI-toekenning maken.
- Voer de volgende gegevens in voor de API-toekenning:
-
- Voer bij Client Nameeen naam in waarmee u deze subsidie kunt identificeren.
- Voer bij Werkruimtede werkruimte in waaraan deze subsidie zal worden toegewezen.
-
Voer bij Workiva Gebruikersnaamde gebruikersnaam in van de gebruiker die de machtiging voor de API nodig heeft. Alleen deze gebruiker kan het geheim van deze API-toekenning bekijken in Mijn profiel > Beveiliging.
Opmerking: Om veiligheidsredenen wordt het huidige geheim ongeldig als u later de Workiva-gebruikersnaamwijzigt , en heeft alleen de nieuwe gebruiker toegang tot het nieuwe geheim.
-
Voor Scopes, specificeer de actie(s) die het systeem namens de gebruiker kan uitvoeren.
Opmerking: Voor meer informatie over scopes, zie onze API Grant Scopes begrijpen discussie.
Om organisatiescopes toe te wijzen (organization:read of organization:write), raadpleegt u API-machtigingen maken en beheren in Organisatiebeheer. - Voor Expireskunt u instellen wanneer de machtiging moet verlopen, op basis van het beveiligingsbeleid en de voorkeuren van uw organisatie.
- Voer indien nodig een door komma's gescheiden lijst met IP-adressen in bij de IP Allowlistvoor de toekenning.
-
- Klik op Subsidie toevoegen om te voltooien.
API-toekenningen beheren
Je kunt de details van een specifieke subsidie bewerken of de subsidie verwijderen door op de betreffende actie in het dropdownmenu Acties te klikken.
Bekijk het API-toekenningsgeheim
Alleen de gebruiker die is opgegeven in de details van de API-toekenning kan het geheim van zijn/haar toekenning bekijken door naar Mijn profielte gaan, het tabblad Beveiliging te selecteren en vervolgens op Opnieuw genereren te klikken in het vervolgkeuzemenu Acties naast de toekenning. De gebruiker kan het geheim slechts één keer bekijken, dus moet hij of zij het geheim op een veilige plek noteren. Als ze het geheim kwijtraken, moeten ze het opnieuw genereren.
Opmerking: Het geheim begint met "wk_secret:"