HelloID en SCIM koppelen

1. Maak de koppeling in PhishWise

1. Open Instellingen → Integraties.
2. Kies Directory-provisioning.
3. Selecteer HelloID als bronsysteem.
4. Kies Koppeling maken.
5. Kopieer de getoonde Tenant URL.
6. Kopieer het bearer-token direct naar een wachtwoordkluis.

Tenant URL

https://<host>/scim/v2/<connection-id>

Authenticatie

Authorization: Bearer <token>

Content-Type

application/scim+json

2. Maak het target system in HelloID

Gebruik een PowerShell v2-target system. De connector vertaalt de HelloID account lifecycle naar de REST-aanroepen van PhishWise.

1. Open in HelloID Provisioning → Target → Systems.
2. Voeg een PowerShell v2-systeem toe.
3. Geef het systeem een herkenbare naam, bijvoorbeeld PhishWise.
4. Maak configuratievelden voor de Tenant URL en het geheime token.
5. Configureer de accountvelden en lifecycle-scripts.
6. Laat het target system nog uitgeschakeld tot de mappings zijn getest.

Discovery-endpoints

De connector kan het ondersteunde contract vooraf uitlezen. Voeg de Tenant URL toe vóór ieder pad.

• /ServiceProviderConfig voor ondersteunde SCIM-functies.
• /ResourceTypes voor Users, Groups en OrganizationUnits.
• /Schemas voor velden en PhishWise-uitbreidingen.

Resource-endpoints

• /Users voor medewerkers, managers en plaatsingen.
• /Groups voor optionele doelgroepen.
• /OrganizationUnits voor de organisatiestructuur.

3. Map de organisatiestructuur

PhishWise gebruikt geen vaste reeks van bedrijf, afdeling en groep. Iedere laag is een OrganizationUnit met een eigen type en een optionele parent.

Waarden zoals company, division, project en klantspecifieke typen zijn ook toegestaan. De volgorde en het aantal lagen staan niet vast.

{
  "schemas": [
    "urn:phishwise:params:scim:schemas:core:2.0:OrganizationUnit"
  ],
  "externalId": "locatie-eindhoven",
  "displayName": "Locatie Eindhoven",
  "unitType": "location",
  "parentExternalId": "regio-zuid",
  "active": true
}

1. Maak eerst de hoofdlaag en daarna de onderliggende lagen aan.
2. Gebruik dezelfde vaste externalId bij iedere update.
3. Stuur bij verplaatsing de nieuwe parentExternalId.
4. Stuur active: false wanneer een organisatie-eenheid sluit.

4. Map medewerkers en managers

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User",
    "urn:phishwise:params:scim:schemas:extension:organization:2.0:User"
  ],
  "externalId": "employee-10042",
  "userName": "medewerker@example.org",
  "active": true,
  "name": {
    "givenName": "Samira",
    "familyName": "Jansen"
  },
  "title": "Zorgmedewerker",
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "employeeNumber": "10042",
    "manager": {
      "value": "employee-10001"
    }
  },
  "urn:phishwise:params:scim:schemas:extension:organization:2.0:User": {
    "organizationUnits": [
      {
        "externalId": "locatie-eindhoven",
        "primary": true,
        "positionTitle": "Zorgmedewerker"
      }
    ]
  }
}

5. Map groepen en rapportagetoegang

Organisatie-eenheden en groepen hebben verschillende doelen. Organisatie-eenheden vormen de hiërarchie. Groepen zijn dwarsdoorsneden voor campagnes, trainingen of onboarding.

Geef een manager read-only toegang door bij diens lidmaatschap accessLevel: "view" mee te sturen.

{
  "externalId": "employee-10001",
  "userName": "manager@example.org",
  "active": true,
  "name": {
    "givenName": "Milan",
    "familyName": "De Vries"
  },
  "title": "Regiomanager",
  "urn:phishwise:params:scim:schemas:extension:organization:2.0:User": {
    "organizationUnits": [
      {
        "externalId": "regio-zuid",
        "primary": true,
        "positionTitle": "Regiomanager",
        "accessLevel": "view"
      }
    ]
  }
}

6. Test Evaluation en Enforcement

1. Beperk de eerste business rule tot een kleine pilotgroep.
2. Voer een actuele Source import en snapshot uit.
3. Draai eerst Evaluation zonder wijzigingen toe te passen.
4. Controleer create-, update- en revoke-acties in het rapport.
5. Voer daarna Enforcement uit.
6. Controleer in PhishWise de synchronisatielog.
7. Log in als beheerder en controleer de drie pilotmedewerkers.
8. Log in als pilotmanager en controleer de afscherming.

• Iedere medewerker heeft één vaste externalId.
• De business unit, locatie en afdeling staan in de juiste volgorde.
• De managerrelatie wijst naar de juiste persoon.
• De manager ziet de eigen branch en niet de controlegroep erbuiten.
• Een tweede Enforcement maakt geen duplicaten.

7. Beheer uitdiensttreding en wijzigingen

Uitdiensttreding

Stuur active: false of verwijder de User via SCIM. PhishWise archiveert de medewerker, trekt directorytoegang in en bewaart historische leer- en campagneresultaten.

Verplaatsing naar een andere locatie

Werk de organizationUnits van de medewerker bij. Zet de nieuwe primaire plaatsing op primary: true. De oude door HelloID beheerde plaatsing verdwijnt.

Nieuwe manager

Stuur de nieuwe vaste manager-ID in manager.value. De functietitel mag gelijk blijven of wijzigen. Dat heeft geen invloed op de relatie.

Token vernieuwen

Kies in PhishWise Token vernieuwen als een geheim mogelijk is uitgelekt. Het oude token stopt direct. Werk de HelloID-configuratie bij voordat de volgende Enforcement start.

Wisselen van provider

Een overstap van HelloID naar Entra of een andere SCIM-bron is mogelijk. PhishWise roteert het token, trekt oude directorytoegang in en markeert de bestaande records voor veilige correlatie met de nieuwe bron.