# Probleemoplossing

Tip

**Kom je een fout tegen die hier niet wordt vermeld?**

Neem gerust [contact met ons op](https://support.zivver.com/s/contactsupport?language=nl_NL) als de fout die je tegenkomt niet op deze pagina staat.

## De synchronisatie is niet uitgevoerd omdat de parameter perform_sync niet is ingesteld of het e-mailrapport meldt dat Cloud Sync in Preview-modus is uitgevoerd

**Oorzaak**:

Cloud Sync staat nog in Preview-modus, wat betekent dat er geen accounts naar Zivver worden gesynchroniseerd. Als de voorgestelde wijzigingen correct zijn, kun je Cloud Sync configureren om ze door te voeren.

**Stappen om geautomatiseerde synchronisaties op te lossen**:

1. Log in op [portal.azure.com](https://portal.azure.com/#home).
2. Typ **ZivverCloudSync** in de zoekbalk bovenaan en klik op het Automation Account.
3. Typ **Runbooks** in de zoekbalk links en klik op dit menu-item.
4. Open het runbook _ZivverCloudSyncLoader_.
5. Zoek naar **Planningen** en open de _ZivverCloudSyncSchedule_.
6. Controleer of de planning de parameter `perform_sync` bevat.
7. Als deze parameter ontbreekt, klik op **Ontkoppelen**.
8. Klik op **Een planning toevoegen**.
9. Selecteer de planning en voeg de parameter `perform_sync` toe.

## Er is een fout opgetreden bij het ophalen van SCIM-groepen 
**Oorzaak**:

Dit betekent dat Cloud Sync geen verbinding kan maken met Zivver met de opgegeven API-sleutel.

**Stappen om op te lossen**:

1. Log in op [portal.azure.com](https://portal.azure.com/#home).
2. Typ **ZivverCloudSync** in de zoekbalk bovenaan en klik op het Automation Account.
3. Typ **Variabelen** in de zoekbalk links en klik op dit menu-item.
4. Open de variabele _CLOUD_SYNC__ZIVVER_API_KEY_.
5. Klik op **Waarde bewerken**.
6. Plak een geldige [API-sleutel](https://app.zivver.com/admin/api-keys).
7. Klik op **Opslaan**.

## Account `voorbeeld@domein.com` wordt overgeslagen omdat het in het ene systeem een groep is en in het andere een gebruikersmailbox

**Oorzaak**:

Cloud Sync slaat dit account over tijdens de synchronisatie omdat er een verschil is tussen het accounttype in Exchange Online en het accounttype in Zivver. Een Exchange Online UserMailbox moet overeenkomen met een Zivver-gebruikersaccount. Een Exchange Online SharedMailbox moet overeenkomen met een functioneel account in Zivver. Je hoeft deze waarschuwing niet op te lossen als er een geldige reden is voor het verschil (bijv. een oude configuratie).

**Stappen om op te lossen**:

1. Ga als beheerder naar de [Zivver-accounts pagina](https://app.zivver.com/admin/accounts).
2. Zoek het account dat in het waarschuwingslog wordt genoemd en klik op  Beheren.
3. Wijzig het accounttype.

Waarschuwing

**Functionele accounts kunnen niet inloggen**

Als je het accounttype in Zivver wijzigt van gebruiker naar functioneel (equivalent aan een gedeelde mailbox in Exchange Online), is het niet langer mogelijk om direct op dit account in te loggen. Gebruikersaccounts die gemachtigd zijn voor dit account kunnen de berichten wel lezen.

## Kan EXO-mailboxen niet ophalen: Het V1AppOnly-token bevat niet de machtigingen die vereist zijn door de doel-API

**Oorzaak**:

Dit betekent dat de Managed Identity die overeenkomt met het Automation Account niet over de vereiste machtigingen beschikt.

**Stappen om op te lossen**:

1. Zie [02. Vereisten en installatie](https://docs.zivver.com/nl/admin/cloudsync/setup.html) voor instructies over hoe je de juiste machtigingen toewijst.
2. Zie [04. Veelgestelde vragen](https://docs.zivver.com/nl/admin/cloudsync/faq.html) voor instructies over hoe je de machtigingen controleert in de Azure-portal.

## Kan gebruiker niet aanmaken: Account bevindt zich buiten de organisatie

**Oorzaak 1**:

Dit kan betekenen dat dit e-mailadres al bestaat buiten je Zivver-organisatie. In dat geval vind je het account _niet_ op de [Accounts-pagina](https://app.zivver.com/organization/accounts) wanneer je zoekt op het e-mailadres. Als je het account wel vindt, ga dan naar _Oorzaak 2_ hieronder.

**Stappen om op te lossen**:

1. Ga naar de [Domeinen-pagina](https://app.zivver.com/organization/domains).
2. [Neem gratis accounts over](https://docs.zivver.com/nl/admin/webapp/references/adopt-accounts.html).

**Oorzaak 2**:

Dit kan betekenen dat dit e-mailadres behoort tot een domein dat niet is geclaimd door je organisatie.

**Stappen om op te lossen**:

1. Ga naar de [Domeinen-pagina](https://app.zivver.com/organization/domains).
2. [Claim het domein](https://docs.zivver.com/nl/admin/webapp/references/how-to-claim-a-domain.html).

## Kan gebruiker niet bijwerken. Fout bij het aanmaken van alias: Alias is een gast

Zie [dit artikel](https://docs.zivver.com/nl/admin/synctool-troubleshooting/alias-error-after-sync.html).

## Account niet gevonden in SCIM-ID’s. Kan niet worden bijgewerkt.

**Oorzaak**:

Dit betekent dat Cloud Sync geen actie kan uitvoeren op dit account omdat het account eerder in de flow niet kon worden aangemaakt.

**Stappen om op te lossen**:

1. Zoek naar andere waarschuwingen of fouten in het logbestand die betrekking hebben op dit account.
2. Los de bijbehorende fouten op.

## Kan e-mail niet verzenden. Geblokkeerd door tenant-geconfigureerde AppOnly AccessPolicy-instelling

**Oorzaak**:

Dit betekent dat de verzendmailbox van het e-mailrapport geen e-mails mag verzenden vanwege het [machtigingenbeleid](https://learn.microsoft.com/en-us/graph/auth-limit-mailbox-access).

**Stappen om op te lossen**:

1. Zie [Vereisten en installatie](https://docs.zivver.com/nl/admin/cloudsync/setup.html) voor instructies over hoe je een beleid instelt voor het e-mailrapport. Zorg ervoor dat het verzendmailadres overeenkomt met het mailadres in de variabele _CLOUD_SYNC__EMAIL_REPORT_SENDER_.

Waarschuwing

**Het kan meer dan 1 uur duren voordat het nieuwe beleid van kracht is**

Het kan meer dan 1 uur duren voordat het nieuwe beleid van toepassing is op het verzenden van e-mails vanuit Cloud Sync.

## Kan e-mail niet verzenden. Geblokkeerd door tenant-geconfigureerde AppOnly AccessPolicy-instelling

**Oorzaak**:

Dit betekent dat de Mail.Send Graph API-machtigingen niet correct zijn ingesteld voor de Managed Identity.

**Stappen om op te lossen**:

1. Zie [Vereisten en installatie](https://docs.zivver.com/nl/admin/cloudsync/setup.html) voor instructies over hoe je de Mail.Send Graph API-machtigingen instelt.
2. Bekijk de momenteel toegewezen API-machtigingen door in de Azure Portal naar **Enterprise Applications** te navigeren. Filter hier op Managed Identities, selecteer **ZivverCloudSync**, en controleer of de Mail.Send-machtiging verschijnt onder **Permissions**.

## Er wordt geen e-mailrapport verzonden. CLOUD_SYNC__EMAIL_REPORT_SENDER of CLOUD_SYNC__EMAIL_REPORT_RECIPIENTS variabelen zijn niet ingesteld

**Oorzaak**:

Dit betekent dat het e-mailrapport niet is verzonden omdat de verzender en/of ontvangers niet correct zijn opgegeven.

**Stappen om op te lossen**:

1. Navigeer in de Azure Portal naar het _ZivverCloudSync_ Automation Account.
2. Navigeer naar **Variabelen**.
3. Controleer of de variabelen _CLOUD_SYNC__EMAIL_REPORT_SENDER_ en _CLOUD_SYNC__EMAIL_REPORT_RECIPIENTS_ bestaan en dat elke variabele ten minste één e-mailadres bevat.

## Cloud Sync werd gestopt omdat de drempel voor grote wijzigingen werd overschreden

**Oorzaak**:

Dit betekent dat de synchronisatie niet is uitgevoerd omdat meer dan 10% van de accounts aangemaakt, bijgewerkt of gedeactiveerd zou worden. De 10%-drempel fungeert als een veiligheidsmechanisme om onbedoelde grootschalige wijzigingen te voorkomen.

**Stappen om op te lossen**:

1. Navigeer in de Azure Portal naar het _ZivverCloudSync_ Automation Account.
2. Navigeer naar **Runbooks**.
3. Open het runbook _ZivverCloudSyncLoader_.
4. Klik op **Start**.
5. Voer bij de parameters de parameter `allow_large_sync` in.
6. Klik op **OK**.

Laatst bijgewerkt op 2026-06-18