Skip to content

Non-human identities (NHI) page and connector updates - #520

Open
mindymo wants to merge 9 commits into
mainfrom
nhi-visibility-draft
Open

Non-human identities (NHI) page and connector updates#520
mindymo wants to merge 9 commits into
mainfrom
nhi-visibility-draft

Conversation

@mindymo

@mindymo mindymo commented Sep 2, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Adds a lightweight product/admin/nhi.mdx page covering the Identities & NHI dashboard, requested by Product as a placeholder for search/discoverability while the NHI feature set is still thin.
  • Adds two fresh dashboard screenshots (nhi-identities-table.png, nhi-finding-detail.png) and wires the page into docs.json under Risk & intelligence.
  • Verified the NHI classification model against the app repo: "NHI" is scoped narrowly to app registrations, assumable roles, and managed identities — service accounts, secrets, and agents are separate sibling categories on the same dashboard, not a rollup under NHI. Page rewritten to match.
  • Consolidated the page's two disclaimer notes into a single "under active development" callout, per feedback.
  • Added a "syncs NHI" capability icon (robot) to baton/capabilities.mdx, verified connector-by-connector against actual baton-* source (not just the PM-supplied list). Scoped strictly to connectors emitting a real NhiType (app registration/assumable role/managed identity) — connectors that only sync a secret or flag a service-type user don't qualify under this page's definition. Also surfaced and added several connectors beyond the original list: JumpCloud, OneLogin, Grafana, OpenAI, Databricks, Azure Infrastructure.
  • Added a "this connector syncs non-human identities" callout to all 15 of those connectors' own doc pages, mirroring the existing "can sync secrets" pattern.

Follow-up after merge

  • Open upstream PRs in each of the 15 connectors' own repos (baton-aws, baton-google-cloud-platform, baton-github, baton-google-workspace, baton-active-directory, baton-microsoft-entra, baton-okta, baton-salesforce, baton-snowflake, baton-jumpcloud, baton-onelogin, baton-grafana, baton-openai, baton-databricks, baton-azure-infrastructure) to add the same "syncs non-human identities" callout at the source, since these connector docs sync back down from upstream and our direct edits here will otherwise get overwritten on the next sync.

Open questions (not yet resolved)

  • Nav label / dashboard tab names should be spot-checked against the live product one more time before merging.

Test plan

  • Review build preview
  • Confirm capability additions with the connector PM (especially the exclusions: Azure DevOps, Atlassian, Cloudflare, TeamCity, MongoDB Atlas)
  • After merge: open the 15 upstream connector PRs listed above

Placeholder landing page for the NHI dashboard, requested by Product
for search/discoverability while the feature set is still thin. Draft
content, several open questions pending review.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
conductorone 🟢 Ready View Preview Sep 2, 2026, 5:48 PM

The dashboard's NHI tab is scoped narrowly to app registrations,
assumable roles, and managed identities — not a rollup of service
accounts, secrets, and agents as originally drafted. Those are
separate, sibling categories on the same dashboard. Also removes the
now-contradicted "ownership assignment not available" scope claim.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@mindymo mindymo changed the title Add draft Non-human identities (NHI) page Non-human identities (NHI) page Sep 2, 2026
mindymo and others added 2 commits September 2, 2026 13:10
Removes the terminology-is-evolving note and the whole Current scope
section, replacing them with a single note near the top signaling
that NHI capabilities are still under active development.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
mindymo and others added 5 commits September 2, 2026 15:52
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Verified against each baton-* connector's source (via org-wide code
search for WithNHIType/WithSecretType) rather than taking the PM's
list at face value. Marked only connectors emitting an actual NhiType
(app registration, assumable role, managed identity), consistent with
how the new NHI page scopes the term — connectors that only sync a
static secret (Azure DevOps, Atlassian, Cloudflare, TeamCity) or only
flag a service-type user (MongoDB Atlas) are excluded under this
definition. Also added several connectors beyond the original list
that the code search turned up: JumpCloud, OneLogin, Grafana, OpenAI,
Databricks, and Azure Infrastructure.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Fingerprint reads as human identity verification; bot better signals
a non-human/automated identity.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
"bot" isn't a valid Font Awesome icon name; the docs Icon component
uses Font Awesome by default, and its equivalent is "robot".

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Mirrors the existing "this connector can sync secrets" callout
pattern, linking to the new NHI page instead. Placed near each
connector's Capabilities table, alongside any other capability notes.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant