{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Wiz Integration","description":"Control the power of AI Agents in runtime.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"wiz-integration","__idx":0},"children":["Wiz Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect Wiz to Capsule Security to inventory the AI agents and MCP servers Wiz discovers across your cloud environments and hosts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Capsule reads from the Wiz API and syncs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AI agents"]}," - Agents Wiz discovers across your cloud environments and hosts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP servers"]}," - MCP servers Wiz discovers across your cloud environments and hosts"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Capsule only reads. It does not change anything in your Wiz tenant."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sync-schedule","__idx":2},"children":["Sync schedule"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sync runs once every 24 hours. The first sync pulls everything Wiz has discovered. Later syncs pull only what changed since the previous one."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":3},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, ensure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Wiz tenant where you can open and enable the Capsule integration"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Capsule Security"]}," account with admin access"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The credentials Wiz issues must carry the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read:resources"]}," scope."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-enable-the-capsule-integration-in-wiz","__idx":4},"children":["Step 1: Enable the Capsule Integration in Wiz"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"steps","__idx":5},"children":["Steps"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Wiz, find the Capsule integration and enable it."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wiz shows four values. Copy each one:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication URL"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Endpoint URL"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication-url","__idx":6},"children":["Authentication URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Authentication URL depends on your Wiz environment. Capsule accepts these three values:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Environment"},"children":["Environment"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Authentication URL"},"children":["Authentication URL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Commercial"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://auth.app.wiz.io/oauth/token"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["FedRAMP"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://auth.app.wiz.us/oauth/token"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GovCloud"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://auth.gov.wiz.io/oauth/token"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-endpoint-url","__idx":7},"children":["API Endpoint URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API Endpoint URL is the GraphQL endpoint of your Wiz tenant, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.us1.app.wiz.io/graphql"]},". Capsule accepts only URLs of the form ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.<region>.app.wiz.io/graphql"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.<region>.app.wiz.us/graphql"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.<region>.gov.wiz.io/graphql"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-configure-the-integration-in-capsule","__idx":8},"children":["Step 2: Configure the Integration in Capsule"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"steps-1","__idx":9},"children":["Steps"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the Capsule portal, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Integrations"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Find ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wiz"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter the values from Step 1:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication URL"]},": Select the URL for your environment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Endpoint URL"]},": Paste the endpoint Wiz showed you. There is no default."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Capsule tests the connection as you type and reports success or the specific failure."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"after-setup","__idx":10},"children":["After setup"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The first sync begins automatically."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Discovered AI agents and MCP servers appear in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inventory"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":11},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-connection-test-fails","__idx":12},"children":["The connection test fails"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," match what Wiz shows, with no extra spaces."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication URL"]}," matches your Wiz environment from the table above."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Endpoint URL"]}," is the one Wiz showed for your tenant."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the credentials carry the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read:resources"]}," scope."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-api-endpoint-url-is-rejected","__idx":13},"children":["The API Endpoint URL is rejected"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the full GraphQL URL, including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://"]}," and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/graphql"]}," path, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.us1.app.wiz.io/graphql"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"new-resources-do-not-show-up-right-away","__idx":14},"children":["New resources do not show up right away"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sync runs once every 24 hours, so a resource Wiz discovered today can take up to a day to appear in Capsule."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support","__idx":15},"children":["Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For help with this integration:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email"]},": support@capsule.security"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Include"]},": Your tenant ID, integration status, and any error messages from the Capsule portal"]}]}]},"headings":[{"value":"Wiz Integration","id":"wiz-integration","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Sync schedule","id":"sync-schedule","depth":3},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Step 1: Enable the Capsule Integration in Wiz","id":"step-1-enable-the-capsule-integration-in-wiz","depth":2},{"value":"Steps","id":"steps","depth":3},{"value":"Authentication URL","id":"authentication-url","depth":3},{"value":"API Endpoint URL","id":"api-endpoint-url","depth":3},{"value":"Step 2: Configure the Integration in Capsule","id":"step-2-configure-the-integration-in-capsule","depth":2},{"value":"Steps","id":"steps-1","depth":3},{"value":"After setup","id":"after-setup","depth":3},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"The connection test fails","id":"the-connection-test-fails","depth":3},{"value":"The API Endpoint URL is rejected","id":"the-api-endpoint-url-is-rejected","depth":3},{"value":"New resources do not show up right away","id":"new-resources-do-not-show-up-right-away","depth":3},{"value":"Support","id":"support","depth":2}],"frontmatter":{"seo":{"title":"Wiz Integration"}},"lastModified":"2026-10-12T08:12:08.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/wiz","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}