Hold for launch: External insights

baton/crowdstrike.mdx

@@ -13,6 +13,10 @@ sidebarTitle: "CrowdStrike"
 | Accounts | <Icon icon="square-check" iconType="solid"  color="#65DE23"/> | |
 | Roles | <Icon icon="square-check" iconType="solid"  color="#65DE23"/> | <Icon icon="square-check" iconType="solid"  color="#65DE23"/> |
 
+**Additional functionality:**
+
+The CrowdStrike connector supports [external insights](/product/admin/external-insights) when your organization has a Falcon Identity Protection license. See [Enable risk score ingestion](#enable-risk-score-ingestion) for setup instructions.
+
 ## Gather CrowdStrike credentials
 
 Configuring the connector requires you to pass in credentials generated in CrowdStrike. Gather these credentials before you move on.
@@ -223,4 +227,44 @@ spec:
 </Tab>
 </Tabs>
 
+## Enable risk score ingestion
+
+<Warning>
+**Early access.** This feature is in early access, which means it's undergoing ongoing testing and development while we gather feedback, validate functionality, and improve outputs. Contact the ConductorOne Support team if you'd like to try it out or share feedback.
+</Warning>
+
+The CrowdStrike connector can ingest Falcon identity risk scores and surface them in ConductorOne during access reviews and access request approvals. See [External insights](/product/admin/external-insights) for an overview of where risk data appears.
+
+### Before you begin
+
+Confirm that:
+
+- Your organization has a **CrowdStrike Falcon Identity Protection** license
+- You have the **Falcon Administrator** role in CrowdStrike
+- Your CrowdStrike connector is already set up and syncing in ConductorOne
+
+### Add required API scopes
+
+The CrowdStrike API client you created during connector setup needs additional scopes to access risk score data.
+
+<Steps>
+  <Step>
+  Sign into the Falcon console and navigate to **Support** > **API Clients and Keys**.
+  </Step>
+  <Step>
+  Find the API client you created for the ConductorOne integration and click to edit it.
+  </Step>
+  <Step>
+  In the **API SCOPES** section, enable the following scope:
+
+  - **Identity Protection Entities: Read**
+
+</Step>
+  <Step>
+  Click **Save**.
+  </Step>
+</Steps>
+
+**That's it!** Your CrowdStrike connector will now sync risk score data into ConductorOne. See [External insights](/product/admin/external-insights) for details on where to see this data in the UI.
+
 

docs.json

@@ -156,7 +156,8 @@
             "group": "Access intelligence",
             "pages": [
               "product/admin/query",
-              "product/admin/inventory"
+              "product/admin/inventory",
+              "product/admin/external-insights"
             ]
           },
           {

product/admin/external-insights.mdx

@@ -0,0 +1,70 @@
+---
+title: "External insights"
+description: "Bring identity risk scores from your security tools into ConductorOne to inform access reviews and approval decisions."
+og:title: "External insights"
+og:description: "Bring identity risk scores from your security tools into ConductorOne to inform access reviews and approval decisions."
+sidebarTitle: "Gain context from identity risk scores"
+---
+
+{/* Editor Refresh: 2026-03-03 */}
+
+<Warning>
+**Early access.** This feature is in early access, which means it's undergoing ongoing testing and development while we gather feedback, validate functionality, and improve outputs. Contact the ConductorOne Support team if you'd like to try it out or share feedback.
+</Warning>
+
+External insights brings identity risk data from your security tools into ConductorOne, where it appears alongside the identities it describes. Reviewers and approvers see risk scores in context, such as during access reviews and at the moment of approval, so they can make more informed decisions without switching tools.
+
+## How external insights work
+
+When you configure an external insights source, ConductorOne syncs risk data from that tool through its connector. ConductorOne matches each risk score to an identity in your directory by email address and attaches it to that identity's profile and any accounts they hold in other connected apps.
+
+Once synced, risk scores appear in the ConductorOne UI wherever that identity appears in an access decision.
+
+## Enable or disable external insights
+
+<Warning>
+This task requires the **Super Administrator** or **Connector Administrator** role in ConductorOne.
+</Warning>
+
+External insights are enabled automatically when a connector that is a supported external insight source is configured and syncing. No additional setup is required.
+
+If needed, you can manually turn risk score syncing on or off from the connector's settings page in ConductorOne:
+
+<Steps>
+<Step>
+Go to **Integrations** > **Connectors** and select the relevant connector.
+</Step>
+<Step>
+On the connector's **Details** tab, find the **Capabilities** section and click **Edit**.
+</Step>
+<Step>
+Under **Resource capabilities**, enable or disable **Identity Risk Score** as needed.
+</Step>
+<Step>
+Click **Save**.
+</Step>
+</Steps>
+
+## Where external insights appear
+
+**Access review campaigns**
+
+Reviewers see an identity's risk score and risk factors on each review task, under the **Insights** tab. Risk factors are the specific reasons the source tool assigned that score — for example, `STALE_ACCOUNT` or `WEAK_PASSWORD_POLICY`. Reviewers can use this context to prioritize high-risk identities and make more informed certify or revoke decisions.
+
+**Task log**
+
+The task log includes an **Insights** column. Hovering over the insights indicator for a task shows a summary of the identity's risk score and risk factors inline, with a link to view the full details.
+
+**Access request approvals**
+
+Approvers can see an identity's current risk score and risk factors in a request task before submitting their decision.
+
+## Supported external insights sources
+
+<Columns cols={2}>
+  <Card title="CrowdStrike Falcon Identity Protection" icon="shield-check" href="/baton/crowdstrike">
+    Ingest Falcon identity risk scores into ConductorOne. 
+  </Card>
+</Columns>
+
+