ServiceNow-integratie
OpenFactory bevat standaard uitgeschakelde ServiceNow-integratiemodules voor Change Management, CMDB, Incident Management, Event Management en GRC-evidentielevering. Elke module en elke automatische hook moet expliciet worden ingeschakeld.
Dit is een operatorintegratie, geen imagefeature. Het toevoegen van de servicenow build feature gaat over software in een image en configureert niet de control-plane-integratie die hier wordt beschreven.
Vereisten
- een goedgekeurde ServiceNow-instance en OAuth-client;
- een dedicated service account/application met least privilege;
- uitgaande netwerktoegang beperkt tot de verwachte instance;
- een expliciete mapping van tabellen, velden, states, assignment en ownership;
- een stabiele platform-settings-encryptiesleutel; en
- een niet-productie ServiceNow-omgeving voor acceptatietests.
Het client secret is Fernet-encrypted in opgeslagen platform settings en ontbreekt in normale responses. Als de platform-encryptiesleutel wijzigt of verloren gaat, kan het opgeslagen secret niet worden gedecrypt en moet het worden vervangen.
In lagen configureren
- Configureer de instance-URL, client ID en secret via de admin integration settings.
- Voer de integration health check uit en bewaar elk individueel checkresultaat.
- Schakel één module in zonder automatic hooks.
- Test het manual endpoint tegen een testrecord.
- Controleer het resulterende ServiceNow-record, OpenFactory-koppeling, idempotentie en foutgedrag.
- Schakel één automatic hook in en herhaal de test.
Schakel nooit elke hook in als eerste integratietest.
Modules
| Module | Huidig oppervlak | Belangrijke grens |
|---|---|---|
| Change Management | Handmatige change request-aanmaak/status refresh, polling of webhook approval updates, live-deploy gate | Een gekoppeld request betekent niet dat een approval is ontvangen; map states en rejection-gedrag expliciet. |
| CMDB | Handmatige machine sync/retire plus fleet snapshots en diffs | Een geslaagde API write bewijst geen CI reconciliation of volledigheid van relaties. |
| Incident Management | Handmatige incidents en optionele drift-, attestation- of CVE-hooks; begrensde feedback actions | Inkomende webhooks moeten worden geauthenticeerd en elke action afzonderlijk geautoriseerd. |
| Event Management | Gebufferde/handmatige event delivery en geselecteerde build/live-state hooks | Buffers zijn geen gegarandeerd audit log; monitor delivery, verlies, duplicaten en retry-gedrag. |
| GRC | Build test/attestation evidence push met configureerbare mapping | Technische resultaten zijn evidence, geen automatische control of compliance-conclusie. |
Alle module-instellingen en operationele endpoints zijn administrator surfaces, tenzij een endpoint een smaller internal consumer documenteert.
Approval safety
Voordat u ServiceNow gebruikt om deployment te gaten, test:
- approved, rejected, canceled, expired, unknown en unreachable states;
- dubbele webhooks en out-of-order updates;
- HMAC-validatie waar geconfigureerd;
- polling recovery na gemiste webhooks;
- fail-closed gedrag wanneer policy approval vereist; en
- een operator recovery path die de accountable beslissing niet stil omzeilt.
Bewaar de OpenFactory build/deploy ID en ServiceNow sys_id/number samen.
Operationeel bewijs
Monitor de integration health endpoint, module-specifieke recent status, background task logs, buffer depth, failed deliveries, stale lifecycle findings en secrets/key rotation. Een groene connection test bewijst alleen de checks die op dat moment zijn uitgevoerd.
Gebruik een sandbox instance en synthetische records voor acceptatie. Bespreek de exacte ServiceNow ACLs, business rules, data residency, retention en licensing met de instance owner vóór productie-inschakeling.