Files
dspace-angular/src/app/shared/cookies/klaro-configuration.ts

211 lines
7.3 KiB
TypeScript

import { TOKENITEM } from '../../core/auth/models/auth-token-info.model';
import { IMPERSONATING_COOKIE, REDIRECT_COOKIE } from '../../core/auth/auth.service';
import { LANG_COOKIE } from '../../core/locale/locale.service';
import { CAPTCHA_COOKIE, CAPTCHA_NAME } from '../../core/google-recaptcha/google-recaptcha.service';
import { ACCESSIBILITY_COOKIE } from '../../accessibility/accessibility-settings.service';
/**
* Cookie for has_agreed_end_user
*/
export const HAS_AGREED_END_USER = 'dsHasAgreedEndUser';
/**
* Storage name used to store klaro cookie
*/
export const ANONYMOUS_STORAGE_NAME_KLARO = 'klaro-anonymous';
export const GOOGLE_ANALYTICS_KLARO_KEY = 'google-analytics';
/**
* Klaro configuration
* For more information see https://klaro.org/docs/integration/annotated-configuration
*/
export const klaroConfiguration: any = {
storageName: ANONYMOUS_STORAGE_NAME_KLARO,
privacyPolicy: './info/privacy',
/*
Setting 'hideLearnMore' to 'true' will hide the "learn more / customize" link in
the consent notice. We strongly advise against using this under most
circumstances, as it keeps the user from customizing their consent choices.
*/
hideLearnMore: false,
/*
Setting 'acceptAll' to 'true' will show an "accept all" button in the notice and
modal, which will enable all third-party services if the user clicks on it. If set
to 'false', there will be an "accept" button that will only enable the services that
are enabled in the consent modal.
*/
acceptAll: true,
/*
You can also set a custom expiration time for the Klaro cookie. By default, it
will expire after 30 days. Only relevant if 'storageMethod' is set to 'cookie'.
*/
cookieExpiresAfterDays: 365,
htmlTexts: true,
/*
Force Klaro to use our custom "zy" lang configs defined below.
*/
lang: 'zy',
/*
You can overwrite existing translations and add translations for your app
descriptions and purposes. See `src/translations/` for a full list of
translations that can be overwritten:
https://github.com/klaro-org/klaro-js/tree/master/src/translations
*/
translations: {
/*
For DSpace we use this custom 'zy' key to map to our own i18n translations for klaro, see
translateConfiguration() in browser-klaro.service.ts. All the below i18n keys are specified
in your /src/assets/i18n/*.json5 translation pack.
This 'zy' key has no special meaning to Klaro & is not a valid language code. It just
allows DSpace to override Klaro's own translations in favor of DSpace's i18n keys.
NOTE: we do not use 'zz' as that has special meaning to Klaro and is ONLY used as a "fallback"
if no other translations can be found within Klaro. Currently, a bug in Klaro means that
'zz' is never used as there's no way to exclude translations:
https://github.com/klaro-org/klaro-js/issues/515
*/
zy: {
acceptAll: 'cookies.consent.accept-all',
acceptSelected: 'cookies.consent.accept-selected',
close: 'cookies.consent.close',
consentModal: {
title: 'cookies.consent.content-modal.title',
description: 'cookies.consent.content-modal.description'
},
consentNotice: {
changeDescription: 'cookies.consent.update',
title: 'cookies.consent.content-notice.title',
description: 'cookies.consent.content-notice.description',
learnMore: 'cookies.consent.content-notice.learnMore',
},
decline: 'cookies.consent.decline',
ok: 'cookies.consent.ok',
poweredBy: 'Powered by Klaro!',
privacyPolicy: {
name: 'cookies.consent.content-modal.privacy-policy.name',
text: 'cookies.consent.content-modal.privacy-policy.text'
},
purposeItem: {
service: 'cookies.consent.content-modal.service',
services: 'cookies.consent.content-modal.services'
},
purposes: {
},
save: 'cookies.consent.save',
service: {
disableAll: {
description: 'cookies.consent.app.disable-all.description',
title: 'cookies.consent.app.disable-all.title'
},
optOut: {
description: 'cookies.consent.app.opt-out.description',
title: 'cookies.consent.app.opt-out.title'
},
purpose: 'cookies.consent.app.purpose',
purposes: 'cookies.consent.app.purposes',
required: {
title: 'cookies.consent.app.required.title',
description: 'cookies.consent.app.required.description'
}
}
}
},
services: [
{
name: 'authentication',
purposes: ['functional'],
required: true,
cookies: [
TOKENITEM,
IMPERSONATING_COOKIE,
REDIRECT_COOKIE
]
},
{
name: 'preferences',
purposes: ['functional'],
required: true,
cookies: [
LANG_COOKIE
]
},
{
name: 'acknowledgement',
purposes: ['functional'],
required: true,
cookies: [
[/^klaro-.+$/],
HAS_AGREED_END_USER
]
},
{
name: GOOGLE_ANALYTICS_KLARO_KEY,
purposes: ['statistical'],
required: false,
cookies: [
// /*
// you an either only provide a cookie name or regular expression (regex) or a list
// consisting of a name or regex, a path and a cookie domain. Providing a path and
// domain is necessary if you have services that set cookies for a path that is not
// "/", or a domain that is not the current domain. If you do not set these values
// properly, the cookie can't be deleted by Klaro, as there is no way to access the
// path or domain of a cookie in JS. Notice that it is not possible to delete
// cookies that were set on a third-party domain, or cookies that have the HTTPOnly
// attribute: https://developer.mozilla.org/en-US/docs/Web/API/Document/cookie#new-
// cookie_domain
// */
//
// /*
// This rule will match cookies that contain the string '_pk_' and that are set on
// the path '/' and the domain 'klaro.kiprotect.com'
// */
[/^_ga.?$/],
[/^_gid$/],
//
// /*
// Same as above, only for the 'localhost' domain
// */
// [/^_pk_.*$/, '/', 'localhost'],
//
// /*
// This rule will match all cookies named 'piwik_ignore' that are set on the path
// '/' on the current domain
// */
// 'piwik_ignore',
],
/*
If 'onlyOnce' is set to 'true', the app will only be executed once regardless
how often the user toggles it on and off. This is relevant e.g. for tracking
scripts that would generate new page view events every time Klaro disables and
re-enables them due to a consent change by the user.
*/
onlyOnce: true,
},
{
name: CAPTCHA_NAME,
purposes: ['registration-password-recovery'],
required: false,
cookies: [
CAPTCHA_COOKIE
],
onAccept: `window.refreshCaptchaScript?.call()`,
onDecline: `window.refreshCaptchaScript?.call()`,
onlyOnce: true,
},
{
name: 'accessibility',
purposes: ['functional'],
required: false,
cookies: [ACCESSIBILITY_COOKIE],
onlyOnce: false,
},
],
};