4.4. Consent for using cookies

Both the Univention Portal and the Management UI store cookies on the user’s computer. Depending on your use case and the public profile of your Univention Portal, you may need to inform users about the cookies.

When you enable the cookie consent banner, both the Univention Portal and the Management UI show the banner that users must accept before continuing. You can configure the banner content using UCR variables.

4.4.1. Configure the cookie consent banner

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

1. Set umc/cookie-banner/show to true to enable the banner. The banner displays the default content.

2. To customize the title and text, set the UCR variables umc/cookie-banner/title and umc/cookie-banner/text as needed.

   Both settings support language-specific configuration. For more information, see UCR reference for cookie consent banner.

You can also set the following variables:

umc/cookie-banner/cookie

for the name of the cookie that Nubus for UCS stores on the user’s system.

umc/cookie-banner/domains

for the domains for which Nubus for UCS shows the cookie consent banner.

To restore the default content, unset the umc/cookie-banner/title and umc/cookie-banner/text UCR variables. To deactivate the cookie banner, set umc/cookie-banner/show to false.

4.4.2. UCR reference for cookie consent banner

The following UCR variables control the cookie consent banner.

umc/cookie-banner/cookie

Sets the name of the cookie that Nubus for UCS stores on the user’s system when the user accepts the cookie consent banner. If you don’t set this variable, Nubus for UCS uses the name univentionCookieSettingsAccepted.

Default value:

not set

Type:

string

umc/cookie-banner/domains

Sets the domains for which Nubus for UCS shows the cookie consent banner. The value is a comma-separated list of domain names. Nubus for UCS matches domains from the end, so a single entry covers multiple subdomains. If you don’t set this variable, Nubus for UCS shows the banner for all domain names.

Example: The value example.com matches both portal.example.com and sso.example.com. Both sites share the cookie, so users only need to accept once.

Default value:

not set

Type:

list

umc/cookie-banner/show

Sets whether Nubus for UCS shows the cookie consent banner in the Univention Portal and during sign in.

Default value:

false

Possible values:

true, false

Type:

boolean

umc/cookie-banner/title

Sets the title for the cookie consent banner. If you don’t set this variable, Nubus for UCS provides a default title in English, Cookie Settings, and German, Cookie-Einstellungen.

Use umc/cookie-banner/title/LANGUAGE to set a title for a specific language, where LANGUAGE is a two-letter ISO 639-1 language code.

Default value:

not set

Type:

string

umc/cookie-banner/text

Sets the text for the cookie consent banner. If you don’t set this variable, Nubus for UCS provides default text in English and German that links to the Univention privacy policy. Use umc/cookie-banner/text/LANGUAGE to set text for a specific language, where LANGUAGE is a two-letter ISO 639-1 language code.

Default value:

not set

Type:

string

See also

ISO 639-1 on Wikipedia

for a list of two-letter language codes.

Univention Privacy statement

for the content of the privacy statement that the umc/cookie-banner/text UCR variable uses by default.