ServiceNow-gegevensconnector
Als u de ServiceNow CMDB-integratie wilt instellen, moet u de hostnaam van uw ServiceNow-exemplaar en geldige referenties opgeven. De connector verifieert met basisverificatie met behulp van gebruikersnaam en wachtwoord voor alleen-lezentoegang.
Opmerking
We raden u aan een toegewezen gebruiker te maken voor gebruik met gegevensconnectors in Exposure Management.
ServiceNow-configuratie
- Zoek de hostnaam van uw ServiceNow-exemplaar. Bijvoorbeeld 'contoso.service-now.com'.
- Een nieuwe ServiceNow-gebruiker maken:
- Volg de stappen hier om een nieuwe gebruiker te maken.
- Behoud de gebruikersnaam (gebruikers-id) en het wachtwoord die u hebt opgegeven voor toekomstig gebruik.
- Als er geen wachtwoordveld is, verzendt u het formulier om de gebruiker te maken. Wanneer u daarna de nieuwe gebruiker selecteert, ontvangt u de optie Wachtwoord instellen .
- Wanneer u de gebruiker maakt, schakelt u het selectievakje Alleen webservicetoegang in, zodat de gebruiker alleen voor deze integratie kan worden gebruikt.
- Wijs een cmdb_read rol toe aan de gebruiker die u hebt gemaakt. Gedetailleerde instructies vindt u hier.
Opmerking
De ServiceNow-connector ondersteunt alleen basisverificatie. OAuth-verificatie wordt op een later tijdstip beschikbaar gesteld.
ServiceNow-verbinding tot stand brengen in Exposure Management
Voer de volgende stappen uit om een verbinding tot stand te brengen met ServiceNow in Exposure Management:
- Open de gegevensconnectors in de navigatie van Exposure Management en selecteer Verbinding maken op de tegel ServiceNow CMDB.
- Voer de details en referenties van uw ServiceNow-exemplaar in (gemaakt in de ServiceNow-configuratie) en selecteer Verbinding maken.
Opgehaalde gegevens
Exposure Management haalt momenteel gegevens op op apparaten, hun zakelijke toepassingskoppeling en bedrijfskritiek. Er worden ook aanvullende gegevens opgehaald waarmee het apparaat kan worden geïdentificeerd, zoals netwerkadaptergegevens en besturingssysteemgegevens.
Alleen apparaten die de afgelopen 90 dagen actief waren, worden opgehaald op basis van het beoordelen van het veld 'sys_updated_on' in de ServiceNow CI.
De volgende velden worden opgenomen via de connector:
Categorie | Eigenschappen |
---|---|
Apparaten | -besturingssysteem - osVersion - osServicePack - cpuType -categorie - assetTag -virtueel - serviceNowCriticality - usedFor - networkAdapters (zie details hieronder) - lastLoggedOnUser - mostFrequentUser - sysClassName - uPrimaryBusinessApplication (zie details hieronder) |
Netwerkadapter | -naam - sysId - macAddress - ipAddress - ipDefaultGateway |
Zakelijke toepassing | - sysId -getal - uCriticaliteit - businessCriticality |
Problemen met de connector oplossen
Hier volgen enkele veelvoorkomende problemen die zich kunnen voordoen bij het configureren van de ServiceNow-connector en suggesties voor het oplossen hiervan.
Fouttype | Actie voor probleemoplossing |
---|---|
Foutbericht 'De naam van de externe server kan niet worden omgezet' | Controleer de hostnaam van het ServiceNow-exemplaar. Meer informatie over verificatie bij ServiceNow vindt u hier: Verificatie (servicenow.com) |
Foutcode 401: Autorisatiefout | Een autorisatiefout geeft aan dat referenties mogelijk niet juist zijn of dat er onvoldoende machtigingen zijn voor toegang tot de ServiceNow-gegevens. Controleer uw referenties en controleer of ze juist en geldig zijn. Controleer ook of uw referenties de vereiste machtigingen hebben. Zie de sectie ServiceNow-configuratie voor meer informatie over het toewijzen van de cmdb_read rol. Een andere mogelijke reden voor deze fout is dat uw ServiceNow-exemplaar is geconfigureerd om alleen verbindingen van een beperkt bereik van IP-adressen te accepteren. In dit geval raadpleegt u hier de richtlijnen voor het toevoegen van de juiste set IP-adressen aan uw acceptatielijst: IP-adressen op de acceptatielijst |
Foutcode 403: Fout toegang verboden | Deze fout geeft aan dat de opgegeven referenties niet over de benodigde machtigingen beschikken om de aangevraagde API's uit te voeren. Werk uw referenties bij met de juiste machtigingen zoals beschreven in de configuratiesectie en zorg ervoor dat er ten minste cmdb_read rol is toegewezen. |
Foutcode 404: Fout niet gevonden | Deze fout geeft aan dat het aangevraagde eindpunt niet bereikbaar is. Controleer of de hostnaam van uw ServiceNow-exemplaar juist is. |
Foutcode 429 'Te veel aanvragen' | Het systeem haalt periodiek gegevens op van de geconfigureerde externe providers, die mogelijk een limiet hebben voor het aantal gelijktijdige aanvragen. We raden u aan een toegewezen gebruiker of account voor de connector te maken om te voorkomen dat deze limiet wordt bereikt. |
Foutbericht over ongeldige URL | Deze fout geeft aan dat het aangevraagde eindpunt niet bereikbaar is. Controleer of de hostnaam van uw ServiceNow-exemplaar juist is. |
Fout 'Tijdelijk verbroken' of 'Tijdelijke fout' | In het geval dat dit foutbericht wordt weergegeven zonder aanvullende informatie, controleert u de connectorconfiguratie (hostnaam en referenties). Als deze geldig zijn en het probleem niet vanzelf wordt opgelost, neemt u contact op met de ondersteuning. |
Sommige ServiceNow CMDB-API's of -assets worden niet weergegeven in de opgenomen gegevens | Zie Opgehaalde gegevens voor een beschrijving van de gegevens die naar verwachting worden opgehaald door de ServiceNow CMDB-connector. Als er nog steeds gegevens ontbreken, neemt u contact op met ondersteuning. |
Er worden geen gegevens weergegeven die zijn opgenomen uit ServiceNow CMDB | Controleer de verbindingsstatus om er zeker van te zijn dat er geen fouten zijn. Controleer of er geldige vermeldingen in uw ServiceNow CMDB zijn die overeenkomen met de gegevens die we ophalen. Voer de voorbeeldquery Advanced Hunting uit om te controleren of er ServiceNow-assets kunnen worden gevonden in de Exposure Graph-tabellen. Als u uw ServiceNow CMDB-gegevens nog steeds niet kunt vinden, neemt u contact op met de ondersteuning. |
Toegestane IP-adressen van ServiceNow moeten worden geconfigureerd om Exposure Management-connectors toegang te geven tot ServiceNow | Lees hier hoe u de set IP-adressen toevoegt aan uw acceptatielijst: IP-adressen op de acceptatielijst |