feat(red-team): add Network Broker channel sub-client#187
Merged
Conversation
Expose RedTeamClient.networkBroker with listChannels, createChannel, getChannel, updateChannel, getChannelStats against the network broker data plane. Endpoint overridable via networkBrokerEndpoint option or PANW_RED_TEAM_NETWORK_BROKER_ENDPOINT. Adds Channel/ChannelStats/ ChannelStatus schemas and request/response types. Refs #186
Add guide section, runnable example, env var docs, and changeset. Refs #186
This was referenced Jul 9, 2026
Merged
cdot65
added a commit
that referenced
this pull request
Jul 9, 2026
- feat(red-team): Network Broker channel sub-client (#187) - feat(red-team): supported-languages and target-profile error-log endpoints (#193) - feat(model-security): read-only models sub-client (#195) - fix(management): percent-encode TSG ID in customer-apps list path (#189) - fix(red-team): correct Network Broker ChannelStats field names (#199)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #186
What
Adds a first-class Red Team Network Broker channel sub-client.
RedTeamClient.networkBrokernow lets SDK users discover and manage the broker channels that Red Team targets reference vianetwork_broker_channel_uuid— previously those UUIDs had to be obtained out-of-band.API
client.networkBroker:listChannels(options?)→GET /v1/channels— supportsstatus(single or repeated),search,include_all_if_empty,limit,skipcreateChannel(body)→POST /v1/channelsgetChannel(channelId)→GET /v1/channels/{channelId}(UUID-validated)updateChannel(channelId, body)→PATCH /v1/channels/{channelId}(UUID-validated)getChannelStats()→GET /v1/channels/statsUses a distinct network broker data-plane base URL, sharing the Red Team OAuth adapter. Overridable via the
networkBrokerEndpointconstructor option orPANW_RED_TEAM_NETWORK_BROKER_ENDPOINT.New models/schemas (all
.passthrough()):ChannelStatus(ONLINE/OFFLINE/DRAFT),CreateChannelRequest,UpdateChannelRequest,Channel,ChannelStats,ChannelListPagination,ChannelListResponse.Tests
test/red-team/network-broker-client.spec.ts— HTTP verb, path, query serialization (incl. repeatedstatus), request body, response parsing, UUID validationtest/models/red-team-network-broker.spec.ts— schema parsing + passthrough of extra fieldstest/red-team/client.spec.ts— sub-client wiring + endpoint override (option and env var)Docs
Red Team guide gains a Network Broker section (distinct base endpoint, channel-UUID discovery), a runnable
docs-site/examples/red-team-network-broker.ts, and env-var table updates.Verification
format:check,lint,typecheck,preflight(0 unacknowledged drift),docs:check, and the full Vitest suite (1324 tests) all pass locally.Notes
specs/, so preflight lists the new schemas as unmatched local helpers (no drift). Follow-up gaps from the PRD (language endpoints, target-profile error logs, model-security model endpoints, customer-app list drift) are out of scope here.🤖 Generated with Claude Code