{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":44062,"path":"security-management/install-cisco-ai-defense-integration.md","title":"Install the Vulnerability Response Integration with Cisco AI Defense","bundle":null,"doc_type":null,"release":"australia","body":"\n# Install the Vulnerability Response Integration with Cisco AI Defense\n\nInstall and configure the ServiceNow AI Platform Integration with Cisco AI Defense application in your ServiceNow AI Platform® instance to import scan results and model validation data from Cisco AI Defense.\n\n## Before you begin\n\nIf you have not already downloaded it onto your instance, visit the ServiceNow Store and locate the **Cisco AI Defense Integration for AI Security Exposure Management** application and download it onto your ServiceNow AI Platform® instance.\n\nObtain the following information from Cisco AI Defense before you configure the connection:\n\n-   Integration instance \\(name\\)\n-   API URL - Provided by Cisco for example - https://api.ciscoaidefense.com\n-   Tenant API key — authentication key provided by Cisco\n\nRole required: admin.\n\nThe admin assigns the following ServiceNow AI Platform roles for this integration:\n\n-   Role required: admin for installation and activation of the application.\n-   The admin assigns the following ServiceNow AI Platform roles for this integration:\n    -   sn\\_vul\\_cisco\\_ai\\_df.admin — Full access to manage integrations and read the AI security data.\n    -   sn\\_vul\\_cisco\\_ai\\_df.read — Read-only access to view AI security data and integrations.\n\n## Procedure\n\n1.  Install the Vulnerability Response Integration with Cisco AI Defense \\[app-vul-cisco-ai-defense\\] application you downloaded from the ServiceNow Store.\n\n    1.  Navigate to **All** > **System Applications** > **All Available Applications** > **All**.\n\n    2.  Locate the **Cisco AI Defense Integration for AI Security Exposure Management** application and select **Install**.\n\n        A dialog box appears after the application is installed.\n\n2.  Navigate to **All** > **Cisco AI Defense Integration** > **Administration** > **Configuration**.\n\n3.  Complete the configuration fields.\n\n    |Field|Description|Example|\n    |-----|-----------|-------|\n    |Integration Instance|Name for your Cisco AI Defense Integration instance|Name for your Cisco AI Defense Integration|\n    |API URL|Your Cisco AI Defense API endpoint|For example, https://api.ciscoaidefense.com|\n    |Tenant API Key|Authentication key from Cisco|Your api key|\n\n4.  Select **Save and test**.\n\n5.  Navigate to **All** > **Cisco AI Defense Integration** > **Administration** > **Integrations**.\n\n6.  Confirm that the following integrations were created automatically.\n\n    -   Cisco AI Defense Model Validation Details Integration — Retrieves detailed validation results.\n    -   Cisco AI Defense Model Validation Integration — Retrieves validation job summaries.\n    -   Cisco AI Defense Policies Integration — Retrieves policies.\n    -   Cisco AI Defense Policy Details Integration — Retrieves policy details.\n    -   Cisco AI Defense Scan Details Integration — Retrieves detailed model vulnerability scan findings.\n    -   Cisco AI Defense Scans Integration — Retrieves vulnerability scan summaries.\n7.  Select an integration record and configure execution options for each integration.\n\n    -   Execute manually — Select **Execute Now**.\n    -   Schedule automatically — Configure a schedule for each integration.\n    See the steps in the following section.\n\n    **Note:** The integrations use business rules that are activated by default to process incoming data.\n\n\n## What to do next\n\nAfter installation, run the integrations manually or on a schedule to pull data from Cisco AI Defense.\n\nManual execution:\n\n1.  Find the record for the Cisco AI Defense integration that you want to run.\n2.  Select **Execute Now**.\n3.  Monitor the import set for processing status.\n\nScheduled execution:\n\n1.  Navigate to **All** > **Cisco AI Defense Integration** > **Administration** > **Integrations**.\n2.  Open an integration record.\n3.  Locate the **Schedule** tab and select it.\n4.  Configure your desired frequency \\(for example, daily or hourly\\).\n5.  Save the integration.\n\nYou're now ready to view your Cisco AI Defense data in your instance.\n\n**Parent Topic:**[Cisco AI Defense integration for AI security exposure management](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/exploring-cisco-ai-defense-integration.md)\n\n"}}