Skip to content

Add protos for Identity Activity Center#54653

Merged
juliaogris merged 2 commits intomasterfrom
julia/iac-protos
May 12, 2025
Merged

Add protos for Identity Activity Center#54653
juliaogris merged 2 commits intomasterfrom
julia/iac-protos

Conversation

@juliaogris
Copy link
Copy Markdown
Contributor

@juliaogris juliaogris commented May 9, 2025

Add new and extend Protos for the new Identity Activity
Center (IAC) feature in Access Graph. IAC exposes and analysis activities of users,
allows to easily correlate log items by identity, target or type and proactively
provides alerts such as impossible travel.

Introduce of new Proto files for Okta and GitHub integrations, new
configuration fields (e.g., SIEM (Security Information and Event Management)
integration settings in Okta and AWS SQS polling settings), and extensive
updates to gRPC service definitions and generated code for access graph services.


This is the first PR in a longer chain to merge the long running
PoC from the iac branches of various gravitational repos into the
master branch.

Please take care reviewing the comments, I added them even though
I didn't author all the related original code and might have gotten
them wrong.

Link: https://github.com/gravitational/teleport/tree/iac

@juliaogris juliaogris force-pushed the julia/iac-protos branch 2 times, most recently from 379cdd1 to 452ff58 Compare May 9, 2025 07:45
@juliaogris juliaogris changed the title Update protos for IAC Add protos for Identity Activity Center May 9, 2025
@juliaogris juliaogris force-pushed the julia/iac-protos branch 3 times, most recently from 1f2da74 to 38941a5 Compare May 9, 2025 09:21
@juliaogris juliaogris requested review from Copilot, mvbrock and tigrato May 9, 2025 09:31

This comment was marked as resolved.

@juliaogris juliaogris force-pushed the julia/iac-protos branch 2 times, most recently from bb6ddff to 1ce0118 Compare May 9, 2025 09:44
@juliaogris juliaogris marked this pull request as ready for review May 9, 2025 10:08
@github-actions github-actions Bot requested review from klizhentas and rosstimothy May 9, 2025 10:09
Comment on lines +6768 to +6786
string client_id = 2;
string organization_name = 4;
google.protobuf.Timestamp start_date = 5 [
(gogoproto.stdtime) = true,
(gogoproto.nullable) = false
];
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.

godoc for these fields

message PluginGithubSettings {
option (gogoproto.equal) = true;

// APIEndpoint is the address of Github API.
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.

this is only important if using github enterprise. It's worth adding to the doc

Comment thread api/proto/teleport/legacy/types/types.proto Outdated
repeated AccessGraphAzureSync Azure = 3 [(gogoproto.jsontag) = "azure,omitempty"];
}

message AccessGraphAWSSyncSQSPolling {
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.

Godoc

Comment thread api/proto/teleport/legacy/types/types.proto Outdated
Comment on lines +608 to +613
// AWSCloudTrailResumeRegionState holds the state for a particular region.
message AWSCloudTrailResumeRegionState {
string next_page = 1;
optional string last_event_id = 2;
google.protobuf.Timestamp last_event_time = 3;
}
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.

Suggested change
// AWSCloudTrailResumeRegionState holds the state for a particular region.
message AWSCloudTrailResumeRegionState {
string next_page = 1;
optional string last_event_id = 2;
google.protobuf.Timestamp last_event_time = 3;
}

// exporting GitHub audit log events from a client (ex.: a Teleport connector
// for GitHub) to the AccessGraphService.
//
// This stream facilitates: - Initial configuration exchange (e.g., setting
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.

same comment as aws/teleport config and resume state responses are sent using two different messages


//GitHubAuditLogV1 holds the events shared between the client and the server.
message GitHubAuditLogV1 {
repeated google.protobuf.Struct events = 1;
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.

godoc

Comment thread proto/accessgraph/v1alpha/github.proto Outdated
// GitHubConfigV1 specifies configuration settings for GitHub audit log exports,
// including the desired start date for log collection.
message GitHubConfigV1 {
google.protobuf.Timestamp start_date = 1; // Start date for exporting audit logs.
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.

godoc

google.protobuf.Timestamp expires = 4;
// permissions are the token permissions.
repeated GithubTokenV1Permission permissions = 5;
string organization = 6;
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.

godoc

// enabled.
bool enable_bidirectional_sync = 10;
// Enable SIEM (Security Information and Event Management) integration.
bool enable_siem_integration = 11;
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I will change this to:

  // Enable Okta system log export.
  bool enable_system_log_export = 11;

as well

@juliaogris juliaogris added the no-changelog Indicates that a PR does not require a changelog entry label May 9, 2025
@juliaogris juliaogris force-pushed the julia/iac-protos branch 2 times, most recently from 8f68286 to aa32e60 Compare May 9, 2025 16:29
Add new and extend protos for the new Identity Activity
Center feature in Access Graph. Identity centers around activities of user,
allows to easily correlate log items by identity target or type and proactively
provides alerts such as impossible travel.
Fix according to review comments.
@juliaogris juliaogris added this pull request to the merge queue May 12, 2025
@juliaogris juliaogris removed this pull request from the merge queue due to a manual request May 12, 2025
@juliaogris juliaogris added this pull request to the merge queue May 12, 2025
Merged via the queue into master with commit f9e5f7e May 12, 2025
43 checks passed
@juliaogris juliaogris deleted the julia/iac-protos branch May 12, 2025 17:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

no-changelog Indicates that a PR does not require a changelog entry size/lg

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants