Skip to content

Agent governance docs — service accounts, API keys, audit log, MCP setupAgent governance stream 1 docs#3219

Merged
ginatkins merged 9 commits into
OctopusDeploy:mainfrom
ginatkins:agent-governance-stream-1-docs
Jun 26, 2026
Merged

Agent governance docs — service accounts, API keys, audit log, MCP setupAgent governance stream 1 docs#3219
ginatkins merged 9 commits into
OctopusDeploy:mainfrom
ginatkins:agent-governance-stream-1-docs

Conversation

@ginatkins

Copy link
Copy Markdown
Contributor

Summary

Documents the public-facing changes shipped in stream 1 of the Agent Governance initiative (AIF project). Three areas updated:

  1. Service accounts — new Agent Service Account variant (username + display name only, holds agent API keys only). Closes AIF-446.
  2. API keys — new "New Agent Key" creation flow, plus reference for the Manage API Keys page changes (Identity column with type tags, "Include AI Agents" filter, "Show permissions" shortcut, last-used timestamp). Closes AIF-445, AIF-449, AIF-450, AIF-452, AIF-453.
  3. Audit log — "Include AI Agents" filter and per-event API key attribution. Closes AIF-447, AIF-448.
  4. MCP setup — recommends a dedicated Agent Service Account and agent API key rather than a generic user API key, so attribution flows through to the audit log.

These were developed and merged across three PRs on the fork (#1, #2, #3) and are combined here for upstream review.

🤖 Generated with Claude Code

ginatkins and others added 9 commits June 19, 2026 19:57
Adds docs for the new Agent Service Account identity type and agent API
key support introduced in the Agent Governance project, including how to
create them, the API Keys page management UX (type tags, AI agent filter,
last-used timestamp, view permissions shortcut), and cross-links between
the two pages.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Document agent service accounts and agent API keys
Adds a note that agent API key names are captured in audit events for
attribution, and documents the AI Agents filter for narrowing the audit
log to agent activity only.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Document agent activity filtering and attribution in audit log
Updates the MCP server requirements to recommend creating a dedicated
Agent Service Account and agent API key rather than a generic API key,
with links to the relevant docs and a brief explanation of the benefits.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Recommend agent service account and agent API key for MCP setup

@steve-fenton-octopus steve-fenton-octopus left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@ginatkins ginatkins merged commit eafe771 into OctopusDeploy:main Jun 26, 2026
7 checks passed
@ginatkins ginatkins deleted the agent-governance-stream-1-docs branch June 26, 2026 01:49
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.

2 participants