Fix cookies not deleting on opt-out (#5338)

Co-authored-by: eastandwestwind <eastandwestwind@gmail.com>
ethyca · Oct 16, 2024 · a268975 · a268975
1 parent 348b1af
commit a268975
Show file tree

Hide file tree

Showing 32 changed files with 187 additions and 18 deletions.
diff --git a/.fides/db_dataset.yml b/.fides/db_dataset.yml
@@ -1064,6 +1064,8 @@ dataset:
       data_categories: [ system.operations ]
     - name: auto_detect_language
       data_categories: [ system.operations ]
+    - name: auto_subdomain_cookie_deletion
+      data_categories: [ system.operations ]
     - name: id
       data_categories: [system.operations]
     - name: name
@@ -1105,6 +1107,8 @@ dataset:
       data_categories: [ system.operations ]
     - name: auto_detect_language
       data_categories: [ system.operations ]
+    - name: auto_subdomain_cookie_deletion
+      data_categories: [ system.operations ]
     - name: id
       data_categories: [system.operations]
     - name: is_default
@@ -2001,6 +2005,8 @@ dataset:
       data_categories: [ system.operations ]
     - name: auto_detect_language
       data_categories: [ system.operations ]
+    - name: auto_subdomain_cookie_deletion
+      data_categories: [ system.operations ]
     - name: id
       data_categories: [system.operations]
     - name: name

diff --git a/clients/admin-ui/cypress/e2e/privacy-experiences.cy.ts b/clients/admin-ui/cypress/e2e/privacy-experiences.cy.ts
@@ -207,6 +207,7 @@ describe("Privacy experiences", () => {
           expect(body).to.eql({
             allow_language_selection: false,
             auto_detect_language: true,
+            auto_subdomain_cookie_deletion: true,
             component: "banner_and_modal",
             disabled: true,
             dismissable: true,

diff --git a/clients/admin-ui/cypress/fixtures/privacy-experiences/experienceConfig.json b/clients/admin-ui/cypress/fixtures/privacy-experiences/experienceConfig.json
@@ -6,6 +6,7 @@
   "layer1_button_options": "opt_in_opt_out",
   "allow_language_selection": false,
   "auto_detect_language": true,
+  "auto_subdomain_cookie_deletion": true,
   "regions": ["us_ca", "us_co", "us_ct", "us_ut", "us_va"],
   "id": "pri_001",
   "created_at": "2024-03-22T20:06:27.119285+00:00",

diff --git a/clients/admin-ui/src/features/privacy-experience/PrivacyExperienceForm.tsx b/clients/admin-ui/src/features/privacy-experience/PrivacyExperienceForm.tsx
@@ -315,6 +315,13 @@ export const PrivacyExperienceForm = ({
           Edit experience text
         </Button>
       )}
+      <CustomSwitch
+        name="auto_subdomain_cookie_deletion"
+        id="auto_subdomain_cookie_deletion"
+        label="Automatically delete subdomain cookies"
+        variant="stacked"
+        tooltip="If enabled, automatically deletes cookies set on subdomains in addition to main domain where appropriate. Recommended to enable for full consent compliance."
+      />
     </PrivacyExperienceConfigColumnLayout>
   );
 };

diff --git a/clients/admin-ui/src/features/privacy-experience/form/helpers.tsx b/clients/admin-ui/src/features/privacy-experience/form/helpers.tsx
@@ -48,6 +48,7 @@ export const defaultInitialValues: Omit<ExperienceConfigCreate, "component"> = {
   regions: [],
   translations: defaultTranslations,
   auto_detect_language: true,
+  auto_subdomain_cookie_deletion: true,
 };
 // utility type to pass as a prop to the translation form
 export type TranslationWithLanguageName = ExperienceTranslation &

diff --git a/clients/admin-ui/src/features/privacy-experience/preview/helpers.ts b/clients/admin-ui/src/features/privacy-experience/preview/helpers.ts
@@ -72,6 +72,7 @@ export const buildBaseConfig = (
       layer1_button_options: Layer1ButtonOption.OPT_IN_OPT_OUT,
       allow_language_selection: true,
       auto_detect_language: true,
+      auto_subdomain_cookie_deletion: true,
       language: "en",
       // in preview mode, we show the first translation in the main window, even when multiple translations are configured
       translations: [buildExperienceTranslation(experienceConfig)],

diff --git a/clients/admin-ui/src/types/api/models/ExperienceConfigCreate.ts b/clients/admin-ui/src/types/api/models/ExperienceConfigCreate.ts
@@ -21,6 +21,7 @@ export type ExperienceConfigCreate = {
   layer1_button_options?: Layer1ButtonOption | null;
   allow_language_selection?: boolean | null;
   auto_detect_language?: boolean | null;
+  auto_subdomain_cookie_deletion?: boolean | null;
   regions?: Array<PrivacyNoticeRegion>;
   component: ComponentType;
   privacy_notice_ids?: Array<string>;

diff --git a/clients/admin-ui/src/types/api/models/ExperienceConfigResponse.ts b/clients/admin-ui/src/types/api/models/ExperienceConfigResponse.ts
@@ -20,6 +20,7 @@ export type ExperienceConfigResponse = {
   layer1_button_options?: Layer1ButtonOption | null;
   allow_language_selection?: boolean | null;
   auto_detect_language?: boolean | null;
+  auto_subdomain_cookie_deletion?: boolean | null;
   regions: Array<PrivacyNoticeRegion>;
   id: string;
   created_at: string;

diff --git a/clients/admin-ui/src/types/api/models/ExperienceConfigResponseNoNotices.ts b/clients/admin-ui/src/types/api/models/ExperienceConfigResponseNoNotices.ts
@@ -21,6 +21,7 @@ export type ExperienceConfigResponseNoNotices = {
   layer1_button_options?: Layer1ButtonOption | null;
   allow_language_selection?: boolean | null;
   auto_detect_language?: boolean | null;
+  auto_subdomain_cookie_deletion?: boolean | null;
   regions: Array<PrivacyNoticeRegion>;
   id: string;
   created_at: string;

diff --git a/clients/admin-ui/src/types/api/models/ExperienceConfigUpdate.ts b/clients/admin-ui/src/types/api/models/ExperienceConfigUpdate.ts
@@ -25,6 +25,7 @@ export type ExperienceConfigUpdate = {
   layer1_button_options?: Layer1ButtonOption | null;
   allow_language_selection?: boolean | null;
   auto_detect_language?: boolean | null;
+  auto_subdomain_cookie_deletion?: boolean | null;
   regions: Array<PrivacyNoticeRegion>;
   translations: Array<ExperienceTranslation>;
   privacy_notice_ids: Array<string>;

diff --git a/clients/admin-ui/src/types/api/models/MinimalTCFExperienceConfig.ts b/clients/admin-ui/src/types/api/models/MinimalTCFExperienceConfig.ts
@@ -11,6 +11,7 @@ import type { MinimalTCFBannerTranslation } from "./MinimalTCFBannerTranslation"
  */
 export type MinimalTCFExperienceConfig = {
   auto_detect_language?: boolean | null;
+  auto_subdomain_cookie_deletion?: boolean | null;
   component: ComponentType;
   dismissable?: boolean | null;
   translations?: Array<MinimalTCFBannerTranslation>;

diff --git a/clients/fides-js/__tests__/__fixtures__/mock_experience.json b/clients/fides-js/__tests__/__fixtures__/mock_experience.json
@@ -18,6 +18,7 @@
     "layer1_button_options": "opt_in_opt_out",
     "allow_language_selection": true,
     "auto_detect_language": true,
+    "auto_subdomain_cookie_deletion": true,
     "language": "en",
     "accept_button_label": "Accept Test",
     "acknowledge_button_label": "Acknowledge Test",

diff --git a/clients/fides-js/__tests__/lib/cookie.test.ts b/clients/fides-js/__tests__/lib/cookie.test.ts
@@ -395,35 +395,80 @@ describe("cookies", () => {
     afterEach(() => mockRemoveCookie.mockClear());
 
     it.each([
-      { cookies: [], expectedAttributes: [] },
-      { cookies: [{ name: "_ga123" }], expectedAttributes: [{ path: "/" }] },
+      { cookies: [], removeSubdomainCookies: false, expectedAttributes: [] },
+      { cookies: [], removeSubdomainCookies: true, expectedAttributes: [] },
       {
-        cookies: [{ name: "_ga123", path: "" }],
-        expectedAttributes: [{ path: "" }],
+        cookies: [{ name: "_ga123" }],
+        removeSubdomainCookies: false,
+        expectedAttributes: [{ domain: undefined, path: "/" }],
       },
       {
-        cookies: [{ name: "_ga123", path: "/subpage" }],
-        expectedAttributes: [{ path: "/subpage" }],
+        cookies: [{ name: "_ga123" }],
+        removeSubdomainCookies: true,
+        expectedAttributes: [
+          { domain: undefined, path: "/" },
+          { domain: ".example.co.jp" },
+        ],
+      },
+      {
+        cookies: [{ name: "aax-uid" }, { name: "pixel" }],
+        removeSubdomainCookies: false,
+        expectedAttributes: [
+          { domain: undefined, path: "/" },
+          { domain: undefined, path: "/" },
+        ],
+      },
+      {
+        cookies: [{ name: "aax-uid" }, { name: "pixel" }],
+        removeSubdomainCookies: true,
+        expectedAttributes: [
+          { domain: undefined, path: "/" },
+          { domain: ".example.co.jp" },
+        ],
       },
+      // these cookies won't actually end up being deleted in the browser
+      // https://ethyca.atlassian.net/browse/PROD-2830
       {
-        cookies: [{ name: "_ga123" }, { name: "shopify" }],
-        expectedAttributes: [{ path: "/" }, { path: "/" }],
+        cookies: [{ name: "test-cookie", domain: `"[*]"` }],
+        removeSubdomainCookies: false,
+        expectedAttributes: [{ domain: `"[*]"`, path: "/" }],
+      },
+      {
+        cookies: [{ name: "test-cookie", domain: `"[*]"` }],
+        removeSubdomainCookies: true,
+        expectedAttributes: [
+          { domain: `"[*]"`, path: "/" },
+          { domain: ".example.co.jp" },
+        ],
       },
     ])(
       "should remove a list of cookies",
       ({
         cookies,
+        removeSubdomainCookies,
         expectedAttributes,
       }: {
         cookies: CookiesType[];
-        expectedAttributes: CookieAttributes[];
+        removeSubdomainCookies?: boolean;
+        expectedAttributes: Array<CookieAttributes | undefined>;
       }) => {
-        removeCookiesFromBrowser(cookies);
-        expect(mockRemoveCookie.mock.calls).toHaveLength(cookies.length);
-        cookies.forEach((cookie, idx) => {
-          const [name, attributes] = mockRemoveCookie.mock.calls[idx];
-          expect(name).toEqual(cookie.name);
-          expect(attributes).toEqual(expectedAttributes[idx]);
+        removeCookiesFromBrowser(cookies, removeSubdomainCookies);
+        const expectedLength = removeSubdomainCookies
+          ? cookies.length * 2
+          : cookies.length;
+        expect(mockRemoveCookie.mock.calls).toHaveLength(expectedLength);
+        cookies.forEach((cookie, cookieIdx) => {
+          const calls = removeSubdomainCookies
+            ? mockRemoveCookie.mock.calls.slice(
+                cookieIdx * 2,
+                cookieIdx * 2 + 2,
+              )
+            : mockRemoveCookie.mock.calls.slice(cookieIdx, cookieIdx + 1);
+          calls.forEach((call, i) => {
+            const [name, attributes] = call;
+            expect(name).toEqual(cookie.name);
+            expect(attributes).toEqual(expectedAttributes[i]);
+          });
         });
       },
     );

diff --git a/clients/fides-js/src/lib/consent-types.ts b/clients/fides-js/src/lib/consent-types.ts
@@ -433,7 +433,10 @@ interface ExperienceConfigTranslationMinimal
 export interface ExperienceConfigMinimal
   extends Pick<
     ExperienceConfig,
-    "component" | "auto_detect_language" | "dismissable"
+    | "component"
+    | "auto_detect_language"
+    | "dismissable"
+    | "auto_subdomain_cookie_deletion"
   > {
   translations: ExperienceConfigTranslationMinimal[];
 }
@@ -481,6 +484,7 @@ export type ExperienceConfig = {
   allow_language_selection?: boolean;
   auto_detect_language?: boolean;
   modal_link_label?: string;
+  auto_subdomain_cookie_deletion?: boolean;
 
   /**
    * List of regions that apply to this ExperienceConfig.

diff --git a/clients/fides-js/src/lib/cookie.ts b/clients/fides-js/src/lib/cookie.ts
@@ -331,13 +331,21 @@ export const makeConsentDefaultsLegacy = (
 
 /**
  * Given a list of cookies, deletes them from the browser
+ * Optionally removes subdomain cookies as well
  */
-export const removeCookiesFromBrowser = (cookiesToRemove: CookiesType[]) => {
+export const removeCookiesFromBrowser = (
+  cookiesToRemove: CookiesType[],
+  removeSubdomainCookies: boolean = true,
+) => {
   cookiesToRemove.forEach((cookie) => {
     cookies.remove(cookie.name, {
       path: cookie.path ?? "/",
       domain: cookie.domain,
     });
+    if (removeSubdomainCookies) {
+      const { hostname } = window.location;
+      cookies.remove(cookie.name, { domain: `.${hostname}` });
+    }
   });
 };
 

diff --git a/clients/fides-js/src/lib/preferences.ts b/clients/fides-js/src/lib/preferences.ts
@@ -144,7 +144,10 @@ export const updateConsentPreferences = async ({
       )
       .forEach((preference) => {
         if (preference.notice?.cookies) {
-          removeCookiesFromBrowser(preference.notice.cookies);
+          removeCookiesFromBrowser(
+            preference.notice.cookies,
+            experience.experience_config?.auto_subdomain_cookie_deletion,
+          );
         }
       });
   }

diff --git a/clients/privacy-center/cypress/fixtures/consent/experience_banner_modal.json b/clients/privacy-center/cypress/fixtures/consent/experience_banner_modal.json
@@ -62,6 +62,7 @@
         "layer1_button_options": "opt_in_opt_out",
         "allow_language_selection": true,
         "auto_detect_language": true,
+        "auto_subdomain_cookie_deletion": true,
         "disabled": false,
         "id": "pri_exp-banner-modal-000",
         "component": "banner_and_modal",

diff --git a/clients/privacy-center/cypress/fixtures/consent/experience_banner_modal_notice_only.json b/clients/privacy-center/cypress/fixtures/consent/experience_banner_modal_notice_only.json
@@ -61,6 +61,7 @@
         "layer1_button_options": "opt_in_opt_out",
         "allow_language_selection": true,
         "auto_detect_language": true,
+        "auto_subdomain_cookie_deletion": true,
         "disabled": false,
         "id": "pri_exp-banner-modal-000",
         "component": "banner_and_modal",

diff --git a/clients/privacy-center/cypress/fixtures/consent/experience_gpp.json b/clients/privacy-center/cypress/fixtures/consent/experience_gpp.json
@@ -54,6 +54,7 @@
         "layer1_button_options": "opt_in_opt_out",
         "allow_language_selection": true,
         "auto_detect_language": true,
+        "auto_subdomain_cookie_deletion": true,
         "disabled": false,
         "id": "pri_exp-gpp-banner-modal-000",
         "component": "banner_and_modal",

diff --git a/clients/privacy-center/cypress/fixtures/consent/experience_modal.json b/clients/privacy-center/cypress/fixtures/consent/experience_modal.json
@@ -62,6 +62,7 @@
         "layer1_button_options": "opt_in_opt_out",
         "allow_language_selection": true,
         "auto_detect_language": true,
+        "auto_subdomain_cookie_deletion": true,
         "disabled": false,
         "id": "pri_exp-modal-000",
         "component": "modal",

diff --git a/clients/privacy-center/cypress/fixtures/consent/experience_privacy_center.json b/clients/privacy-center/cypress/fixtures/consent/experience_privacy_center.json
@@ -62,6 +62,7 @@
         "layer1_button_options": "opt_in_opt_out",
         "allow_language_selection": true,
         "auto_detect_language": true,
+        "auto_subdomain_cookie_deletion": true,
         "disabled": false,
         "id": "pri_exp-privacy-center-000",
         "component": "privacy_center",

diff --git a/clients/privacy-center/cypress/fixtures/consent/experience_privacy_center_hierarchical.json b/clients/privacy-center/cypress/fixtures/consent/experience_privacy_center_hierarchical.json
@@ -62,6 +62,7 @@
         "layer1_button_options": "opt_in_opt_out",
         "allow_language_selection": true,
         "auto_detect_language": true,
+        "auto_subdomain_cookie_deletion": true,
         "disabled": false,
         "id": "pri_exp-privacy-center-000",
         "component": "privacy_center",

diff --git a/clients/privacy-center/cypress/fixtures/consent/experience_tcf.json b/clients/privacy-center/cypress/fixtures/consent/experience_tcf.json
@@ -73,6 +73,7 @@
         "layer1_button_options": "opt_in_opt_out",
         "allow_language_selection": true,
         "auto_detect_language": true,
+        "auto_subdomain_cookie_deletion": true,
         "disabled": false,
         "id": "pri_exp-tcf-overlay-000",
         "component": "tcf_overlay",

diff --git a/clients/privacy-center/cypress/fixtures/consent/experience_tcf_minimal.json b/clients/privacy-center/cypress/fixtures/consent/experience_tcf_minimal.json
@@ -12,6 +12,7 @@
       "experience_config": {
         "dismissable": true,
         "auto_detect_language": true,
+        "auto_subdomain_cookie_deletion": true,
         "component": "tcf_overlay",
         "translations": [
           {

diff --git a/clients/privacy-center/cypress/fixtures/consent/fidesjs_options_banner_modal.json b/clients/privacy-center/cypress/fixtures/consent/fidesjs_options_banner_modal.json
@@ -74,6 +74,7 @@
       "layer1_button_options": "opt_in_opt_out",
       "allow_language_selection": true,
       "auto_detect_language": true,
+      "auto_subdomain_cookie_deletion": true,
       "disabled": false,
       "id": "pri_exp-banner-modal-000",
       "component": "banner_and_modal",

diff --git a/clients/privacy-center/public/fides-js-components-demo.html b/clients/privacy-center/public/fides-js-components-demo.html
@@ -70,6 +70,7 @@
             layer1_button_options: "opt_in_opt_out",
             allow_language_selection: true,
             auto_detect_language: true,
+            auto_subdomain_cookie_deletion: true,
             language: "en",
             accept_button_label: "Accept Test",
             acknowledge_button_label: "Acknowledge Test",

diff --git a/clients/privacy-center/types/api/models/ExperienceConfigCreate.ts b/clients/privacy-center/types/api/models/ExperienceConfigCreate.ts
@@ -21,6 +21,7 @@ export type ExperienceConfigCreate = {
   layer1_button_options?: Layer1ButtonOption | null;
   allow_language_selection?: boolean | null;
   auto_detect_language?: boolean | null;
+  auto_subdomain_cookie_deletion?: boolean | null;
   regions?: Array<PrivacyNoticeRegion>;
   component: ComponentType;
   privacy_notice_ids?: Array<string>;

diff --git a/clients/privacy-center/types/api/models/ExperienceConfigResponse.ts b/clients/privacy-center/types/api/models/ExperienceConfigResponse.ts
@@ -20,6 +20,7 @@ export type ExperienceConfigResponse = {
   layer1_button_options?: Layer1ButtonOption | null;
   allow_language_selection?: boolean | null;
   auto_detect_language?: boolean | null;
+  auto_subdomain_cookie_deletion?: boolean | null;
   regions: Array<PrivacyNoticeRegion>;
   id: string;
   created_at: string;

diff --git a/clients/privacy-center/types/api/models/ExperienceConfigResponseNoNotices.ts b/clients/privacy-center/types/api/models/ExperienceConfigResponseNoNotices.ts
@@ -21,6 +21,7 @@ export type ExperienceConfigResponseNoNotices = {
   layer1_button_options?: Layer1ButtonOption | null;
   allow_language_selection?: boolean | null;
   auto_detect_language?: boolean | null;
+  auto_subdomain_cookie_deletion?: boolean | null;
   regions: Array<PrivacyNoticeRegion>;
   id: string;
   created_at: string;

diff --git a/clients/privacy-center/types/api/models/ExperienceConfigUpdate.ts b/clients/privacy-center/types/api/models/ExperienceConfigUpdate.ts
@@ -25,6 +25,7 @@ export type ExperienceConfigUpdate = {
   layer1_button_options?: Layer1ButtonOption | null;
   allow_language_selection?: boolean | null;
   auto_detect_language?: boolean | null;
+  auto_subdomain_cookie_deletion?: boolean | null;
   regions: Array<PrivacyNoticeRegion>;
   translations: Array<ExperienceTranslation>;
   privacy_notice_ids: Array<string>;