go.chromium.org/luci@v0.0.0-20240309015107-7cdc2e660f33/auth_service/api/rpcpb/changelogs.proto (about)

     1  // Copyright 2022 The LUCI Authors.
     2  //
     3  // Licensed under the Apache License, Version 2.0 (the "License");
     4  // you may not use this file except in compliance with the License.
     5  // You may obtain a copy of the License at
     6  //
     7  //      http://www.apache.org/licenses/LICENSE-2.0
     8  //
     9  // Unless required by applicable law or agreed to in writing, software
    10  // distributed under the License is distributed on an "AS IS" BASIS,
    11  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    12  // See the License for the specific language governing permissions and
    13  // limitations under the License.
    14  
    15  syntax = "proto3";
    16  
    17  package auth.service;
    18  
    19  option go_package = "go.chromium.org/luci/auth_service/api/rpcpb";
    20  
    21  import "google/protobuf/timestamp.proto";
    22  
    23  // ChangeLogs service contains methods to examine change logs.
    24  service ChangeLogs {
    25    // ListChangeLogs returns all the change logs in Datastore.
    26    rpc ListChangeLogs(ListChangeLogsRequest) returns (ListChangeLogsResponse);
    27  }
    28  
    29  // ListChangeLogsRequest is a request to get a list of change logs, which can
    30  // be filtered by auth_db_rev and/or target.
    31  message ListChangeLogsRequest {
    32    // AuthDB revision that the change log was made.
    33    int64 auth_db_rev = 1;
    34  
    35    // Entity that was changed in the change log.
    36    string target = 2;
    37  
    38    // The value of next_page_token received in a ListChangeLogsResponse. Used
    39    // to get the next page of change logs. If empty, gets the first page.
    40    string page_token = 3;
    41  
    42    // The maximum number of change logs to include in the response.
    43    int32 page_size = 4;
    44  }
    45  
    46  // ListChangeLogsResponse contains a list of change logs that matched the query.
    47  message ListChangeLogsResponse {
    48    // A list of change logs.
    49    repeated AuthDBChange changes = 1;
    50  
    51    // The value to use as the page_token in a ListChangeLogsRequest to get the
    52    // next page of change logs. If empty, there are no more change logs.
    53    string next_page_token = 2;
    54  }
    55  
    56  // AuthDBChange refers to a change log entry.
    57  message AuthDBChange {
    58    // Fields common across all change types.
    59    string change_type = 1;
    60    string target = 2;
    61    int64 auth_db_rev = 3;
    62    string who = 4;
    63    google.protobuf.Timestamp when = 5;
    64    string comment = 6;
    65    string app_version = 7;
    66    string description = 8;
    67    string old_description = 9;
    68  
    69    // Fields specific to AuthDBGroupChange.
    70    string owners = 10;
    71    string old_owners = 11;
    72    repeated string members = 12;
    73    repeated string globs = 13;
    74    repeated string nested = 14;
    75  
    76    // Fields specific to AuthDBIPAllowlistChange.
    77    repeated string subnets = 15;
    78  
    79    // Fields specific to AuthDBIPAllowlistAssignmentChange.
    80    string identity = 16;
    81    string ip_allow_list = 17;
    82  
    83    // Fields specific to AuthDBConfigChange.
    84    string oauth_client_id = 18;
    85    string oauth_client_secret = 19;
    86    repeated string oauth_additional_client_ids = 20;
    87    string token_server_url_old = 21;
    88    string token_server_url_new = 22;
    89    string security_config_old = 23;
    90    string security_config_new = 24;
    91  
    92    // Fields specific to AuthRealmsGlobalsChange.
    93    repeated string permissions_added = 25;
    94    repeated string permissions_changed = 26;
    95    repeated string permissions_removed = 27;
    96  
    97    // Fields specific to AuthProjectRealmsChange.
    98    string config_rev_old = 28;
    99    string config_rev_new = 29;
   100    string perms_rev_old = 30;
   101    string perms_rev_new = 31;
   102  }