Diligent One-toegangstokens aanmaken en beheren

Maak of beheer uw persoonlijke Diligent One-toegangstokens op de pagina API-tokens beheren die beschikbaar is via uw Launchpad-profielpagina.

Wat is een toegangstoken?

Een toegangstoken is een tekenreeks waarmee een gebruiker wordt geïdentificeerd en toegang tot andere toepassingen wordt geauthenticeerd.

Het vereiste toegangstoken is afhankelijk van wat u moet doen:

• Diligent One Projecten-gegevens importeren in Analytics — Analytics- of HighBond API-token
• Diligent One Resultaten-gegevens importeren in Analytics — Analytics- of HighBond API-token
• Diligent One Resultaten-gegevens exporteren vanuit Analytics — Analytics- of HighBond API-token
• Krijg programmeringstoegang tot Diligent One: HighBond API-token
• Krijg programmeringstoegang tot Launchpad-activiteitslogboeken — Activiteitslogboeken API-token

  Opmerking

  Toegang tot Launchpad-activiteitslogboeken is alleen beschikbaar voor systeembeheerders.

Analytics-token

Het Analytics-token wordt elke keer dat u Analytics activeert automatisch gegenereerd en wordt opgeslagen in uw register.

• Als u Analytics 14 of eerder gebruikt en u handmatig een ACLGRC-toegangstoken maakt, wordt het token in Launchpad ingedeeld als een Analytics-tokentype.
• Als u Analytics 14.1 gebruikt en u handmatig een Diligent One-toegangstoken maakt, wordt het token in Launchpad ingedeeld als een Analytics-tokentype.

Hoe het werkt

In Launchpad worden op de pagina API-tokens beheren alle toegangstokens weergegeven die u hebt gegenereerd.

U kunt de pagina API-tokens beheren gebruiken voor het volgende:

• uw tokens kopiëren
• een label opgeven om tokens te beschrijven of te identificeren
• toegangstokens vergrendelen om te voorkomen dat ze worden gewijzigd of verwijderd
• toegangstokens verwijderen

Machtigingen

Elke gebruiker kan een Analytics-token maken. U moet een systeembeheerder in minimaal één Diligent One-exemplaar zijn om een HighBond API-token of een Activiteitenlogboek API-token te maken.

Alle gebruikers kunnen hun eigen toegangstokens beheren.

Toegangstokens maken

1. Open Launchpad.

Opmerking

Als uw bedrijf meer dan één exemplaar gebruikt in Diligent One, zorg er dan voor dat het juiste exemplaar actief is.

2. Selecteer > Profiel.
3. Klik naast Toepassingstokens op Beheren. De pagina API-tokens beheren wordt geopend.
4. Klik op +Token toevoegen en selecteer de juiste optie uit het vervolgkeuzemenu (bijvoorbeeld HighBond API, Analytics of Activiteitenlogboeken API). Een zijpaneel Nieuw token wordt weergegeven.
5. Vul de velden in het zijpaneel in om een token te maken.

   Opmerking

   Alle velden zijn verplicht om een token te maken, inclusief het veld Beschrijving. De enige uitzondering is als u ervoor kiest om geen tokenvervaldatum op te nemen. In dat geval hoeft u het aantal dagen waarna een token komt te vervallen niet in te voeren, omdat de standaardinstelling dan Nooit is.

   1. Voer een beschrijving in.

      Tip

      Neem in de beschrijving alle plekken op waar dit token wordt gebruikt en het doeleinde ervan. De reden hiervoor is dat tokens moeten worden vervangen wanneer ze vervallen en als u een gedetailleerde beschrijving toevoegt, bespaart u tijd en inspanning wanneer deze moeten worden vervangen.

   2. Optioneel. Schakel het vervallen van tokens in of uit.

      Opmerking

      De mogelijkheid om het vervallen van tokens in te stellen, moet standaard zijn ingeschakeld. Als dit is ingeschakeld, vervalt het token nooit.

   3. Voer het aantal dagen in waarna het token moet vervallen, met maximaal één jaar (365 dagen) na de aanmaakdatum van het token.
   4. Voer het wachtwoord van uw Diligent One-account in om uw identiteit te verifiëren.
6. Klik op Token genereren. Het zijpaneel wordt vernieuwd met een bevestigingsbericht dat het token is gegenereerd en bevat de Token-ID, de vervaldatum (de datum en tijd waarop het token vervalt) en de Beschrijving.
7. Klik op Kopiëren. Een bericht Gekopieerd naar klembord bevestigt dat het token is gekopieerd.

   Let op

   Sla uw token op voordat u het zijpaneel sluit. Als veiligheidsmaatregel is dit uw enige kans om er toegang toe te krijgen. Als u uw token niet opslaan en dit vergeet, moet u een nieuwe maken.
8. Klik op Sluiten. Het zijpaneel Nieuw token wordt gesloten.
9. Plak het token in een toepassing of een script.

   Opmerking

   Behandel het token als een wachtwoord en deel dit niet met andere mensen.

API-tokens beheren

Op de pagina API-tokens beheren ziet u een lijst van bestaande tokens, bewerkt u tokenbeschrijvingen, vergrendelt u tokens zodat ze niet kunnen worden bewerkt of verwijderd, en kunt u tokens verwijderen.

1. Open Launchpad.

Opmerking

Als uw bedrijf meer dan één exemplaar gebruikt in Diligent One, zorg er dan voor dat het juiste exemplaar actief is.

2. Selecteer  > Profiel.
3. Klik naast Toepassingstokens op Beheren. De pagina API-tokens beheren wordt geopend.
4. Voer een van de volgende acties uit.

Toegangstokens beoordelen

Als u tokens wilt zoeken, kunt u zoeken, sorteren en filteren om specifieke tokens te vinden. Voer een van de volgende handelingen uit:

• Tokens zoeken: voer de eerste paar tekens van het toegangstoken (maximaal zeven tekens) in de zoekbalk in. Hiermee wordt een verfijnde lijst met resultaten geretourneerd.
• Tokens sorteren: klik op een van de kolomkoppen om tokens in oplopende of aflopende volgorde te sorteren op de gekozen kolom.
• Tokens filteren: standaard worden alle gegenereerde tokens weergegeven. U kunt echter de lijst met tokens filteren op een subset zoals op de vergrendeling van een token of op het tokentype: Analytics, Activiteitslogboeken of HighBond API. Selecteer uw gewenste filters in de beschikbare vervolgkeuzemenu's om de lijst met tokens te filteren. Klik op Wissen om alle filters te verwijderen.

De beschrijving van een toegangstoken bewerken

1. Klik op het potlood . Het veld Beschrijving wordt inline bewerkbaar.
2. Werk de beschrijving bij en klik op het vinkje om wijzigingen op te slaan. De bijgewerkte beschrijving wordt weergegeven in de tabel.

Toegangstokens vergrendelen of ontgrendelen

Als u wilt voorkomen dat tokens worden verwijderd en dat tokenbeschrijvingen worden bewerkt, kunt u ze vergrendelen. U kunt tokens ook ontgrendelen om beschrijvingen te wijzigen en verwijderen mogelijk te maken.

• Klik op het open slotje naast uw token om te voorkomen dat tokens worden verwijderd en beschrijvingen worden bewerkt. Het slotje wordt gesloten weergegeven om aan te geven dat het token niet kan worden bewerkt of verwijderd. Het potlood en de prullenmand verdwijnen ook.
• Klik op het gesloten slotje om het token te ontgrendelen zodat tokens kunnen worden verwijderd en beschrijvingen kunnen worden bewerkt. Het slotje wordt open weergegeven om aan te geven dat bewerken en verwijderen is ingeschakeld. Het potlood en de prullenmand worden ook weer weergegeven.

Toegangstokens verwijderen

U kunt enkele tokens verwijderen, meerdere tokens tegelijkertijd verwijderen of alle tokens in de lijst verwijderen. Als u vorige tokens niet ter referentie hoeft te bewaren, kunt u ze verwijderen om de lijst met tokens overzichtelijk te houden. Elke beslissing om tokens te verwijderen moet echter voorzichtig worden genomen en alleen wanneer is bevestigd dat het token nergens meer in gebruik is, omdat verwijdering permanent is en niet ongedaan kan worden gemaakt.

Een enkel token verwijderen

1. Klik op de prullenmand naast het token. Een dialoogvenster # token verwijderen? wordt weergegeven waarmee u het verwijderen kunt bevestigen.
2. Klik op Token verwijderen. Het token wordt permanent verwijderd en uit de lijst gehaald.

Let op

Het verwijderen van een token is permanent en kan niet ongedaan worden gemaakt. Als een token in gebruik is wanneer het wordt verwijderd, mislukken alle processen die er gebruik van maken. Als een token onbedoeld wordt verwijderd, moet dit opnieuw worden gemaakt en opnieuw worden geïntroduceerd in de betreffende toepassing of het betreffende script.

Meerdere tokens verwijderen

1. Klik op de selectievakjes naast de tokens die u wilt verwijderen. Er verschijnt een rode knop boven de lijst met tokens die aangeeft hoeveel tokens moeten worden verwijderd.
2. Klik op # tokens verwijderen. Een dialoogvenster # token verwijderen? wordt weergegeven waarmee u het verwijderen kunt bevestigen.
3. Klik op Tokens verwijderen. De tokens worden permanent verwijderd en uit de lijst gehaald.

Let op

Het verwijderen van een token is permanent en kan niet ongedaan worden gemaakt. Als een token in gebruik is wanneer het wordt verwijderd, mislukken alle processen die er gebruik van maken. Als een token onbedoeld wordt verwijderd, moet dit opnieuw worden gemaakt en opnieuw worden geïntroduceerd in de betreffende toepassing of het betreffende script.

Alle tokens verwijderen

1. Schakel het selectievakje naast het informatiepictogram in. Hiermee worden automatisch alle tokens in de lijst geselecteerd en er verschijnt een rode knop boven de lijst met tokens die aangeeft hoeveel tokens moeten worden verwijderd.
2. Klik op # tokens verwijderen. Een dialoogvenster # tokens verwijderen? wordt weergegeven waarmee u het verwijderen kunt bevestigen.
3. Klik op # tokens verwijderd. De tokens worden permanent verwijderd en uit de lijst gehaald.

Let op

Het verwijderen van een token is permanent en kan niet ongedaan worden gemaakt. Als een token in gebruik is wanneer het wordt verwijderd, mislukken alle processen die er gebruik van maken. Als een token onbedoeld wordt verwijderd, moet dit opnieuw worden gemaakt en opnieuw worden geïntroduceerd in de betreffende toepassing of het betreffende script.

Vervallende tokens aanpakken

Er worden verschillende herinneringen verzonden totdat het token wordt verwijderd of vervalt. Makers van tokens krijgen 30 dagen, 5 dagen en 1 dag voor de vervaldatum van een token e-mailmeldingen. Er wordt ook een e-mailmelding verzonden zodra het token is vervallen. Zodra een token vervalt, mislukken alle processen die afhankelijk zijn van dit token, tenzij u dit vervallen token vervangt door een nieuw token.

Een vervallen token vervangen door een nieuw token

Om te voorkomen dat processen mislukken, moeten vervallende en vervallen tokens worden vervangen door nieuwe tokens. U moet een nieuw token maken om een token bij te werken. Zie Toegangstokens maken. Zodra een nieuw token is gemaakt, zoekt u alle exemplaren die het vervallende token gebruiken en vervangt u het vervallende token met het nieuw gemaakte token.

Een vervallend token verwijderen

Verwijder een vervallend token om geen meldingen meer te ontvangen over een aanstaande vervaldatum en om tokens die u niet meer nodig hebt te verwijderen. Zie Toegangstokens verwijderen.