feat: add SecurityLevel option on HttpsTrigger

Google APIs · copybara-github · commit 44c497f37f19 · 2021-09-15T12:03:09.000-07:00
PiperOrigin-RevId: 396889803
diff --git a/google/cloud/functions/v1/functions.proto b/google/cloud/functions/v1/functions.proto
@@ -375,8 +375,31 @@ message SourceRepository {
 
 // Describes HttpsTrigger, could be used to connect web hooks to function.
 message HttpsTrigger {
+  // Available security level settings.
+  //
+  // This controls the methods to enforce security (HTTPS) on a URL.
+  //
+  // If unspecified, SECURE_OPTIONAL will be used.
+  enum SecurityLevel {
+    // Unspecified.
+    SECURITY_LEVEL_UNSPECIFIED = 0;
+
+    // Requests for a URL that match this handler that do not use HTTPS are
+    // automatically redirected to the HTTPS URL with the same path. Query
+    // parameters are reserved for the redirect.
+    SECURE_ALWAYS = 1;
+
+    // Both HTTP and HTTPS requests with URLs that match the handler succeed
+    // without redirects. The application can examine the request to determine
+    // which protocol was used and respond accordingly.
+    SECURE_OPTIONAL = 2;
+  }
+
   // Output only. The deployed url for the function.
   string url = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // The security level for the function.
+  SecurityLevel security_level = 2;
 }
 
 // Describes EventTrigger, used to request events be sent from another
