06. Synctool Doel (Zivver)

Inleiding

Deze sectie beschrijft hoe je de SyncTool verbindt met jouw Zivver-organisatie en alle bestaande Zivver-accounts bekijkt. Deze functies zijn gegroepeerd onder het tabblad Target (Zivver) in de Synctool.

Verbind de Synctool met jouw Zivver-organisatie

Om de Synctool te verbinden met jouw Zivver-organisatie, maakt de Synctool via poort 443 verbinding met de Zivver API https://app.zivver.com/api/. Deze verbinding wordt geauthenticeerd met een API-key.

Klik op Test Connection om te testen of de Synctool verbinding kan maken met https://app.zivver.com/api/ via poort 443.

Als je nog geen API-key voor de Synctool hebt aangemaakt, volg dan de onderstaande stappen op.

  1. Ga naar de API-key pagina in het Zivver-beheerdersportaal.
  2. Klik op Nieuwe API key maken.
    De pop-up Voeg nieuwe API key toe verschijnt.
  3. Vul een naam in.
    Bijvoorbeeld: Synctool {admin e-mailadres}. Door je mailadres te noteren weet iedereen wie de sleutel heeft aangemaakt en met welk doel.
  4. Klik op Toevoegen.
    De API-key wordt getoond. Zorg ervoor dat je deze ergens veilig opslaat, want de API-key wordt slechts één keer getoond en is een krachtige sleutel.
  5. Kopieer de API-key content_copy Kopiëren.
  6. Plak de API-key in het API-key veld in de Synctool.
  7. Controleer de API-key op voor- of achtervoegende spaties.
Taalinstellingen
De API-key is gekoppeld aan de beheerder die de API-key heeft aangemaakt. Daarom krijgen persoonlijke Zivver-accounts (die met deze API-key zijn aangemaakt) dezelfde taalinstellingen als de beheerder die de API-key heeft aangemaakt. Voor een beheerder met Engelse taalinstellingen betekent dit dat de aangemaakte Zivver-accounts Engels als profieltaal krijgen. Je profieltaal zorgt er weer voor dat de taal van het notificatiebericht aan een ontvanger in het Engels zijn.
Controleer of wijzig jouw taalinstellingen hier
Beheerder uit dienst
Als een Zivver-beheerder wordt verwijderd, dan zijn de API-keys die deze beheerder heeft aangemaakt niet meer geldig. Als een Zivver-beheerder zijn account inactief is, dan zijn de API-keys die deze beheerder heeft aangemaakt nog wel te gebruiken. Controleer in dat geval of de desbetreffende API-keys toch verwijderd moeten worden.
Maak een nieuwe API-key aan

Hoe gebruikers inloggen in Zivver

Schakel Users log in via SSO in als jouw organisatie Single Sign-On gebruikt om gebruikers in te laten loggen bij Zivver.

Schakel Users log in via SSO uit als jouw organisatie geen Single Sign-On gebruikt om gebruikers in te laten loggen bij Zivver. Als Users log in via SSO niet is aangevinkt, dan worden gebruikers aangemaakt met een tijdelijk wachtwoord. Dit tijdelijke wachtwoord hebben de gebruikers nodig de eerste keer dat ze inloggen in Zivver. Hierna wijzigt de gebruiker het tijdelijke wachtwoord in een zelf gekozen wachtwoord.

Configureer Single Sign-On voordat je de Synctool uitvoert
Zorg ervoor dat Single Sign-On is ingericht voordat je de optie Users log in via SSO inschakelt.

Doelfilter

Met het doelfilter kun je filteren op een specifieke subset van jouw accounts in Zivver (d.w.z. het doel).

Het doelfilter kan een positief filter zijn dat alleen een subset van de bestaande Zivver-accounts opvraagt. Maar het kan ook een negatief filter zijn, dat bestaande Zivver-accounts uitsluit van synchronisatie.

Externe IT-leveranciers
Gebruik het doelfilter om te voorkomen dat beheerdersaccounts van externe IT-leveranciers worden opgeschort, of om accounts met een afwijkend domeinen uit te sluiten van synchronisatie.
  1. Selecteer Apply filter on users/groups.
  2. Selecteer bij Filter field het attribuut waarop je wilt filteren.
    Bijvoorbeeld: mailadres van de gebruiker.
  3. Voer bij Filter values de waarden in die overeenkomen met het attribuut dat je bij de vorige stap hebt gekozen.
    Bijvoorbeeld: john.doe@example.com. Voeg elk mailadres op een aparte regel toe als je meer adressen wilt toevoegen.
  4. Pas het toe als een positief of negatief filter.
    Als je een mailadres wilt uitsluiten van synchroniseren, laat dan Apply as positive filter uitgeschakeld. Vink Apply as positive filter aan als je een mailadres wilt meenemen bij het synchroniseren.

Bestaande Zivver-accounts

Het voorbeeld toont je alle huidige Zivver-accounts voor jouw Zivver-organisatie.

Als je een doelfilter toepast, dan worden accounts die in een negatief filter staan niet getoond in het voorbeeld.

Klik op Load the data now om een voorbeeld te krijgen.

Alle gebruikers en functionele accounts worden met hun eigenschappen weergegeven in het overzicht.

ERROR
You are not authorized to get Users from the Zivver-API. Did you enter the correct API-key?

Deze foutmelding betekent dat de API-key ontbreekt, onvolledig is, voor- of achtervoegende spaties heeft of is verlopen. Corrigeer de API-key of maak een nieuwe API-key aan.