4.4. Consent for using cookies

Deployment — Kubernetes

This page refers to the Nubus for Kubernetes deployment.

The Univention Portal and the Keycloak sign-in form can display a cookie consent banner to inform end users about the use of cookies and the handling of their data. The default settings of Nubus for Kubernetes deactivate the cookie consent banner. This page describes how to enable the cookie consent banner and how to configure its content.

4.4.1. Activate and customize

To enable and customize the cookie consent banner, follow these steps:

1. Add a UCR configuration to your custom_values.yaml deployment file under the key path global.configUCR.umc.cookie-banner. Listing 4.10 shows an example.

   Listing 4.10 Example UCR configuration to customize the content of the cookie consent banner

   global:
     configUcr:
       umc:
         cookie-banner:
           show: true
           title:
             en: "The English title for the Banner"
             de: "Der deutsche Titel für das Banner"
           text:
             en: "Custom text for your cookie consent banner."
             de: "Angepasster Text für Ihre Cookie Consent Banner."
   

2. Apply the changes as described in Apply changes.

4.4.2. Deactivate

To deactivate the cookie consent banner, follow these steps:

1. To deactivate the cookie consent banner, in your custom_values.yaml deployment file,

   • you either have to set global.configUcr.umc.cookie-banner.show to false,

   • or remove the configuration under the global.configUcr.umc.cookie-banner path.

   Listing 4.11 shows an example.

   Listing 4.11 Deactivate the cookie consent banner with ….show: false

   global:
     configUcr:
       umc:
         cookie-banner:
           show: false
   

2. Apply the changes as described in Apply changes.

4.4.3. Apply changes

1. To apply the updated configuration in your custom_values.yaml file to Nubus, run the commands in shown Listing 4.12.

   Listing 4.12 Apply customization to Nubus

   $ export NAMESPACE_FOR_NUBUS="Set to your Kubernetes namespace"
   $ export RELEASE_NAME="The Helm Chart release name"
   $ export VERSION="Your version of Nubus"
   $ helm upgrade \
      "$RELEASE_NAME" \
      --namespace="$NAMESPACE_FOR_NUBUS" \
      oci://artifacts.software-univention.de/nubus/charts/nubus \
      --values custom_values.yaml \
      --version "$VERSION"
   

2. To ensure that the portal applies the settings for the cookie consent banner, you must restart the Kubernetes pod for the UMC Gateway, because it provides the necessary data to the portal. Run the commands as shown in Listing 4.13.

   Listing 4.13 Restart pod for portal frontend to apply customization

   $ kubectl --namespace "$NAMESPACE_FOR_NUBUS" get pods | grep "umc-gateway"
   $ export NAME_OF_POD="Name of the pod in the output of the previous command."
   $ kubectl --namespace "$NAMESPACE_FOR_NUBUS" delete pod $NAME_OF_POD