Troubleshoot Integrations - Administrator Guide - 8 - Cortex XSOAR - Cortex - Security Operations

Cortex XSOAR Cloud Documentation

Product
Cortex XSOAR
Version
8
Creation date
2024-03-07
Last date published
2025-01-15
Category
Administrator Guide
Solution
Cloud
Abstract

Learn how to troubleshoot your integration in Cortex XSOAR.

When troubleshooting integrations, do the following:

  • Use the Test button in the integration instance.

  • Verify the integration settings. Check settings such as usernames, URLs, and passwords.

  • Download the debug log file and review its contents.

    In the following example, you receive a 401 unauthorized error code after testing the integration.

    integration-error.png

    Click Run Test & Download Debug log, to download the debug file locally. You can verify what server the URL request is being forwarded to and any other reasons as to why you received this error code. The 401 unauthorized error code usually relates to invalid error credentials, expired tokens, or incorrect API settings.

  • Enable verbose or debug-level logging on the integration.

  • Review the integration logs (Settings & InfoSettingsIntegrationsIntegration Logs).

    You can sort the logs by things such as source instance, command, and log level. You can also export the file

If you are unable to fix the integration, contact Customer Support for further assistance.