docs(samples): Set the assessment.event.expected_action when sending a CreateAssessment request. (GoogleCloudPlatform#9231)

Cory-Kramer · web-flow · commit ed8b1a9730ac · 2024-02-02T15:42:35.000-05:00
diff --git a/recaptcha_enterprise/demosite/src/main/java/app/MainController.java b/recaptcha_enterprise/demosite/src/main/java/app/MainController.java
@@ -119,9 +119,8 @@ public static ModelAndView home() {
     try {
       // <!-- ATTENTION: reCAPTCHA Example (Server Part 1/2) Starts -->
       assessmentResponse = CreateAssessment.createAssessment(
-          CONTEXT.get("project_id"),
-          CONTEXT.get("site_key"),
-          jsonData.get("token"));
+          CONTEXT.get("project_id"), CONTEXT.get("site_key"),
+          jsonData.get("token"), recaptchaAction);
 
       // Check if the token is valid, score is above threshold score and the action equals expected.
       // Take action based on the result (BAD / NOT_BAD).
@@ -172,9 +171,8 @@ public static ModelAndView signup() {
     try {
       // <!-- ATTENTION: reCAPTCHA Example (Server Part 1/2) Starts -->
       assessmentResponse = CreateAssessment.createAssessment(
-          CONTEXT.get("project_id"),
-          CONTEXT.get("site_key"),
-          jsonData.get("token").toString());
+          CONTEXT.get("project_id"), CONTEXT.get("site_key"),
+          jsonData.get("token").toString(), recaptchaAction);
 
       // Check if the token is valid, score is above threshold score and the action equals expected.
       // Take action based on the result (BAD / NOT_BAD).
@@ -227,9 +225,8 @@ public static ModelAndView login() {
     try {
       // <!-- ATTENTION: reCAPTCHA Example (Server Part 1/2) Starts -->
       assessmentResponse = CreateAssessment.createAssessment(
-          CONTEXT.get("project_id"),
-          CONTEXT.get("site_key"),
-          jsonData.get("token"));
+          CONTEXT.get("project_id"), CONTEXT.get("site_key"),
+          jsonData.get("token"), recaptchaAction);
 
       // Check if the token is valid, score is above threshold score and the action equals expected.
       // Take action based on the result (BAD / NOT_BAD).
@@ -282,9 +279,8 @@ public static ModelAndView store() {
     try {
       // <!-- ATTENTION: reCAPTCHA Example (Server Part 1/2) Starts -->
       assessmentResponse = CreateAssessment.createAssessment(
-          CONTEXT.get("project_id"),
-          CONTEXT.get("site_key"),
-          jsonData.get("token").toString());
+          CONTEXT.get("project_id"), CONTEXT.get("site_key"),
+          jsonData.get("token").toString(), recaptchaAction);
 
       // Check if the token is valid, score is above threshold score and the action equals expected.
       // Take action based on the result (BAD / NOT_BAD).
@@ -336,9 +332,8 @@ public static ModelAndView comment() {
     try {
       // <!-- ATTENTION: reCAPTCHA Example (Server Part 1/2) Starts -->
       assessmentResponse = CreateAssessment.createAssessment(
-          CONTEXT.get("project_id"),
-          CONTEXT.get("site_key"),
-          jsonData.get("token"));
+          CONTEXT.get("project_id"), CONTEXT.get("site_key"),
+          jsonData.get("token"), recaptchaAction);
 
       // Check if the token is valid, score is above threshold score and the action equals expected.
       // Take action based on the result (BAD / NOT_BAD).
diff --git a/recaptcha_enterprise/demosite/src/main/java/recaptcha/CreateAssessment.java b/recaptcha_enterprise/demosite/src/main/java/recaptcha/CreateAssessment.java
@@ -28,22 +28,26 @@ public class CreateAssessment {
    * Create an assessment to analyze the risk of a UI action.
    *
    * @param projectID : Google Cloud Project ID
-   * @param recaptchaSiteKey : Site key obtained by registering a domain/app to use recaptcha
-   *     services. (score/ checkbox type)
-   * @param token : The token obtained from the client on passing the recaptchaSiteKey.
+   * @param recaptchaSiteKey : Site key obtained by registering a domain/app to
+   *     use recaptcha services. (score/ checkbox type)
+   * @param token : The token obtained from the client on passing the
+   *     recaptchaSiteKey.
+   * @param expectedAction : The expected action for this type of event.
    * @return Assessment response.
    */
-  public static Assessment createAssessment(
-      String projectID, String recaptchaSiteKey, String token)
+  public static Assessment createAssessment(String projectID,
+                                            String recaptchaSiteKey,
+                                            String token, String expectedAction)
       throws Exception {
 
     // <!-- ATTENTION: reCAPTCHA Example (Server Part 2/2) Starts -->
     try (RecaptchaEnterpriseServiceClient client = RecaptchaEnterpriseServiceClient.create()) {
       // Set the properties of the event to be tracked.
       Event event = Event.newBuilder()
-          .setSiteKey(recaptchaSiteKey)
-          .setToken(token)
-          .build();
+                        .setSiteKey(recaptchaSiteKey)
+                        .setToken(token)
+                        .setExpectedAction(expectedAction)
+                        .build();
 
       // Build the assessment request.
       CreateAssessmentRequest createAssessmentRequest =
