From 15d5338b9135f8bd277b1189e7849a9c8842cbf7 Mon Sep 17 00:00:00 2001 From: Miguel Cabrerizo <30386061+doncicuto@users.noreply.github.com> Date: Mon, 13 May 2024 16:01:50 +0200 Subject: [PATCH] feat(cnsl): docs link can be customized and custom button is available (#7840) * feat: customize doc link and additional custom link * feat: add e2e tests * fix: update docs * fix: add @peintnermax changes about cache * fix: golangci-lint complains preparation.PrepareCommands --------- Co-authored-by: Max Peintner --- cmd/defaults.yaml | 15 +- .../app/modules/footer/footer.component.html | 6 +- .../app/modules/footer/footer.component.ts | 11 +- .../app/modules/header/header.component.html | 6 +- .../app/modules/header/header.component.scss | 3 +- .../app/modules/header/header.component.ts | 27 ++- .../privacy-policy.component.html | 20 +- .../privacy-policy.component.ts | 31 +++ .../app/modules/settings-grid/settinglinks.ts | 2 +- .../src/app/modules/settings-list/settings.ts | 2 +- console/src/app/services/grpc-auth.service.ts | 50 ++++- console/src/assets/i18n/bg.json | 5 +- console/src/assets/i18n/cs.json | 5 +- console/src/assets/i18n/de.json | 5 +- console/src/assets/i18n/en.json | 7 +- console/src/assets/i18n/es.json | 5 +- console/src/assets/i18n/fr.json | 5 +- console/src/assets/i18n/it.json | 5 +- console/src/assets/i18n/ja.json | 6 +- console/src/assets/i18n/mk.json | 5 +- console/src/assets/i18n/nl.json | 5 +- console/src/assets/i18n/pl.json | 5 +- console/src/assets/i18n/pt.json | 5 +- console/src/assets/i18n/ru.json | 5 +- console/src/assets/i18n/zh.json | 5 +- .../manage/console/default-settings.mdx | 18 +- .../guides/manage/console/organizations.mdx | 2 +- .../img/guides/console/external_links_1.png | Bin 0 -> 52578 bytes .../img/guides/console/external_links_2.png | Bin 0 -> 6527 bytes .../img/guides/console/privacypolicy.png | Bin 28895 -> 0 bytes .../settings/external-links-settings.cy.ts | 104 ++++++++++ .../support/api/external-links-settings.ts | 32 +++ internal/api/grpc/admin/export.go | 11 +- .../grpc/admin/privacy_policy_converter.go | 11 +- .../management/policy_privacy_converter.go | 22 +- internal/api/grpc/policy/privacy_policy.go | 3 + .../grpc/settings/v2/settings_converter.go | 3 + .../settings/v2/settings_converter_test.go | 16 +- .../eventsourcing/eventstore/auth_request.go | 15 +- internal/command/instance.go | 13 +- internal/command/instance_converter.go | 13 +- internal/command/instance_policy_privacy.go | 33 ++- .../command/instance_policy_privacy_model.go | 10 + .../command/instance_policy_privacy_test.go | 132 ++++++++---- internal/command/org_converter.go | 13 +- internal/command/org_policy_privacy.go | 7 +- internal/command/org_policy_privacy_model.go | 10 + internal/command/org_policy_privacy_test.go | 196 ++++++++++++------ internal/command/policy_privacy_model.go | 25 ++- internal/domain/policy_privacy.go | 11 +- internal/query/privacy_policy.go | 42 +++- internal/query/privacy_policy_test.go | 58 ++++-- internal/query/projection/privacy_policy.go | 46 ++-- .../query/projection/privacy_policy_test.go | 38 +++- .../repository/instance/policy_privacy.go | 6 +- internal/repository/org/policy_privacy.go | 6 +- internal/repository/policy/policy_privacy.go | 54 +++-- proto/zitadel/admin.proto | 17 ++ proto/zitadel/management.proto | 36 ++++ proto/zitadel/policy.proto | 19 ++ .../settings/v2beta/legal_settings.proto | 18 ++ 61 files changed, 1000 insertions(+), 286 deletions(-) create mode 100644 docs/static/img/guides/console/external_links_1.png create mode 100644 docs/static/img/guides/console/external_links_2.png delete mode 100644 docs/static/img/guides/console/privacypolicy.png create mode 100644 e2e/cypress/e2e/settings/external-links-settings.cy.ts create mode 100644 e2e/cypress/support/api/external-links-settings.ts diff --git a/cmd/defaults.yaml b/cmd/defaults.yaml index b8d7952be3..ae6b815037 100644 --- a/cmd/defaults.yaml +++ b/cmd/defaults.yaml @@ -14,16 +14,16 @@ Tracing: # for type 'otel' is used for standard [open telemetry](https://opentelemetry.io) # Fraction: 1.0 # Endpoint: 'otel.collector.endpoint' - # + # # type 'log' or '' disables tracing - # + # # for type 'google' # ProjectID: '' # Fraction: 1.0 Type: none # ZITADEL_TRACING_TYPE Fraction: 1.0 # ZITADEL_TRACING_FRACTION # The endpoint of the otel collector endpoint - Endpoint: '' #ZITADEL_TRACING_ENDPOINT + Endpoint: "" #ZITADEL_TRACING_ENDPOINT Telemetry: # As long as Enabled is true, ZITADEL tries to send usage data to the configured Telemetry.Endpoints. @@ -200,7 +200,7 @@ AssetStorage: # The Projections section defines the behavior for the scheduled and synchronous events projections. Projections: - # The maximum duration a transaction remains open + # The maximum duration a transaction remains open # before it spots left folding additional events # and updates the table. TransactionDuration: 500ms # ZITADEL_PROJECTIONS_TRANSACTIONDURATION @@ -264,7 +264,7 @@ Auth: # See Projections.BulkLimit SearchLimit: 1000 # ZITADEL_AUTH_SEARCHLIMIT Spooler: - # See Projections.TransationDuration + # See Projections.TransationDuration TransactionDuration: 10s #ZITADEL_AUTH_SPOOLER_TRANSACTIONDURATION # See Projections.BulkLimit BulkLimit: 100 #ZITADEL_AUTH_SPOOLER_BULKLIMIT @@ -704,6 +704,9 @@ DefaultInstance: PrivacyLink: https://zitadel.com/docs/legal/privacy-policy # ZITADEL_DEFAULTINSTANCE_PRIVACYPOLICY_PRIVACYLINK HelpLink: "" # ZITADEL_DEFAULTINSTANCE_PRIVACYPOLICY_HELPLINK SupportEmail: "" # ZITADEL_DEFAULTINSTANCE_PRIVACYPOLICY_SUPPORTEMAIL + DocsLink: https://zitadel.com/docs # ZITADEL_DEFAULTINSTANCE_PRIVACYPOLICY_DOCSLINK + CustomLink: "" # ZITADEL_DEFAULTINSTANCE_PRIVACYPOLICY_CUSTOMLINK + CustomLinkText: "" # ZITADEL_DEFAULTINSTANCE_PRIVACYPOLICY_CUSTOMLINKTEXT NotificationPolicy: PasswordChange: true # ZITADEL_DEFAULTINSTANCE_NOTIFICATIONPOLICY_PASSWORDCHANGE LabelPolicy: @@ -1432,4 +1435,4 @@ InitProjections: Enabled: true # ZITADEL_INITPROJECTIONS_ENABLED RetryFailedAfter: 100ms # ZITADEL_INITPROJECTIONS_RETRYFAILEDAFTER MaxFailureCount: 2 # ZITADEL_INITPROJECTIONS_MAXFAILURECOUNT - BulkLimit: 1000 # ZITADEL_INITPROJECTIONS_BULKLIMIT \ No newline at end of file + BulkLimit: 1000 # ZITADEL_INITPROJECTIONS_BULKLIMIT diff --git a/console/src/app/modules/footer/footer.component.html b/console/src/app/modules/footer/footer.component.html index fdf2924441..26d863d129 100644 --- a/console/src/app/modules/footer/footer.component.html +++ b/console/src/app/modules/footer/footer.component.html @@ -1,11 +1,11 @@
-
- +
+ {{ 'FOOTER.LINKS.TOS' | translate }} - + {{ 'FOOTER.LINKS.PP' | translate }} diff --git a/console/src/app/modules/footer/footer.component.ts b/console/src/app/modules/footer/footer.component.ts index f7d1a3a148..758917ea4b 100644 --- a/console/src/app/modules/footer/footer.component.ts +++ b/console/src/app/modules/footer/footer.component.ts @@ -8,16 +8,7 @@ import { faXTwitter } from '@fortawesome/free-brands-svg-icons'; templateUrl: './footer.component.html', styleUrls: ['./footer.component.scss'], }) -export class FooterComponent implements OnInit { - public policy?: PrivacyPolicy.AsObject; +export class FooterComponent { public faXTwitter = faXTwitter; constructor(public authService: GrpcAuthService) {} - - ngOnInit(): void { - this.authService.getMyPrivacyPolicy().then((policyResp) => { - if (policyResp.policy) { - this.policy = policyResp.policy; - } - }); - } } diff --git a/console/src/app/modules/header/header.component.html b/console/src/app/modules/header/header.component.html index c436cc4a28..a8c438ae4d 100644 --- a/console/src/app/modules/header/header.component.html +++ b/console/src/app/modules/header/header.component.html @@ -168,7 +168,11 @@ - + + {{ customLinkText }} + + + {{ 'MENU.DOCUMENTATION' | translate }} diff --git a/console/src/app/modules/header/header.component.scss b/console/src/app/modules/header/header.component.scss index 2b219cc0fa..04a9e53d2e 100644 --- a/console/src/app/modules/header/header.component.scss +++ b/console/src/app/modules/header/header.component.scss @@ -224,7 +224,8 @@ flex: 1; } - .doc-link { + .doc-link, + .custom-link { margin-right: 1rem; @media only screen and (max-width: 800px) { diff --git a/console/src/app/modules/header/header.component.ts b/console/src/app/modules/header/header.component.ts index 25463e0c52..720d40cb98 100644 --- a/console/src/app/modules/header/header.component.ts +++ b/console/src/app/modules/header/header.component.ts @@ -1,5 +1,5 @@ import { ConnectedPosition, ConnectionPositionPair } from '@angular/cdk/overlay'; -import { Component, ElementRef, EventEmitter, Input, OnDestroy, Output, ViewChild } from '@angular/core'; +import { Component, ElementRef, EventEmitter, Input, OnDestroy, OnInit, Output, ViewChild } from '@angular/core'; import { Router } from '@angular/router'; import { BehaviorSubject, Observable, of, Subject } from 'rxjs'; import { Org } from 'src/app/proto/generated/zitadel/org_pb'; @@ -8,8 +8,8 @@ import { AuthenticationService } from 'src/app/services/authentication.service'; import { BreadcrumbService, BreadcrumbType } from 'src/app/services/breadcrumb.service'; import { GrpcAuthService } from 'src/app/services/grpc-auth.service'; import { ManagementService } from 'src/app/services/mgmt.service'; - import { ActionKeysType } from '../action-keys/action-keys.component'; +import { GetPrivacyPolicyResponse } from 'src/app/proto/generated/zitadel/management_pb'; @Component({ selector: 'cnsl-header', @@ -31,6 +31,9 @@ export class HeaderComponent implements OnDestroy { private destroy$: Subject = new Subject(); public BreadcrumbType: any = BreadcrumbType; public ActionKeysType: any = ActionKeysType; + public docsLink = 'https://zitadel.com/docs'; + public customLink = ''; + public customLinkText = ''; public positions: ConnectedPosition[] = [ new ConnectionPositionPair({ originX: 'start', originY: 'bottom' }, { overlayX: 'start', overlayY: 'top' }, 0, 10), @@ -47,7 +50,25 @@ export class HeaderComponent implements OnDestroy { public mgmtService: ManagementService, public breadcrumbService: BreadcrumbService, public router: Router, - ) {} + ) { + this.loadData(); + } + + public async loadData(): Promise { + const getData = (): Promise => { + return this.mgmtService.getPrivacyPolicy(); + }; + + getData() + .then((resp) => { + if (resp.policy) { + this.docsLink = resp.policy.docsLink; + this.customLink = resp.policy.customLink; + this.customLinkText = resp.policy.customLinkText; + } + }) + .catch(() => {}); + } public ngOnDestroy() { this.destroy$.next(); diff --git a/console/src/app/modules/policies/privacy-policy/privacy-policy.component.html b/console/src/app/modules/policies/privacy-policy/privacy-policy.component.html index 41bfde9127..037d53389c 100644 --- a/console/src/app/modules/policies/privacy-policy/privacy-policy.component.html +++ b/console/src/app/modules/policies/privacy-policy/privacy-policy.component.html @@ -9,6 +9,7 @@ color="warn" (click)="resetDefault()" mat-stroked-button + data-e2e="reset-button" > {{ 'POLICY.RESET' | translate }} @@ -40,7 +41,23 @@ {{ 'POLICY.PRIVACY_POLICY.SUPPORTEMAIL' | translate }} - + + + + {{ 'POLICY.PRIVACY_POLICY.CUSTOMLINK' | translate }} + + + + + + {{ 'POLICY.PRIVACY_POLICY.CUSTOMLINKTEXT' | translate }} + + + + + {{ 'POLICY.PRIVACY_POLICY.DOCSLINK' | translate }} + +
@@ -53,6 +70,7 @@ color="primary" type="submit" mat-raised-button + data-e2e="save-button" > {{ 'ACTIONS.SAVE' | translate }} diff --git a/console/src/app/modules/policies/privacy-policy/privacy-policy.component.ts b/console/src/app/modules/policies/privacy-policy/privacy-policy.component.ts index 458c0b2728..53f7ab748f 100644 --- a/console/src/app/modules/policies/privacy-policy/privacy-policy.component.ts +++ b/console/src/app/modules/policies/privacy-policy/privacy-policy.component.ts @@ -61,6 +61,9 @@ export class PrivacyPolicyComponent implements OnInit, OnDestroy { privacyLink: ['', []], helpLink: ['', []], supportEmail: ['', []], + docsLink: ['', []], + customLink: ['', []], + customLinkText: ['', []], }); this.canWrite$.pipe(take(1)).subscribe((canWrite) => { @@ -107,6 +110,9 @@ export class PrivacyPolicyComponent implements OnInit, OnDestroy { privacyLink: '', helpLink: '', supportEmail: '', + docsLink: '', + customLink: '', + customLinkText: '', }); } }) @@ -117,6 +123,9 @@ export class PrivacyPolicyComponent implements OnInit, OnDestroy { privacyLink: '', helpLink: '', supportEmail: '', + docsLink: '', + customLink: '', + customLinkText: '', }); }); } @@ -129,11 +138,16 @@ export class PrivacyPolicyComponent implements OnInit, OnDestroy { req.setTosLink(this.form.get('tosLink')?.value); req.setHelpLink(this.form.get('helpLink')?.value); req.setSupportEmail(this.form.get('supportEmail')?.value); + req.setDocsLink(this.form.get('docsLink')?.value); + req.setCustomLink(this.form.get('customLink')?.value); + req.setCustomLinkText(this.form.get('customLinkText')?.value); (this.service as ManagementService) .addCustomPrivacyPolicy(req) .then(() => { this.toast.showInfo('POLICY.PRIVACY_POLICY.SAVED', true); this.loadData(); + // Reload console as links may have changed + this.reloadConsole(); }) .catch((error) => this.toast.showError(error)); } else { @@ -142,12 +156,17 @@ export class PrivacyPolicyComponent implements OnInit, OnDestroy { req.setTosLink(this.form.get('tosLink')?.value); req.setHelpLink(this.form.get('helpLink')?.value); req.setSupportEmail(this.form.get('supportEmail')?.value); + req.setDocsLink(this.form.get('docsLink')?.value); + req.setCustomLink(this.form.get('customLink')?.value); + req.setCustomLinkText(this.form.get('customLinkText')?.value); (this.service as ManagementService) .updateCustomPrivacyPolicy(req) .then(() => { this.toast.showInfo('POLICY.PRIVACY_POLICY.SAVED', true); this.loadData(); + // Reload console as links may have changed + this.reloadConsole(); }) .catch((error) => this.toast.showError(error)); } @@ -157,12 +176,17 @@ export class PrivacyPolicyComponent implements OnInit, OnDestroy { req.setTosLink(this.form.get('tosLink')?.value); req.setHelpLink(this.form.get('helpLink')?.value); req.setSupportEmail(this.form.get('supportEmail')?.value); + req.setDocsLink(this.form.get('docsLink')?.value); + req.setCustomLink(this.form.get('customLink')?.value); + req.setCustomLinkText(this.form.get('customLinkText')?.value); (this.service as AdminService) .updatePrivacyPolicy(req) .then(() => { this.toast.showInfo('POLICY.PRIVACY_POLICY.SAVED', true); this.loadData(); + // Reload console as links may have changed + this.reloadConsole(); }) .catch((error) => this.toast.showError(error)); } @@ -188,6 +212,7 @@ export class PrivacyPolicyComponent implements OnInit, OnDestroy { .then(() => { setTimeout(() => { this.loadData(); + window.location.reload(); }, 1000); }) .catch((error) => { @@ -209,4 +234,10 @@ export class PrivacyPolicyComponent implements OnInit, OnDestroy { return false; } } + + private reloadConsole(): void { + setTimeout(() => { + window.location.reload(); + }, 1000); + } } diff --git a/console/src/app/modules/settings-grid/settinglinks.ts b/console/src/app/modules/settings-grid/settinglinks.ts index 726677ea73..7f967f865d 100644 --- a/console/src/app/modules/settings-grid/settinglinks.ts +++ b/console/src/app/modules/settings-grid/settinglinks.ts @@ -36,7 +36,7 @@ export const APPEARANCE_GROUP: SettingLinks = { }; export const PRIVACY_POLICY: SettingLinks = { - i18nTitle: 'SETTINGS.LIST.PRIVACYPOLICY', + i18nTitle: 'DESCRIPTIONS.SETTINGS.PRIVACY_POLICY.TITLE', i18nDesc: 'POLICY.PRIVACY_POLICY.DESCRIPTION', iamRouterLink: ['/settings'], orgRouterLink: ['/org-settings'], diff --git a/console/src/app/modules/settings-list/settings.ts b/console/src/app/modules/settings-list/settings.ts index a945a8c7c7..2b24d84e24 100644 --- a/console/src/app/modules/settings-list/settings.ts +++ b/console/src/app/modules/settings-list/settings.ts @@ -187,7 +187,7 @@ export const LOGINTEXTS: SidenavSetting = { export const PRIVACYPOLICY: SidenavSetting = { id: 'privacypolicy', - i18nKey: 'SETTINGS.LIST.PRIVACYPOLICY', + i18nKey: 'DESCRIPTIONS.SETTINGS.PRIVACY_POLICY.TITLE', groupI18nKey: 'SETTINGS.GROUPS.OTHER', requiredRoles: { [PolicyComponentServiceType.MGMT]: ['policy.read'], diff --git a/console/src/app/services/grpc-auth.service.ts b/console/src/app/services/grpc-auth.service.ts index 987721180f..6fc1750d62 100644 --- a/console/src/app/services/grpc-auth.service.ts +++ b/console/src/app/services/grpc-auth.service.ts @@ -27,7 +27,6 @@ import { GetMyPhoneRequest, GetMyPhoneResponse, GetMyPrivacyPolicyRequest, - GetMyPrivacyPolicyResponse, GetMyProfileRequest, GetMyProfileResponse, GetMyUserRequest, @@ -99,11 +98,10 @@ import { ChangeQuery } from '../proto/generated/zitadel/change_pb'; import { MetadataQuery } from '../proto/generated/zitadel/metadata_pb'; import { ListQuery } from '../proto/generated/zitadel/object_pb'; import { Org, OrgFieldName, OrgQuery } from '../proto/generated/zitadel/org_pb'; -import { LabelPolicy } from '../proto/generated/zitadel/policy_pb'; +import { LabelPolicy, PrivacyPolicy } from '../proto/generated/zitadel/policy_pb'; import { Gender, MembershipQuery, User, WebAuthNVerification } from '../proto/generated/zitadel/user_pb'; import { GrpcService } from './grpc.service'; import { StorageKey, StorageLocation, StorageService } from './storage.service'; -import { ThemeService } from './theme.service'; @Injectable({ providedIn: 'root', @@ -137,11 +135,18 @@ export class GrpcAuthService { >(undefined); labelPolicyLoading$: BehaviorSubject = new BehaviorSubject(true); + public privacypolicy$!: Observable; + public privacypolicy: BehaviorSubject = new BehaviorSubject< + PrivacyPolicy.AsObject | undefined + >(undefined); + privacyPolicyLoading$: BehaviorSubject = new BehaviorSubject(true); + public zitadelPermissions: BehaviorSubject = new BehaviorSubject([]); public readonly fetchedZitadelPermissions: BehaviorSubject = new BehaviorSubject(false); public cachedOrgs: BehaviorSubject = new BehaviorSubject([]); private cachedLabelPolicies: { [orgId: string]: LabelPolicy.AsObject } = {}; + private cachedPrivacyPolicies: { [orgId: string]: PrivacyPolicy.AsObject } = {}; constructor( private readonly grpcService: GrpcService, @@ -169,6 +174,25 @@ export class GrpcAuthService { }, }); + this.privacypolicy$ = this.activeOrgChanged.pipe( + switchMap((org) => { + this.privacyPolicyLoading$.next(true); + return from(this.getMyPrivacyPolicy(org ? org.id : '')); + }), + filter((policy) => !!policy), + ); + + this.privacypolicy$.subscribe({ + next: (policy) => { + this.privacypolicy.next(policy); + this.privacyPolicyLoading$.next(false); + }, + error: (error) => { + console.error(error); + this.privacyPolicyLoading$.next(false); + }, + }); + this.user = forkJoin([ of(this.oauthService.getAccessToken()), this.oauthService.events.pipe( @@ -697,7 +721,23 @@ export class GrpcAuthService { } } - public getMyPrivacyPolicy(): Promise { - return this.grpcService.auth.getMyPrivacyPolicy(new GetMyPrivacyPolicyRequest(), null).then((resp) => resp.toObject()); + public getMyPrivacyPolicy(orgIdForCache?: string): Promise { + if (orgIdForCache && this.cachedPrivacyPolicies[orgIdForCache]) { + return Promise.resolve(this.cachedPrivacyPolicies[orgIdForCache]); + } else { + return this.grpcService.auth + .getMyPrivacyPolicy(new GetMyPrivacyPolicyRequest(), null) + .then((resp) => resp.toObject()) + .then((resp) => { + if (resp.policy) { + if (orgIdForCache) { + this.cachedPrivacyPolicies[orgIdForCache] = resp.policy; + } + return Promise.resolve(resp.policy); + } else { + return Promise.reject(); + } + }); + } } } diff --git a/console/src/assets/i18n/bg.json b/console/src/assets/i18n/bg.json index 2dd9ab1a5e..8cbc3ba790 100644 --- a/console/src/assets/i18n/bg.json +++ b/console/src/assets/i18n/bg.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Външни връзки", - "DESCRIPTION": "Насочете вашите потребители към персонализирани външни ресурси, показани на страницата за вход. Потребителите трябва да приемат Условията за ползване и Политиката за поверителност, преди да могат да се регистрират." + "DESCRIPTION": "Насочете потребителите си към персонализирани външни ресурси, показани на страницата за вход. Потребителите трябва да приемат Общите условия и Политиката за поверителност, преди да могат да се регистрират. Променете връзката към вашата документация или задайте празен низ, за ​​да скриете бутона за документация от конзолата. Добавете персонализирана външна връзка и персонализиран текст за тази връзка в конзолата или ги оставете празни, за да скриете този бутон." }, "SMTP_PROVIDER": { "TITLE": "Настройки на SMTP", @@ -1564,6 +1564,9 @@ "POLICYLINK": "Връзка към Политика за поверителност", "HELPLINK": "Връзка към Помощ", "SUPPORTEMAIL": "Имейл за поддръжка", + "DOCSLINK": "Връзка към документи (Console)", + "CUSTOMLINK": "Персонализирана връзка (Console)", + "CUSTOMLINKTEXT": "Персонализиран текст на връзката (Console)", "SAVED": "Запазено успешно!", "RESET_TITLE": "Възстановяване на стойностите по подразбиране", "RESET_DESCRIPTION": "На път сте да възстановите връзките по подразбиране за TOS и Политика за поверителност. " diff --git a/console/src/assets/i18n/cs.json b/console/src/assets/i18n/cs.json index dbbd7ee2e9..197d821b41 100644 --- a/console/src/assets/i18n/cs.json +++ b/console/src/assets/i18n/cs.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Externí odkazy", - "DESCRIPTION": "Navede vaše uživatele k vlastním externím zdrojům zobrazeným na přihlašovací stránce. Uživatelé musí přijmout Podmínky služby a Zásady ochrany osobních údajů, než se mohou zaregistrovat." + "DESCRIPTION": "Naveďte své uživatele k vlastním externím zdrojům zobrazeným na přihlašovací stránce. Než se uživatelé mohou zaregistrovat, musí přijmout podmínky služby a zásady ochrany osobních údajů. Změňte odkaz na dokumentaci nebo nastavte prázdný řetězec, abyste skryli tlačítko dokumentace z konzoly. Přidejte vlastní externí odkaz a vlastní text pro tento odkaz v konzole nebo je nastavte na prázdné, abyste toto tlačítko skryli." }, "SMTP_PROVIDER": { "TITLE": "Nastavení SMTP", @@ -1571,6 +1571,9 @@ "POLICYLINK": "Odkaz na Zásady ochrany osobních údajů", "HELPLINK": "Odkaz na pomoc", "SUPPORTEMAIL": "E-mailová podpora", + "DOCSLINK": "Odkaz na Dokumenty (Console)", + "CUSTOMLINK": "Vlastní odkaz (Console)", + "CUSTOMLINKTEXT": "Text vlastního odkazu (Console)", "SAVED": "Úspěšně uloženo!", "RESET_TITLE": "Obnovit výchozí hodnoty", "RESET_DESCRIPTION": "Chystáte se obnovit výchozí odkazy pro Podmínky služby a Zásady ochrany osobních údajů. Opravdu chcete pokračovat?" diff --git a/console/src/assets/i18n/de.json b/console/src/assets/i18n/de.json index 97002aad5e..ff8140f414 100644 --- a/console/src/assets/i18n/de.json +++ b/console/src/assets/i18n/de.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Externe Links", - "DESCRIPTION": "Leite deine Benutzer zu benutzerdefinierten externen Ressourcen, die auf der Anmeldeseite angezeigt werden. Benutzer müssen die Allgemeinen Geschäftsbedingungen und die Datenschutzrichtlinie akzeptieren, bevor sie sich anmelden können." + "DESCRIPTION": "Leiten Sie Ihre Benutzer zu benutzerdefinierten externen Ressourcen, die auf der Anmeldeseite angezeigt werden. Benutzer müssen die Nutzungsbedingungen und Datenschutzrichtlinien akzeptieren, bevor sie sich anmelden können. Ändern Sie den Link zu Ihrer Dokumentation oder legen Sie eine leere Zeichenfolge fest, um die Dokumentationsschaltfläche in der Konsole auszublenden. Fügen Sie in der Konsole einen benutzerdefinierten externen Link und einen benutzerdefinierten Text für diesen Link hinzu oder setzen Sie sie leer, um diese Schaltfläche auszublenden." }, "SMTP_PROVIDER": { "TITLE": "SMTP-Einstellungen", @@ -1570,6 +1570,9 @@ "POLICYLINK": "Link zur den Datenschutzrichtlinien", "HELPLINK": "Link zur Hilfestellung", "SUPPORTEMAIL": "Support E-Mail", + "DOCSLINK": "Link zu Dokumenten (Console)", + "CUSTOMLINK": "Benutzerdefinierter Link (Console)", + "CUSTOMLINKTEXT": "Benutzerdefinierter Linktext (Console)", "SAVED": "Saved successfully!", "RESET_TITLE": "Standardwerte wiederherstellen", "RESET_DESCRIPTION": "Sie sind im Begriff die Standardlinks für die AGBs und Datenschutzrichtlinie wiederherzustellen. Wollen Sie fortfahren?" diff --git a/console/src/assets/i18n/en.json b/console/src/assets/i18n/en.json index 370effeb71..f779856b61 100644 --- a/console/src/assets/i18n/en.json +++ b/console/src/assets/i18n/en.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "External Links", - "DESCRIPTION": "Guide your users to custom external resources shown on the login page. Users need to accept the Terms of Service and Privacy Policy before they can sign up." + "DESCRIPTION": "Guide your users to custom external resources shown on the login page. Users need to accept the Terms of Service and Privacy Policy before they can sign up. Change the link to your documentation or set an empty string to hide the documentation button from the console. Add a custom external link and a custom text for that link in the console, or set them empty to hide that button." }, "SMTP_PROVIDER": { "TITLE": "SMTP Settings", @@ -1335,7 +1335,7 @@ "DOMAIN": "Domain settings", "LOGINTEXTS": "Login Interface Texts", "BRANDING": "Branding", - "PRIVACYPOLICY": "Privacy Policy", + "PRIVACYPOLICY": "External links", "OIDC": "OIDC Token lifetime and expiration", "SECRETS": "Secret Generator", "SECURITY": "Security settings", @@ -1571,6 +1571,9 @@ "POLICYLINK": "Link to Privacy Policy", "HELPLINK": "Link to Help", "SUPPORTEMAIL": "Support Email", + "DOCSLINK": "Docs Link (Console)", + "CUSTOMLINK": "Custom Link (Console)", + "CUSTOMLINKTEXT": "Custom Link Text (Console)", "SAVED": "Saved successfully!", "RESET_TITLE": "Restore Default Values", "RESET_DESCRIPTION": "You are about to restore the default Links for TOS and Privacy Policy. Do you really want to continue?" diff --git a/console/src/assets/i18n/es.json b/console/src/assets/i18n/es.json index b134c4a1fa..e85c698348 100644 --- a/console/src/assets/i18n/es.json +++ b/console/src/assets/i18n/es.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Enlaces Externos", - "DESCRIPTION": "Guía a tus usuarios hacia recursos externos personalizados mostrados en la página de inicio de sesión. Los usuarios necesitan aceptar los Términos de Servicio y la Política de Privacidad antes de que puedan registrarse." + "DESCRIPTION": "Guía a tus usuarios a recursos externos personalizados que se muestran en la página de inicio de sesión. Los usuarios deben aceptar los Términos de servicio y la Política de privacidad antes de poder registrarse. Cambia el enlace a tu documentación o introduce una cadena de texto vacía para ocultar el botón de documentación de la consola. Agrega un enlace externo personalizado y un texto personalizado para dicho enlace en la consola, o déjalos vacíos para ocultar ese botón." }, "SMTP_PROVIDER": { "TITLE": "Configuración de SMTP", @@ -1572,6 +1572,9 @@ "POLICYLINK": "Enlace a Política de privacidad", "HELPLINK": "Enlace de ayuda", "SUPPORTEMAIL": "Email de soporte", + "DOCSLINK": "Enlace de documentos (Console)", + "CUSTOMLINK": "Enlace personalizado (Console)", + "CUSTOMLINKTEXT": "Texto de enlace personalizado (Console)", "SAVED": "¡Se guardó con éxito!", "RESET_TITLE": "Restaurar valores por defecto", "RESET_DESCRIPTION": "Estás a punto de restaurar los enlaces por defecto para los TDS y la política de privacida. ¿Quieres continuar?" diff --git a/console/src/assets/i18n/fr.json b/console/src/assets/i18n/fr.json index cb96599cf9..95cda8bd48 100644 --- a/console/src/assets/i18n/fr.json +++ b/console/src/assets/i18n/fr.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Liens Externes", - "DESCRIPTION": "Guide tes utilisateurs vers des ressources externes personnalisées affichées sur la page de connexion. Les utilisateurs doivent accepter les Termes de Service et la Politique de Confidentialité avant de pouvoir s'inscrire." + "DESCRIPTION": "Guidez vos utilisateurs vers des ressources externes personnalisées affichées sur la page de connexion. Les utilisateurs doivent accepter les conditions d'utilisation et la politique de confidentialité avant de pouvoir s'inscrire. Modifiez le lien vers votre documentation ou définissez une chaîne vide pour masquer le bouton de documentation de la console. Ajoutez un lien externe personnalisé et un texte personnalisé pour ce lien dans la console, ou définissez-les vides pour masquer ce bouton." }, "SMTP_PROVIDER": { "TITLE": "Paramètres SMTP", @@ -1570,6 +1570,9 @@ "POLICYLINK": "Lien vers la politique de confidentialité", "HELPLINK": "Lien vers l'aide", "SUPPORTEMAIL": "E-mail d'assistance", + "DOCSLINK": "Lien Docs (Console)", + "CUSTOMLINK": "Lien personnalisé (Console)", + "CUSTOMLINKTEXT": "Texte de lien personnalisé (Console)", "SAVED": "Enregistré avec succès !", "RESET_TITLE": "Restaurer les valeurs par défaut", "RESET_DESCRIPTION": "Vous êtes sur le point de restaurer les liens par défaut pour les CGS et la politique de confidentialité. Voulez-vous vraiment continuer ?" diff --git a/console/src/assets/i18n/it.json b/console/src/assets/i18n/it.json index ae2f2fd43d..2fe90b412c 100644 --- a/console/src/assets/i18n/it.json +++ b/console/src/assets/i18n/it.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Link Esterni", - "DESCRIPTION": "Guida i tuoi utenti verso risorse esterne personalizzate mostrate nella pagina di login. Gli utenti devono accettare i Termini di Servizio e la Politica sulla Privacy prima che possano iscriversi." + "DESCRIPTION": "Guida i tuoi utenti alle risorse esterne personalizzate mostrate nella pagina di accesso. Gli utenti devono accettare i Termini di servizio e l'Informativa sulla privacy prima di potersi registrare. Cambia il collegamento alla tua documentazione o imposta una stringa vuota per nascondere il pulsante della documentazione dalla console. Aggiungi un collegamento esterno personalizzato e un testo personalizzato per quel collegamento nella console oppure impostali vuoti per nascondere quel pulsante." }, "SMTP_PROVIDER": { "TITLE": "Impostazioni SMTP", @@ -1570,6 +1570,9 @@ "POLICYLINK": "Link all'informativa sulla privacy", "HELPLINK": "link per l'aiuto", "SUPPORTEMAIL": "e-mail di supporto", + "DOCSLINK": "Collegamento a Documenti (Console)", + "CUSTOMLINK": "Collegamento personalizzato (Console)", + "CUSTOMLINKTEXT": "Testo del collegamento personalizzato (Console)", "SAVED": "Salvato con successo!", "RESET_TITLE": "Ripristina i valori predefiniti", "RESET_DESCRIPTION": "Stai per ripristinare i link predefiniti per i TOS e l'informativa sulla privacy. Vuoi davvero continuare?" diff --git a/console/src/assets/i18n/ja.json b/console/src/assets/i18n/ja.json index 65eb2615d7..d6ea29dca4 100644 --- a/console/src/assets/i18n/ja.json +++ b/console/src/assets/i18n/ja.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "外部リンク", - "DESCRIPTION": "ログインページに表示されるカスタム外部リソースへのユーザーガイドです。ユーザーは、サインアップする前に利用規約とプライバシーポリシーを受け入れる必要があります。" + "DESCRIPTION": "ログイン ページに表示されるカスタム外部リソースにユーザーを誘導します。ユーザーはサインアップする前に、サービス利用規約とプライバシー ポリシーに同意する必要があります。ドキュメントへのリンクを変更するか、空の文字列を設定してコンソールからドキュメント ボタンを非表示にします。カスタム外部リンクとそのリンクのカスタム テキストをコンソールに追加するか、それらを空に設定してそのボタンを非表示にします。" }, "SMTP_PROVIDER": { "TITLE": "SMTP設定", @@ -1566,6 +1566,10 @@ "TOSLINK": "利用規約へのリンク", "POLICYLINK": "プライバシーポリシーへのリンク", "HELPLINK": "ヘルプへのリンク", + "SUPPORTEMAIL": "サポートメール", + "DOCSLINK": "ドキュメントリンク (Console)", + "CUSTOMLINK": "カスタムリンク(Console)", + "CUSTOMLINKTEXT": "カスタム リンク テキスト (Console)", "SAVED": "正常に保存されました！", "RESET_TITLE": "デフォルト値を復元する", "RESET_DESCRIPTION": "TOSおよびプライバシーポリシーのデフォルトリンクを復元しようとしています。本当によろしいですか？" diff --git a/console/src/assets/i18n/mk.json b/console/src/assets/i18n/mk.json index 6df94a7445..8e2d5376cd 100644 --- a/console/src/assets/i18n/mk.json +++ b/console/src/assets/i18n/mk.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Надворешни врски", - "DESCRIPTION": "Упатете ги вашите корисници кон прилагодени надворешни ресурси прикажани на страницата за најава. Корисниците треба да ги прифатат условите за користење и политиката за приватност пред да се регистрираат." + "DESCRIPTION": "Водете ги вашите корисници до сопствени надворешни ресурси прикажани на страницата за најавување. Корисниците треба да ги прифатат Условите за користење и Политиката за приватност пред да можат да се регистрираат. Променете ја врската до вашата документација или поставете празна низа за да го скриете копчето за документација од конзолата. Додајте приспособена надворешна врска и прилагоден текст за таа врска во конзолата или поставете ги празни за да го скриете тоа копче." }, "SMTP_PROVIDER": { "TITLE": "SMTP поставки", @@ -1572,6 +1572,9 @@ "POLICYLINK": "Линк кон Политиката за приватност", "HELPLINK": "Линк кон Помош", "SUPPORTEMAIL": "Е-пошта за поддршка", + "DOCSLINK": "Врска за документи (Console)", + "CUSTOMLINK": "Прилагодена врска (Console)", + "CUSTOMLINKTEXT": "Текст за приспособена врска (Console)", "SAVED": "Успешно зачувано!", "RESET_TITLE": "Врати на стандардни вредности", "RESET_DESCRIPTION": "Се подготвувате да ги вратите стандардните линкови за Условите за користење и Политиката за приватност. Дали сте сигурни дека сакате да продолжите?" diff --git a/console/src/assets/i18n/nl.json b/console/src/assets/i18n/nl.json index f31731eefc..2fecd6c057 100644 --- a/console/src/assets/i18n/nl.json +++ b/console/src/assets/i18n/nl.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Externe links", - "DESCRIPTION": "Leid je gebruikers naar aangepaste externe bronnen die worden getoond op de inlogpagina. Gebruikers moeten de Algemene Voorwaarden en het Privacybeleid accepteren voordat ze zich kunnen aanmelden." + "DESCRIPTION": "Leid uw gebruikers naar aangepaste externe bronnen die op de inlogpagina worden weergegeven. Gebruikers moeten de Servicevoorwaarden en het Privacybeleid accepteren voordat ze zich kunnen aanmelden. Wijzig de link naar uw documentatie of stel een lege string in om de documentatieknop voor de console te verbergen. Voeg een aangepaste externe link en een aangepaste tekst voor die link toe in de console, of stel ze leeg om die knop te verbergen." }, "SMTP_PROVIDER": { "TITLE": "SMTP-instellingen", @@ -1571,6 +1571,9 @@ "POLICYLINK": "Link naar Privacybeleid", "HELPLINK": "Link naar Help", "SUPPORTEMAIL": "Ondersteuning Email", + "DOCSLINK": "Documentenlink (Console)", + "CUSTOMLINK": "Aangepaste link (Console)", + "CUSTOMLINKTEXT": "Aangepaste linktekst (Console)", "SAVED": "Succesvol opgeslagen!", "RESET_TITLE": "Herstel Standaard Waarden", "RESET_DESCRIPTION": "U staat op het punt de standaard Links voor TOS en Privacybeleid te herstellen. Weet u zeker dat u wilt doorgaan?" diff --git a/console/src/assets/i18n/pl.json b/console/src/assets/i18n/pl.json index 1857872e2f..40b772d3af 100644 --- a/console/src/assets/i18n/pl.json +++ b/console/src/assets/i18n/pl.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Linki zewnętrzne", - "DESCRIPTION": "Przekieruj użytkowników do niestandardowych zasobów zewnętrznych pokazanych na stronie logowania. Użytkownicy muszą zaakceptować Warunki korzystania z usługi i Politykę prywatności, zanim będą mogli się zarejestrować." + "DESCRIPTION": "Poprowadź użytkowników do niestandardowych zasobów zewnętrznych wyświetlanych na stronie logowania. Użytkownicy muszą zaakceptować Warunki świadczenia usług i Politykę prywatności, zanim będą mogli się zarejestrować. Zmień łącze do dokumentacji lub ustaw pusty ciąg, aby ukryć przycisk dokumentacji w konsoli. Dodaj niestandardowy link zewnętrzny i niestandardowy tekst dla tego łącza w konsoli lub ustaw je puste, aby ukryć ten przycisk." }, "SMTP_PROVIDER": { "TITLE": "Ustawienia SMTP", @@ -1570,6 +1570,9 @@ "POLICYLINK": "Link do polityki prywatności", "HELPLINK": "Link do pomocy", "SUPPORTEMAIL": "E-mail wsparcia", + "DOCSLINK": "Link do Dokumentów (Console)", + "CUSTOMLINK": "Link niestandardowy (Console)", + "CUSTOMLINKTEXT": "Niestandardowy tekst łącza (Console)", "SAVED": "Pomyślnie zapisano!", "RESET_TITLE": "Przywróć wartości domyślne", "RESET_DESCRIPTION": "Masz zamiar przywrócić domyślne linki dla TOS i polityki prywatności. Czy na pewno chcesz kontynuować?" diff --git a/console/src/assets/i18n/pt.json b/console/src/assets/i18n/pt.json index 929b137fc7..17263c72f5 100644 --- a/console/src/assets/i18n/pt.json +++ b/console/src/assets/i18n/pt.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Links Externos", - "DESCRIPTION": "Guie seus usuários para recursos externos personalizados mostrados na página de login. Os usuários precisam aceitar os Termos de Serviço e a Política de Privacidade antes de poderem se inscrever." + "DESCRIPTION": "Oriente seus usuários sobre recursos externos personalizados mostrados na página de login. Os usuários precisam aceitar os Termos de Serviço e a Política de Privacidade antes de se inscreverem. Altere o link para sua documentação ou defina uma string vazia para ocultar o botão de documentação do console. Adicione um link externo personalizado e um texto personalizado para esse link no console ou deixe-os vazios para ocultar esse botão." }, "SMTP_PROVIDER": { "TITLE": "Configurações de SMTP", @@ -1572,6 +1572,9 @@ "POLICYLINK": "Link para a Política de Privacidade", "HELPLINK": "Link para Ajuda", "SUPPORTEMAIL": "E-mail de suporte", + "DOCSLINK": "Link do Documentos (Console)", + "CUSTOMLINK": "Link personalizado (Console)", + "CUSTOMLINKTEXT": "Texto do link personalizado (Console)", "SAVED": "Salvo com sucesso!", "RESET_TITLE": "Restaurar valores padrão", "RESET_DESCRIPTION": "Você está prestes a restaurar os Links padrão para TOS e Política de Privacidade. Deseja realmente continuar?" diff --git a/console/src/assets/i18n/ru.json b/console/src/assets/i18n/ru.json index eda731d47f..e408d47930 100644 --- a/console/src/assets/i18n/ru.json +++ b/console/src/assets/i18n/ru.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "Внешние ссылки", - "DESCRIPTION": "Направьте ваших пользователей к пользовательским внешним ресурсам, показанным на странице входа. Пользователи должны принять Условия обслуживания и Политику конфиденциальности, прежде чем они смогут зарегистрироваться." + "DESCRIPTION": "Guide your users to custom external resources shown on the login page. Users need to accept the Terms of Service and Privacy Policy before they can sign up. Change the link to your documentation or set an empty string to hide the documentation button from the console. Add a custom external link and a custom text for that link in the console, or set them empty to hide that button." }, "SMTP_PROVIDER": { "TITLE": "Настройки SMTP", @@ -1626,6 +1626,9 @@ "POLICYLINK": "Ссылка на Политику конфиденциальности", "HELPLINK": "Ссылка на Помощь", "SUPPORTEMAIL": "Электронная почта поддержки", + "DOCSLINK": "Ссылка на Документы (Console)", + "CUSTOMLINK": "Пользовательская ссылка (Console)", + "CUSTOMLINKTEXT": "Пользовательский текст ссылки (Console)", "SAVED": "Успешно сохранено!", "RESET_TITLE": "Восстановить значения по умолчанию", "RESET_DESCRIPTION": "Вы собираетесь восстановить ссылки по умолчанию для Пользовательского соглашения и Политики конфиденциальности. Вы действительно хотите продолжить?" diff --git a/console/src/assets/i18n/zh.json b/console/src/assets/i18n/zh.json index 005a81480d..9b9b820bb7 100644 --- a/console/src/assets/i18n/zh.json +++ b/console/src/assets/i18n/zh.json @@ -129,7 +129,7 @@ }, "PRIVACY_POLICY": { "TITLE": "外部链接", - "DESCRIPTION": "引导您的用户到登录页面上显示的自定义外部资源。用户需要在注册前接受服务条款和隐私政策。" + "DESCRIPTION": "引导您的用户访问登录页面上显示的自定义外部资源。用户需要先接受服务条款和隐私政策，然后才能注册。更改文档的链接或设置空字符串以在控制台中隐藏文档按钮。在控制台中添加自定义外部链接和该链接的自定义文本，或将它们设置为空以隐藏该按钮。" }, "SMTP_PROVIDER": { "TITLE": "SMTP设置", @@ -1569,6 +1569,9 @@ "POLICYLINK": "链接到隐私政策", "HELPLINK": "链接到帮助", "SUPPORTEMAIL": "支持邮箱", + "DOCSLINK": "文档链接（Console）", + "CUSTOMLINK": "自定义链接（Console）", + "CUSTOMLINKTEXT": "自定义链接文本（Console）", "SAVED": "保存成功！", "RESET_TITLE": "恢复默认值", "RESET_DESCRIPTION": "您即将恢复 TOS 和隐私政策的默认链接。你真的要继续吗？" diff --git a/docs/docs/guides/manage/console/default-settings.mdx b/docs/docs/guides/manage/console/default-settings.mdx index 4a0090a7c0..810ca5d0f3 100644 --- a/docs/docs/guides/manage/console/default-settings.mdx +++ b/docs/docs/guides/manage/console/default-settings.mdx @@ -26,8 +26,7 @@ When you configure your default settings, you can set the following: - [**Branding**](#branding): Appearance of the login interface. - [**Message Texts**](#message-texts): Text and internationalization for emails - [**Login Interface Texts**](#login-interface-texts): Text and internationalization for the login interface -- [**Languages**](#languages): Select which supported langauges are shown to your users. Set the default language if no context is provided. -- [**Privacy Policy**](#privacy-policy-and-tos): Links to your own Terms of Service and Privacy Policy regulations. Link to Help Page. +- [**External Links**](#external-links): Links to your own Terms of Service and Privacy Policy regulations, Help Page, Support email, documentation link... - [**OIDC Token Lifetimes and Expiration**](#oidc-token-lifetimes-and-expiration): Token lifetime and expiration settings. - [**Secret Generator**](#secret-generator): Appearance and expiration of the generated codes and secrets used in mails for verification etc. @@ -256,9 +255,10 @@ You can either set this attribute on your whole ZITADEL instance or just on some Please refer to the [configuration guide](/docs/guides/solution-scenarios/configurations#use-email-to-login) for more information. -## Privacy Policy and TOS +## External links With this setting you are able to configure your privacy policy, terms of service, help links and help/support email address. + On register each user has to accept these policies. This policy can be also be overriden by your organizations. @@ -269,8 +269,16 @@ Example: `https://demo.com/tos-{{.Lang}}` Privacy Policy + +Also you can set the link associated to the Documentation button in the console. Set an empty text if you don't want to show a Documentation button in your console. If you need a custom button to be shown in the console you can set the button text and the link associated to the button (if the button text is button no text will be shown). + +Custom button diff --git a/docs/docs/guides/manage/console/organizations.mdx b/docs/docs/guides/manage/console/organizations.mdx index 6763a09670..077ad4023e 100644 --- a/docs/docs/guides/manage/console/organizations.mdx +++ b/docs/docs/guides/manage/console/organizations.mdx @@ -114,7 +114,7 @@ Those settings are the same as on your instance. - [**Branding**](./default-settings#branding): Appearance of the login interface. - [**Message Texts**](./default-settings#message-texts): Text and internationalization for emails - [**Login Interface Texts**](./default-settings#login-interface-texts): Text and internationalization for the login interface -- [**Privacy Policy**](./default-settings#privacy-policy-and-tos): Links to your own Terms of Service and Privacy Policy regulations. Link to Help Page. +- [**External Links**](./default-settings#external-links): Links to your own Terms of Service and Privacy Policy regulations, Help Page, Support email, documentation link... If you need custom branding on a organization (for example in a B2B scenario, where organizations are allowed to use their custom design), navigate back to the home page, choose your organization in the header above, navigate to the organization settings and set the custom design here. diff --git a/docs/static/img/guides/console/external_links_1.png b/docs/static/img/guides/console/external_links_1.png new file mode 100644 index 0000000000000000000000000000000000000000..c14f43218055c3e156ffae43b6452f78dd9760bc GIT binary patch literal 52578 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 s6>Eq^>+Z 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�cyaz7myWXMgl){V3B%Sy@?! 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 { + const externalLinkSettingsPath = `/instance?id=privacypolicy`; + + const tosLink = 'https://zitadel.com/docs/legal/terms-of-service'; + const privacyPolicyLink = 'https://zitadel.com/docs/legal/privacy-policy'; + const helpLink = ''; + const supportEmail = ''; + const customLink = ''; + const customLinkText = ''; + const docsLink = 'https://zitadel.com/docs'; + + beforeEach(`ensure they are set`, () => { + apiAuth().then((apiCallProperties) => { + ensureExternalLinksSettingsSet(apiCallProperties, tosLink, privacyPolicyLink, docsLink); + cy.visit(externalLinkSettingsPath); + }); + }); + + it(`should have default settings`, () => { + cy.get('[formcontrolname="tosLink"]').should('value', tosLink); + cy.get('[formcontrolname="privacyLink"]').should('value', privacyPolicyLink); + cy.get('[formcontrolname="helpLink"]').should('value', helpLink); + cy.get('[formcontrolname="supportEmail"]').should('value', supportEmail); + cy.get('[formcontrolname="customLink"]').should('value', customLink); + cy.get('[formcontrolname="customLinkText"]').should('value', customLinkText); + cy.get('[formcontrolname="docsLink"]').should('value', docsLink); + }); + + it(`should update external links`, () => { + cy.get('[formcontrolname="tosLink"]').clear().type('tosLink2'); + cy.get('[formcontrolname="privacyLink"]').clear().type('privacyLink2'); + cy.get('[formcontrolname="helpLink"]').clear().type('helpLink'); + cy.get('[formcontrolname="supportEmail"]').clear().type('support@example.com'); + cy.get('[formcontrolname="customLink"]').clear().type('customLink'); + cy.get('[formcontrolname="customLinkText"]').clear().type('customLinkText'); + cy.get('[formcontrolname="docsLink"]').clear().type('docsLink'); + cy.get('[data-e2e="save-button"]').click(); + cy.shouldConfirmSuccess(); + }); + + it(`should return to default values`, () => { + cy.get('[formcontrolname="tosLink"]').should('value', tosLink); + cy.get('[formcontrolname="privacyLink"]').should('value', privacyPolicyLink); + cy.get('[formcontrolname="helpLink"]').should('value', helpLink); + cy.get('[formcontrolname="supportEmail"]').should('value', supportEmail); + cy.get('[formcontrolname="customLink"]').should('value', customLink); + cy.get('[formcontrolname="customLinkText"]').should('value', customLinkText); + cy.get('[formcontrolname="docsLink"]').should('value', docsLink); + }); +}); + +describe('instance external link settings', () => { + const externalLinkSettingsPath = `/org-settings?id=privacypolicy`; + + const tosLink = 'https://zitadel.com/docs/legal/terms-of-service'; + const privacyPolicyLink = 'https://zitadel.com/docs/legal/privacy-policy'; + const helpLink = ''; + const supportEmail = ''; + const customLink = ''; + const customLinkText = ''; + const docsLink = 'https://zitadel.com/docs'; + + beforeEach(() => { + cy.context().as('ctx'); + cy.visit(externalLinkSettingsPath); + }); + + it(`should have default settings`, () => { + cy.get('[formcontrolname="tosLink"]').should('value', tosLink); + cy.get('[formcontrolname="privacyLink"]').should('value', privacyPolicyLink); + cy.get('[formcontrolname="helpLink"]').should('value', helpLink); + cy.get('[formcontrolname="supportEmail"]').should('value', supportEmail); + cy.get('[formcontrolname="customLink"]').should('value', customLink); + cy.get('[formcontrolname="customLinkText"]').should('value', customLinkText); + cy.get('[formcontrolname="docsLink"]').should('value', docsLink); + }); + + it(`should update external links`, () => { + cy.get('[formcontrolname="tosLink"]').clear().type('tosLink2'); + cy.get('[formcontrolname="privacyLink"]').clear().type('privacyLink2'); + cy.get('[formcontrolname="helpLink"]').clear().type('helpLink'); + cy.get('[formcontrolname="supportEmail"]').clear().type('support@example.com'); + cy.get('[formcontrolname="customLink"]').clear().type('customLink'); + cy.get('[formcontrolname="customLinkText"]').clear().type('customLinkText'); + cy.get('[formcontrolname="docsLink"]').clear().type('docsLink'); + cy.get('[data-e2e="save-button"]').click(); + cy.shouldConfirmSuccess(); + }); + + it(`should return to default values`, () => { + cy.get('[data-e2e="reset-button"]').click(); + cy.get('[data-e2e="confirm-dialog-button"]').click(); + cy.get('[formcontrolname="tosLink"]').should('value', tosLink); + cy.get('[formcontrolname="privacyLink"]').should('value', privacyPolicyLink); + cy.get('[formcontrolname="helpLink"]').should('value', helpLink); + cy.get('[formcontrolname="supportEmail"]').should('value', supportEmail); + cy.get('[formcontrolname="customLink"]').should('value', customLink); + cy.get('[formcontrolname="customLinkText"]').should('value', customLinkText); + cy.get('[formcontrolname="docsLink"]').should('value', docsLink); + }); +}); diff --git a/e2e/cypress/support/api/external-links-settings.ts b/e2e/cypress/support/api/external-links-settings.ts new file mode 100644 index 0000000000..eb4e30a3a2 --- /dev/null +++ b/e2e/cypress/support/api/external-links-settings.ts @@ -0,0 +1,32 @@ +import { ensureSetting } from './ensure'; +import { API } from './types'; + +export function ensureExternalLinksSettingsSet(api: API, tosLink: string, privacyPolicyLink: string, docsLink: string) { + return ensureSetting( + api, + `${api.adminBaseURL}/policies/privacy`, + (body: any) => { + const result = { + sequence: body.policy?.details?.sequence, + id: body.policy.id, + entity: null, + }; + + if ( + body.policy && + body.policy.tosLink === tosLink && + body.policy.privacyLink === privacyPolicyLink && + body.policy.docsLink === docsLink + ) { + return { ...result, entity: body.policy }; + } + return result; + }, + `${api.adminBaseURL}/policies/privacy`, + { + tosLink, + privacyLink: privacyPolicyLink, + docsLink, + }, + ); +} diff --git a/internal/api/grpc/admin/export.go b/internal/api/grpc/admin/export.go index 13a11c14db..9a8f075c7c 100644 --- a/internal/api/grpc/admin/export.go +++ b/internal/api/grpc/admin/export.go @@ -534,10 +534,13 @@ func (s *Server) getPrivacyPolicy(ctx context.Context, orgID string) (_ *managem } if !queriedPrivacy.IsDefault { return &management_pb.AddCustomPrivacyPolicyRequest{ - TosLink: queriedPrivacy.TOSLink, - PrivacyLink: queriedPrivacy.PrivacyLink, - HelpLink: queriedPrivacy.HelpLink, - SupportEmail: string(queriedPrivacy.SupportEmail), + TosLink: queriedPrivacy.TOSLink, + PrivacyLink: queriedPrivacy.PrivacyLink, + HelpLink: queriedPrivacy.HelpLink, + SupportEmail: string(queriedPrivacy.SupportEmail), + DocsLink: queriedPrivacy.DocsLink, + CustomLink: queriedPrivacy.CustomLink, + CustomLinkText: queriedPrivacy.CustomLinkText, }, nil } return nil, nil diff --git a/internal/api/grpc/admin/privacy_policy_converter.go b/internal/api/grpc/admin/privacy_policy_converter.go index 910267e14e..3cb14dec15 100644 --- a/internal/api/grpc/admin/privacy_policy_converter.go +++ b/internal/api/grpc/admin/privacy_policy_converter.go @@ -7,9 +7,12 @@ import ( func UpdatePrivacyPolicyToDomain(req *admin_pb.UpdatePrivacyPolicyRequest) *domain.PrivacyPolicy { return &domain.PrivacyPolicy{ - TOSLink: req.TosLink, - PrivacyLink: req.PrivacyLink, - HelpLink: req.HelpLink, - SupportEmail: domain.EmailAddress(req.SupportEmail), + TOSLink: req.TosLink, + PrivacyLink: req.PrivacyLink, + HelpLink: req.HelpLink, + SupportEmail: domain.EmailAddress(req.SupportEmail), + DocsLink: req.DocsLink, + CustomLink: req.CustomLink, + CustomLinkText: req.CustomLinkText, } } diff --git a/internal/api/grpc/management/policy_privacy_converter.go b/internal/api/grpc/management/policy_privacy_converter.go index 323c162142..a3c77a8637 100644 --- a/internal/api/grpc/management/policy_privacy_converter.go +++ b/internal/api/grpc/management/policy_privacy_converter.go @@ -7,18 +7,24 @@ import ( func AddPrivacyPolicyToDomain(req *mgmt_pb.AddCustomPrivacyPolicyRequest) *domain.PrivacyPolicy { return &domain.PrivacyPolicy{ - TOSLink: req.TosLink, - PrivacyLink: req.PrivacyLink, - HelpLink: req.HelpLink, - SupportEmail: domain.EmailAddress(req.SupportEmail), + TOSLink: req.TosLink, + PrivacyLink: req.PrivacyLink, + HelpLink: req.HelpLink, + SupportEmail: domain.EmailAddress(req.SupportEmail), + DocsLink: req.DocsLink, + CustomLink: req.CustomLink, + CustomLinkText: req.CustomLinkText, } } func UpdatePrivacyPolicyToDomain(req *mgmt_pb.UpdateCustomPrivacyPolicyRequest) *domain.PrivacyPolicy { return &domain.PrivacyPolicy{ - TOSLink: req.TosLink, - PrivacyLink: req.PrivacyLink, - HelpLink: req.HelpLink, - SupportEmail: domain.EmailAddress(req.SupportEmail), + TOSLink: req.TosLink, + PrivacyLink: req.PrivacyLink, + HelpLink: req.HelpLink, + SupportEmail: domain.EmailAddress(req.SupportEmail), + DocsLink: req.DocsLink, + CustomLink: req.CustomLink, + CustomLinkText: req.CustomLinkText, } } diff --git a/internal/api/grpc/policy/privacy_policy.go b/internal/api/grpc/policy/privacy_policy.go index f86bc48e3f..ab87cd31d9 100644 --- a/internal/api/grpc/policy/privacy_policy.go +++ b/internal/api/grpc/policy/privacy_policy.go @@ -19,5 +19,8 @@ func ModelPrivacyPolicyToPb(policy *query.PrivacyPolicy) *policy_pb.PrivacyPolic policy.ChangeDate, policy.ResourceOwner, ), + DocsLink: policy.DocsLink, + CustomLink: policy.CustomLink, + CustomLinkText: policy.CustomLinkText, } } diff --git a/internal/api/grpc/settings/v2/settings_converter.go b/internal/api/grpc/settings/v2/settings_converter.go index f00bbf0f9d..78c440012a 100644 --- a/internal/api/grpc/settings/v2/settings_converter.go +++ b/internal/api/grpc/settings/v2/settings_converter.go @@ -154,6 +154,9 @@ func legalAndSupportSettingsToPb(current *query.PrivacyPolicy) *settings.LegalAn HelpLink: current.HelpLink, SupportEmail: string(current.SupportEmail), ResourceOwnerType: isDefaultToResourceOwnerTypePb(current.IsDefault), + DocsLink: current.DocsLink, + CustomLink: current.CustomLink, + CustomLinkText: current.CustomLinkText, } } diff --git a/internal/api/grpc/settings/v2/settings_converter_test.go b/internal/api/grpc/settings/v2/settings_converter_test.go index d1cde07b87..078483042a 100644 --- a/internal/api/grpc/settings/v2/settings_converter_test.go +++ b/internal/api/grpc/settings/v2/settings_converter_test.go @@ -316,17 +316,23 @@ func Test_domainSettingsToPb(t *testing.T) { func Test_legalSettingsToPb(t *testing.T) { arg := &query.PrivacyPolicy{ - TOSLink: "http://example.com/tos", - PrivacyLink: "http://example.com/pricacy", - HelpLink: "http://example.com/help", - SupportEmail: "support@zitadel.com", - IsDefault: true, + TOSLink: "http://example.com/tos", + PrivacyLink: "http://example.com/pricacy", + HelpLink: "http://example.com/help", + SupportEmail: "support@zitadel.com", + IsDefault: true, + DocsLink: "http://example.com/docs", + CustomLink: "http://example.com/custom", + CustomLinkText: "Custom", } want := &settings.LegalAndSupportSettings{ TosLink: "http://example.com/tos", PrivacyPolicyLink: "http://example.com/pricacy", HelpLink: "http://example.com/help", SupportEmail: "support@zitadel.com", + DocsLink: "http://example.com/docs", + CustomLink: "http://example.com/custom", + CustomLinkText: "Custom", ResourceOwnerType: settings.ResourceOwnerType_RESOURCE_OWNER_TYPE_INSTANCE, } got := legalAndSupportSettingsToPb(arg) diff --git a/internal/auth/repository/eventsourcing/eventstore/auth_request.go b/internal/auth/repository/eventsourcing/eventstore/auth_request.go index 129369a71f..782a2a83b0 100644 --- a/internal/auth/repository/eventsourcing/eventstore/auth_request.go +++ b/internal/auth/repository/eventsourcing/eventstore/auth_request.go @@ -1286,12 +1286,15 @@ func privacyPolicyToDomain(p *query.PrivacyPolicy) *domain.PrivacyPolicy { CreationDate: p.CreationDate, ChangeDate: p.ChangeDate, }, - State: p.State, - Default: p.IsDefault, - TOSLink: p.TOSLink, - PrivacyLink: p.PrivacyLink, - HelpLink: p.HelpLink, - SupportEmail: p.SupportEmail, + State: p.State, + Default: p.IsDefault, + TOSLink: p.TOSLink, + PrivacyLink: p.PrivacyLink, + HelpLink: p.HelpLink, + SupportEmail: p.SupportEmail, + DocsLink: p.DocsLink, + CustomLink: p.CustomLink, + CustomLinkText: p.CustomLinkText, } } diff --git a/internal/command/instance.go b/internal/command/instance.go index a31c00aadf..852e92ee6f 100644 --- a/internal/command/instance.go +++ b/internal/command/instance.go @@ -81,10 +81,13 @@ type InstanceSetup struct { PasswordChange bool } PrivacyPolicy struct { - TOSLink string - PrivacyLink string - HelpLink string - SupportEmail domain.EmailAddress + TOSLink string + PrivacyLink string + HelpLink string + SupportEmail domain.EmailAddress + DocsLink string + CustomLink string + CustomLinkText string } LabelPolicy struct { PrimaryColor string @@ -270,7 +273,7 @@ func (c *Commands) SetUpInstance(ctx context.Context, setup *InstanceSetup) (str */ prepareAddMultiFactorToDefaultLoginPolicy(instanceAgg, domain.MultiFactorTypeU2FWithPIN), - prepareAddDefaultPrivacyPolicy(instanceAgg, setup.PrivacyPolicy.TOSLink, setup.PrivacyPolicy.PrivacyLink, setup.PrivacyPolicy.HelpLink, setup.PrivacyPolicy.SupportEmail), + prepareAddDefaultPrivacyPolicy(instanceAgg, setup.PrivacyPolicy.TOSLink, setup.PrivacyPolicy.PrivacyLink, setup.PrivacyPolicy.HelpLink, setup.PrivacyPolicy.SupportEmail, setup.PrivacyPolicy.DocsLink, setup.PrivacyPolicy.CustomLink, setup.PrivacyPolicy.CustomLinkText), prepareAddDefaultNotificationPolicy(instanceAgg, setup.NotificationPolicy.PasswordChange), prepareAddDefaultLockoutPolicy(instanceAgg, setup.LockoutPolicy.MaxPasswordAttempts, setup.LockoutPolicy.MaxOTPAttempts, setup.LockoutPolicy.ShouldShowLockoutFailure), diff --git a/internal/command/instance_converter.go b/internal/command/instance_converter.go index 1ed1cc123a..e4e4d2ac4b 100644 --- a/internal/command/instance_converter.go +++ b/internal/command/instance_converter.go @@ -116,11 +116,14 @@ func writeModelToLockoutPolicy(wm *LockoutPolicyWriteModel) *domain.LockoutPolic func writeModelToPrivacyPolicy(wm *PrivacyPolicyWriteModel) *domain.PrivacyPolicy { return &domain.PrivacyPolicy{ - ObjectRoot: writeModelToObjectRoot(wm.WriteModel), - TOSLink: wm.TOSLink, - PrivacyLink: wm.PrivacyLink, - HelpLink: wm.HelpLink, - SupportEmail: wm.SupportEmail, + ObjectRoot: writeModelToObjectRoot(wm.WriteModel), + TOSLink: wm.TOSLink, + PrivacyLink: wm.PrivacyLink, + HelpLink: wm.HelpLink, + SupportEmail: wm.SupportEmail, + DocsLink: wm.DocsLink, + CustomLink: wm.CustomLink, + CustomLinkText: wm.CustomLinkText, } } diff --git a/internal/command/instance_policy_privacy.go b/internal/command/instance_policy_privacy.go index f239bad144..8ef8be4216 100644 --- a/internal/command/instance_policy_privacy.go +++ b/internal/command/instance_policy_privacy.go @@ -12,17 +12,37 @@ import ( "github.com/zitadel/zitadel/internal/zerrors" ) -func (c *Commands) AddDefaultPrivacyPolicy(ctx context.Context, tosLink, privacyLink, helpLink string, supportEmail domain.EmailAddress) (*domain.ObjectDetails, error) { +func (c *Commands) AddDefaultPrivacyPolicy(ctx context.Context, tosLink, privacyLink, helpLink string, supportEmail domain.EmailAddress, docsLink, customLink, customLinkText string) (*domain.ObjectDetails, error) { instanceAgg := instance.NewAggregate(authz.GetInstance(ctx).InstanceID()) - cmds, err := preparation.PrepareCommands(ctx, c.eventstore.Filter, prepareAddDefaultPrivacyPolicy(instanceAgg, tosLink, privacyLink, helpLink, supportEmail)) + + if supportEmail != "" { + if err := supportEmail.Validate(); err != nil { + return nil, err + } + supportEmail = supportEmail.Normalize() + } + + writeModel := NewInstancePrivacyPolicyWriteModel(ctx) + err := c.eventstore.FilterToQueryReducer(ctx, writeModel) if err != nil { return nil, err } - pushedEvents, err := c.eventstore.Push(ctx, cmds...) + if writeModel.State.Exists() { + return nil, zerrors.ThrowAlreadyExists(nil, "INSTANCE-M00rJ", "Errors.Instance.PrivacyPolicy.AlreadyExists") + } + + event := instance.NewPrivacyPolicyAddedEvent(ctx, &instanceAgg.Aggregate, tosLink, privacyLink, helpLink, supportEmail, docsLink, customLink, customLinkText) + + pushedEvents, err := c.eventstore.Push(ctx, event) if err != nil { return nil, err } - return pushedEventsToObjectDetails(pushedEvents), nil + err = AppendAndReduce(writeModel, pushedEvents...) + if err != nil { + return nil, err + } + + return writeModelToObjectDetails(&writeModel.WriteModel), nil } func (c *Commands) ChangeDefaultPrivacyPolicy(ctx context.Context, policy *domain.PrivacyPolicy) (*domain.PrivacyPolicy, error) { @@ -42,7 +62,7 @@ func (c *Commands) ChangeDefaultPrivacyPolicy(ctx context.Context, policy *domai } instanceAgg := InstanceAggregateFromWriteModel(&existingPolicy.PrivacyPolicyWriteModel.WriteModel) - changedEvent, hasChanged := existingPolicy.NewChangedEvent(ctx, instanceAgg, policy.TOSLink, policy.PrivacyLink, policy.HelpLink, policy.SupportEmail) + changedEvent, hasChanged := existingPolicy.NewChangedEvent(ctx, instanceAgg, policy.TOSLink, policy.PrivacyLink, policy.HelpLink, policy.SupportEmail, policy.DocsLink, policy.CustomLink, policy.CustomLinkText) if !hasChanged { return nil, zerrors.ThrowPreconditionFailed(nil, "INSTANCE-9jJfs", "Errors.IAM.PrivacyPolicy.NotChanged") } @@ -89,6 +109,7 @@ func prepareAddDefaultPrivacyPolicy( privacyLink, helpLink string, supportEmail domain.EmailAddress, + docsLink, customLink, customLinkText string, ) preparation.Validation { return func() (preparation.CreateCommands, error) { if supportEmail != "" { @@ -111,7 +132,7 @@ func prepareAddDefaultPrivacyPolicy( return nil, zerrors.ThrowAlreadyExists(nil, "INSTANCE-M00rJ", "Errors.Instance.PrivacyPolicy.AlreadyExists") } return []eventstore.Command{ - instance.NewPrivacyPolicyAddedEvent(ctx, &a.Aggregate, tosLink, privacyLink, helpLink, supportEmail), + instance.NewPrivacyPolicyAddedEvent(ctx, &a.Aggregate, tosLink, privacyLink, helpLink, supportEmail, docsLink, customLink, customLinkText), }, nil }, nil } diff --git a/internal/command/instance_policy_privacy_model.go b/internal/command/instance_policy_privacy_model.go index 24263a05de..630a28b92b 100644 --- a/internal/command/instance_policy_privacy_model.go +++ b/internal/command/instance_policy_privacy_model.go @@ -59,6 +59,7 @@ func (wm *InstancePrivacyPolicyWriteModel) NewChangedEvent( privacyLink, helpLink string, supportEmail domain.EmailAddress, + docsLink, customLink, customLinkText string, ) (*instance.PrivacyPolicyChangedEvent, bool) { changes := make([]policy.PrivacyPolicyChanges, 0) @@ -74,6 +75,15 @@ func (wm *InstancePrivacyPolicyWriteModel) NewChangedEvent( if wm.SupportEmail != supportEmail { changes = append(changes, policy.ChangeSupportEmail(supportEmail)) } + if wm.DocsLink != docsLink { + changes = append(changes, policy.ChangeDocsLink(docsLink)) + } + if wm.CustomLink != customLink { + changes = append(changes, policy.ChangeCustomLink(customLink)) + } + if wm.CustomLinkText != customLinkText { + changes = append(changes, policy.ChangeCustomLinkText(customLinkText)) + } if len(changes) == 0 { return nil, false } diff --git a/internal/command/instance_policy_privacy_test.go b/internal/command/instance_policy_privacy_test.go index a5b8932b38..ed09ba0f53 100644 --- a/internal/command/instance_policy_privacy_test.go +++ b/internal/command/instance_policy_privacy_test.go @@ -20,11 +20,14 @@ func TestCommandSide_AddDefaultPrivacyPolicy(t *testing.T) { eventstore *eventstore.Eventstore } type args struct { - ctx context.Context - tosLink string - privacyLink string - helpLink string - supportEmail domain.EmailAddress + ctx context.Context + tosLink string + privacyLink string + helpLink string + supportEmail domain.EmailAddress + docsLink string + customLink string + customLinkText string } type res struct { want *domain.ObjectDetails @@ -49,17 +52,23 @@ func TestCommandSide_AddDefaultPrivacyPolicy(t *testing.T) { "PrivacyLink", "HelpLink", "support@example.com", + "DocsLink", + "CustomLink", + "Custom", ), ), ), ), }, args: args{ - ctx: context.Background(), - tosLink: "TOSLink", - privacyLink: "PrivacyLink", - helpLink: "HelpLink", - supportEmail: "support@example.com", + ctx: context.Background(), + tosLink: "TOSLink", + privacyLink: "PrivacyLink", + helpLink: "HelpLink", + supportEmail: "support@example.com", + docsLink: "DocsLink", + customLink: "CustomLink", + customLinkText: "Custom", }, res: res{ err: zerrors.IsErrorAlreadyExists, @@ -78,16 +87,22 @@ func TestCommandSide_AddDefaultPrivacyPolicy(t *testing.T) { "PrivacyLink", "HelpLink", "support@example.com", + "DocsLink", + "CustomLink", + "Custom", ), ), ), }, args: args{ - ctx: authz.WithInstanceID(context.Background(), "INSTANCE"), - tosLink: "TOSLink", - privacyLink: "PrivacyLink", - helpLink: "HelpLink", - supportEmail: "support@example.com", + ctx: authz.WithInstanceID(context.Background(), "INSTANCE"), + tosLink: "TOSLink", + privacyLink: "PrivacyLink", + helpLink: "HelpLink", + supportEmail: "support@example.com", + docsLink: "DocsLink", + customLink: "CustomLink", + customLinkText: "Custom", }, res: res{ want: &domain.ObjectDetails{ @@ -103,11 +118,14 @@ func TestCommandSide_AddDefaultPrivacyPolicy(t *testing.T) { ), }, args: args{ - ctx: authz.WithInstanceID(context.Background(), "INSTANCE"), - tosLink: "TOSLink", - privacyLink: "PrivacyLink", - helpLink: "HelpLink", - supportEmail: "wrong email", + ctx: authz.WithInstanceID(context.Background(), "INSTANCE"), + tosLink: "TOSLink", + privacyLink: "PrivacyLink", + helpLink: "HelpLink", + supportEmail: "wrong email", + docsLink: "DocsLink", + customLink: "CustomLink", + customLinkText: "Custom", }, res: res{ err: zerrors.IsErrorInvalidArgument, @@ -126,6 +144,9 @@ func TestCommandSide_AddDefaultPrivacyPolicy(t *testing.T) { "", "", "", + "", + "", + "", ), ), ), @@ -149,7 +170,7 @@ func TestCommandSide_AddDefaultPrivacyPolicy(t *testing.T) { r := &Commands{ eventstore: tt.fields.eventstore, } - got, err := r.AddDefaultPrivacyPolicy(tt.args.ctx, tt.args.tosLink, tt.args.privacyLink, tt.args.helpLink, tt.args.supportEmail) + got, err := r.AddDefaultPrivacyPolicy(tt.args.ctx, tt.args.tosLink, tt.args.privacyLink, tt.args.helpLink, tt.args.supportEmail, tt.args.docsLink, tt.args.customLink, tt.args.customLinkText) if tt.res.err == nil { assert.NoError(t, err) } @@ -192,10 +213,13 @@ func TestCommandSide_ChangeDefaultPrivacyPolicy(t *testing.T) { args: args{ ctx: context.Background(), policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "support@example.com", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "support@example.com", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -215,6 +239,9 @@ func TestCommandSide_ChangeDefaultPrivacyPolicy(t *testing.T) { "PrivacyLink", "HelpLink", "support@example.com", + "DocsLink", + "CustomLink", + "CustomLinkText", ), ), ), @@ -223,10 +250,13 @@ func TestCommandSide_ChangeDefaultPrivacyPolicy(t *testing.T) { args: args{ ctx: context.Background(), policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "support@example.com", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "support@example.com", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -243,10 +273,13 @@ func TestCommandSide_ChangeDefaultPrivacyPolicy(t *testing.T) { args: args{ ctx: context.Background(), policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "wrong email", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "wrong email", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -266,6 +299,9 @@ func TestCommandSide_ChangeDefaultPrivacyPolicy(t *testing.T) { "PrivacyLink", "HelpLink", "support@example.com", + "DocsLink", + "CustomLink", + "CustomLinkText", ), ), ), @@ -275,6 +311,9 @@ func TestCommandSide_ChangeDefaultPrivacyPolicy(t *testing.T) { "PrivacyLinkChanged", "HelpLinkChanged", "support2@example.com", + "DocsLinkChanged", + "CustomLinkChanged", + "CustomLinkTextChanged", ), ), ), @@ -282,10 +321,13 @@ func TestCommandSide_ChangeDefaultPrivacyPolicy(t *testing.T) { args: args{ ctx: context.Background(), policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLinkChanged", - PrivacyLink: "PrivacyLinkChanged", - HelpLink: "HelpLinkChanged", - SupportEmail: "support2@example.com", + TOSLink: "TOSLinkChanged", + PrivacyLink: "PrivacyLinkChanged", + HelpLink: "HelpLinkChanged", + SupportEmail: "support2@example.com", + DocsLink: "DocsLinkChanged", + CustomLink: "CustomLinkChanged", + CustomLinkText: "CustomLinkTextChanged", }, }, res: res{ @@ -295,10 +337,13 @@ func TestCommandSide_ChangeDefaultPrivacyPolicy(t *testing.T) { ResourceOwner: "INSTANCE", InstanceID: "INSTANCE", }, - TOSLink: "TOSLinkChanged", - PrivacyLink: "PrivacyLinkChanged", - HelpLink: "HelpLinkChanged", - SupportEmail: "support2@example.com", + TOSLink: "TOSLinkChanged", + PrivacyLink: "PrivacyLinkChanged", + HelpLink: "HelpLinkChanged", + SupportEmail: "support2@example.com", + DocsLink: "DocsLinkChanged", + CustomLink: "CustomLinkChanged", + CustomLinkText: "CustomLinkTextChanged", }, }, }, @@ -322,7 +367,7 @@ func TestCommandSide_ChangeDefaultPrivacyPolicy(t *testing.T) { } } -func newDefaultPrivacyPolicyChangedEvent(ctx context.Context, tosLink, privacyLink, helpLink, supportEmail string) *instance.PrivacyPolicyChangedEvent { +func newDefaultPrivacyPolicyChangedEvent(ctx context.Context, tosLink, privacyLink, helpLink, supportEmail, docsLink, customLink, customLinkText string) *instance.PrivacyPolicyChangedEvent { event, _ := instance.NewPrivacyPolicyChangedEvent(ctx, &instance.NewAggregate("INSTANCE").Aggregate, []policy.PrivacyPolicyChanges{ @@ -330,6 +375,9 @@ func newDefaultPrivacyPolicyChangedEvent(ctx context.Context, tosLink, privacyLi policy.ChangePrivacyLink(privacyLink), policy.ChangeHelpLink(helpLink), policy.ChangeSupportEmail(domain.EmailAddress(supportEmail)), + policy.ChangeDocsLink(docsLink), + policy.ChangeCustomLink(customLink), + policy.ChangeCustomLinkText(customLinkText), }, ) return event diff --git a/internal/command/org_converter.go b/internal/command/org_converter.go index 667dae1984..e9bd3351f1 100644 --- a/internal/command/org_converter.go +++ b/internal/command/org_converter.go @@ -46,10 +46,13 @@ func orgDomainWriteModelToOrgDomain(wm *OrgDomainWriteModel) *domain.OrgDomain { func orgWriteModelToPrivacyPolicy(wm *OrgPrivacyPolicyWriteModel) *domain.PrivacyPolicy { return &domain.PrivacyPolicy{ - ObjectRoot: writeModelToObjectRoot(wm.PrivacyPolicyWriteModel.WriteModel), - TOSLink: wm.TOSLink, - PrivacyLink: wm.PrivacyLink, - HelpLink: wm.HelpLink, - SupportEmail: wm.SupportEmail, + ObjectRoot: writeModelToObjectRoot(wm.PrivacyPolicyWriteModel.WriteModel), + TOSLink: wm.TOSLink, + PrivacyLink: wm.PrivacyLink, + HelpLink: wm.HelpLink, + SupportEmail: wm.SupportEmail, + DocsLink: wm.DocsLink, + CustomLink: wm.CustomLink, + CustomLinkText: wm.CustomLinkText, } } diff --git a/internal/command/org_policy_privacy.go b/internal/command/org_policy_privacy.go index c4cf6f4591..3e0497ccb4 100644 --- a/internal/command/org_policy_privacy.go +++ b/internal/command/org_policy_privacy.go @@ -58,7 +58,10 @@ func (c *Commands) AddPrivacyPolicy(ctx context.Context, resourceOwner string, p policy.TOSLink, policy.PrivacyLink, policy.HelpLink, - policy.SupportEmail)) + policy.SupportEmail, + policy.DocsLink, + policy.CustomLink, + policy.CustomLinkText)) if err != nil { return nil, err } @@ -91,7 +94,7 @@ func (c *Commands) ChangePrivacyPolicy(ctx context.Context, resourceOwner string } orgAgg := OrgAggregateFromWriteModel(&existingPolicy.PrivacyPolicyWriteModel.WriteModel) - changedEvent, hasChanged := existingPolicy.NewChangedEvent(ctx, orgAgg, policy.TOSLink, policy.PrivacyLink, policy.HelpLink, policy.SupportEmail) + changedEvent, hasChanged := existingPolicy.NewChangedEvent(ctx, orgAgg, policy.TOSLink, policy.PrivacyLink, policy.HelpLink, policy.SupportEmail, policy.DocsLink, policy.CustomLink, policy.CustomLinkText) if !hasChanged { return nil, zerrors.ThrowPreconditionFailed(nil, "Org-4N9fs", "Errors.Org.PrivacyPolicy.NotChanged") } diff --git a/internal/command/org_policy_privacy_model.go b/internal/command/org_policy_privacy_model.go index 262935e0ff..d4b5a8547e 100644 --- a/internal/command/org_policy_privacy_model.go +++ b/internal/command/org_policy_privacy_model.go @@ -60,6 +60,7 @@ func (wm *OrgPrivacyPolicyWriteModel) NewChangedEvent( privacyLink, helpLink string, supportEmail domain.EmailAddress, + docsLink, customLink, customLinkText string, ) (*org.PrivacyPolicyChangedEvent, bool) { changes := make([]policy.PrivacyPolicyChanges, 0) @@ -75,6 +76,15 @@ func (wm *OrgPrivacyPolicyWriteModel) NewChangedEvent( if wm.SupportEmail != supportEmail { changes = append(changes, policy.ChangeSupportEmail(supportEmail)) } + if wm.DocsLink != docsLink { + changes = append(changes, policy.ChangeDocsLink(docsLink)) + } + if wm.CustomLink != customLink { + changes = append(changes, policy.ChangeCustomLink(customLink)) + } + if wm.CustomLinkText != customLinkText { + changes = append(changes, policy.ChangeCustomLinkText(customLinkText)) + } if len(changes) == 0 { return nil, false } diff --git a/internal/command/org_policy_privacy_test.go b/internal/command/org_policy_privacy_test.go index 3b251326d8..147d4d3e56 100644 --- a/internal/command/org_policy_privacy_test.go +++ b/internal/command/org_policy_privacy_test.go @@ -43,10 +43,13 @@ func TestCommandSide_AddPrivacyPolicy(t *testing.T) { args: args{ ctx: context.Background(), policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "support@example.com", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "support@example.com", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -66,7 +69,9 @@ func TestCommandSide_AddPrivacyPolicy(t *testing.T) { "PrivacyLink", "HelpLink", "support@example.com", - ), + "DocsLink", + "CustomLink", + "CustomLinkText"), ), ), ), @@ -75,10 +80,13 @@ func TestCommandSide_AddPrivacyPolicy(t *testing.T) { ctx: context.Background(), orgID: "org1", policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "support@example.com", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "support@example.com", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -98,6 +106,9 @@ func TestCommandSide_AddPrivacyPolicy(t *testing.T) { "PrivacyLink", "HelpLink", "support@example.com", + "DocsLink", + "CustomLink", + "CustomLinkText", ), ), ), @@ -106,10 +117,13 @@ func TestCommandSide_AddPrivacyPolicy(t *testing.T) { ctx: context.Background(), orgID: "org1", policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "support@example.com", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "support@example.com", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -118,10 +132,13 @@ func TestCommandSide_AddPrivacyPolicy(t *testing.T) { AggregateID: "org1", ResourceOwner: "org1", }, - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "support@example.com", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "support@example.com", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, }, @@ -136,10 +153,13 @@ func TestCommandSide_AddPrivacyPolicy(t *testing.T) { ctx: context.Background(), orgID: "org1", policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "wrong email", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "wrong email", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -159,6 +179,9 @@ func TestCommandSide_AddPrivacyPolicy(t *testing.T) { "", "", "", + "", + "", + "", ), ), ), @@ -167,10 +190,13 @@ func TestCommandSide_AddPrivacyPolicy(t *testing.T) { ctx: context.Background(), orgID: "org1", policy: &domain.PrivacyPolicy{ - TOSLink: "", - PrivacyLink: "", - HelpLink: "", - SupportEmail: "", + TOSLink: "", + PrivacyLink: "", + HelpLink: "", + SupportEmail: "", + DocsLink: "", + CustomLink: "", + CustomLinkText: "", }, }, res: res{ @@ -179,10 +205,13 @@ func TestCommandSide_AddPrivacyPolicy(t *testing.T) { AggregateID: "org1", ResourceOwner: "org1", }, - TOSLink: "", - PrivacyLink: "", - HelpLink: "", - SupportEmail: "", + TOSLink: "", + PrivacyLink: "", + HelpLink: "", + SupportEmail: "", + DocsLink: "", + CustomLink: "", + CustomLinkText: "", }, }, }, @@ -235,10 +264,13 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { args: args{ ctx: context.Background(), policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "support@example.com", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "support@example.com", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -257,10 +289,13 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { ctx: context.Background(), orgID: "org1", policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "support@example.com", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "support@example.com", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -280,6 +315,9 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { "PrivacyLink", "HelpLink", "support@example.com", + "DocsLink", + "CustomLink", + "CustomLinkText", ), ), ), @@ -289,10 +327,13 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { ctx: context.Background(), orgID: "org1", policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLink", - PrivacyLink: "PrivacyLink", - HelpLink: "HelpLink", - SupportEmail: "support@example.com", + TOSLink: "TOSLink", + PrivacyLink: "PrivacyLink", + HelpLink: "HelpLink", + SupportEmail: "support@example.com", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -305,10 +346,13 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { ctx: context.Background(), orgID: "org1", policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLinkChange", - PrivacyLink: "PrivacyLinkChange", - HelpLink: "HelpLinkChange", - SupportEmail: "wrong email", + TOSLink: "TOSLinkChange", + PrivacyLink: "PrivacyLinkChange", + HelpLink: "HelpLinkChange", + SupportEmail: "wrong email", + DocsLink: "DocsLink", + CustomLink: "CustomLink", + CustomLinkText: "CustomLinkText", }, }, res: res{ @@ -328,11 +372,14 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { "PrivacyLink", "HelpLink", "support@example.com", + "DocsLink", + "CustomLink", + "CustomLinkText", ), ), ), expectPush( - newPrivacyPolicyChangedEvent(context.Background(), "org1", "TOSLinkChange", "PrivacyLinkChange", "HelpLinkChange", "support2@example.com"), + newPrivacyPolicyChangedEvent(context.Background(), "org1", "TOSLinkChange", "PrivacyLinkChange", "HelpLinkChange", "support2@example.com", "DocsLinkChange", "CustomLinkChange", "CustomLinkTextChange"), ), ), }, @@ -340,10 +387,13 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { ctx: context.Background(), orgID: "org1", policy: &domain.PrivacyPolicy{ - TOSLink: "TOSLinkChange", - PrivacyLink: "PrivacyLinkChange", - HelpLink: "HelpLinkChange", - SupportEmail: "support2@example.com", + TOSLink: "TOSLinkChange", + PrivacyLink: "PrivacyLinkChange", + HelpLink: "HelpLinkChange", + SupportEmail: "support2@example.com", + DocsLink: "DocsLinkChange", + CustomLink: "CustomLinkChange", + CustomLinkText: "CustomLinkTextChange", }, }, res: res{ @@ -352,10 +402,13 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { AggregateID: "org1", ResourceOwner: "org1", }, - TOSLink: "TOSLinkChange", - PrivacyLink: "PrivacyLinkChange", - HelpLink: "HelpLinkChange", - SupportEmail: "support2@example.com", + TOSLink: "TOSLinkChange", + PrivacyLink: "PrivacyLinkChange", + HelpLink: "HelpLinkChange", + SupportEmail: "support2@example.com", + DocsLink: "DocsLinkChange", + CustomLink: "CustomLinkChange", + CustomLinkText: "CustomLinkTextChange", }, }, }, @@ -372,11 +425,14 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { "PrivacyLink", "HelpLink", "support@example.com", + "DocsLink", + "CustomLink", + "CustomLinkText", ), ), ), expectPush( - newPrivacyPolicyChangedEvent(context.Background(), "org1", "", "", "", ""), + newPrivacyPolicyChangedEvent(context.Background(), "org1", "", "", "", "", "", "", ""), ), ), }, @@ -384,10 +440,13 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { ctx: context.Background(), orgID: "org1", policy: &domain.PrivacyPolicy{ - TOSLink: "", - PrivacyLink: "", - HelpLink: "", - SupportEmail: "", + TOSLink: "", + PrivacyLink: "", + HelpLink: "", + SupportEmail: "", + DocsLink: "", + CustomLink: "", + CustomLinkText: "", }, }, res: res{ @@ -396,10 +455,13 @@ func TestCommandSide_ChangePrivacyPolicy(t *testing.T) { AggregateID: "org1", ResourceOwner: "org1", }, - TOSLink: "", - PrivacyLink: "", - HelpLink: "", - SupportEmail: "", + TOSLink: "", + PrivacyLink: "", + HelpLink: "", + SupportEmail: "", + DocsLink: "", + CustomLink: "", + CustomLinkText: "", }, }, }, @@ -484,6 +546,9 @@ func TestCommandSide_RemovePrivacyPolicy(t *testing.T) { "PrivacyLink", "HelpLink", "support@example.com", + "DocsLink", + "CustomLink", + "CustomLinkText", ), ), ), @@ -523,7 +588,7 @@ func TestCommandSide_RemovePrivacyPolicy(t *testing.T) { } } -func newPrivacyPolicyChangedEvent(ctx context.Context, orgID string, tosLink, privacyLink, helpLink, supportEmail string) *org.PrivacyPolicyChangedEvent { +func newPrivacyPolicyChangedEvent(ctx context.Context, orgID string, tosLink, privacyLink, helpLink, supportEmail, docsLink, customLink, customLinkText string) *org.PrivacyPolicyChangedEvent { event, _ := org.NewPrivacyPolicyChangedEvent(ctx, &org.NewAggregate(orgID).Aggregate, []policy.PrivacyPolicyChanges{ @@ -531,6 +596,9 @@ func newPrivacyPolicyChangedEvent(ctx context.Context, orgID string, tosLink, pr policy.ChangePrivacyLink(privacyLink), policy.ChangeHelpLink(helpLink), policy.ChangeSupportEmail(domain.EmailAddress(supportEmail)), + policy.ChangeDocsLink(docsLink), + policy.ChangeCustomLink(customLink), + policy.ChangeCustomLinkText(customLinkText), }, ) return event diff --git a/internal/command/policy_privacy_model.go b/internal/command/policy_privacy_model.go index 1831176d7a..aba64f7f6b 100644 --- a/internal/command/policy_privacy_model.go +++ b/internal/command/policy_privacy_model.go @@ -9,11 +9,14 @@ import ( type PrivacyPolicyWriteModel struct { eventstore.WriteModel - TOSLink string - PrivacyLink string - HelpLink string - SupportEmail domain.EmailAddress - State domain.PolicyState + TOSLink string + PrivacyLink string + HelpLink string + SupportEmail domain.EmailAddress + State domain.PolicyState + DocsLink string + CustomLink string + CustomLinkText string } func (wm *PrivacyPolicyWriteModel) Reduce() error { @@ -25,6 +28,9 @@ func (wm *PrivacyPolicyWriteModel) Reduce() error { wm.HelpLink = e.HelpLink wm.SupportEmail = e.SupportEmail wm.State = domain.PolicyStateActive + wm.DocsLink = e.DocsLink + wm.CustomLink = e.CustomLink + wm.CustomLinkText = e.CustomLinkText case *policy.PrivacyPolicyChangedEvent: if e.PrivacyLink != nil { wm.PrivacyLink = *e.PrivacyLink @@ -38,6 +44,15 @@ func (wm *PrivacyPolicyWriteModel) Reduce() error { if e.SupportEmail != nil { wm.SupportEmail = *e.SupportEmail } + if e.DocsLink != nil { + wm.DocsLink = *e.DocsLink + } + if e.CustomLink != nil { + wm.CustomLink = *e.CustomLink + } + if e.CustomLinkText != nil { + wm.CustomLinkText = *e.CustomLinkText + } case *policy.PrivacyPolicyRemovedEvent: wm.State = domain.PolicyStateRemoved } diff --git a/internal/domain/policy_privacy.go b/internal/domain/policy_privacy.go index 0851582815..7e254bd2da 100644 --- a/internal/domain/policy_privacy.go +++ b/internal/domain/policy_privacy.go @@ -10,8 +10,11 @@ type PrivacyPolicy struct { State PolicyState Default bool - TOSLink string - PrivacyLink string - HelpLink string - SupportEmail EmailAddress + TOSLink string + PrivacyLink string + HelpLink string + SupportEmail EmailAddress + DocsLink string + CustomLink string + CustomLinkText string } diff --git a/internal/query/privacy_policy.go b/internal/query/privacy_policy.go index 5540c34f5f..59394e92b1 100644 --- a/internal/query/privacy_policy.go +++ b/internal/query/privacy_policy.go @@ -26,10 +26,13 @@ type PrivacyPolicy struct { ResourceOwner string State domain.PolicyState - TOSLink string - PrivacyLink string - HelpLink string - SupportEmail domain.EmailAddress + TOSLink string + PrivacyLink string + HelpLink string + SupportEmail domain.EmailAddress + DocsLink string + CustomLink string + CustomLinkText string IsDefault bool } @@ -91,6 +94,18 @@ var ( name: projection.PrivacyPolicyOwnerRemovedCol, table: privacyTable, } + PrivacyColDocsLink = Column{ + name: projection.PrivacyPolicyDocsLinkCol, + table: privacyTable, + } + PrivacyColCustomLink = Column{ + name: projection.PrivacyPolicyCustomLinkCol, + table: privacyTable, + } + PrivacyColCustomLinkText = Column{ + name: projection.PrivacyPolicyCustomLinkTextCol, + table: privacyTable, + } ) func (q *Queries) PrivacyPolicyByOrg(ctx context.Context, shouldTriggerBulk bool, orgID string, withOwnerRemoved bool) (policy *PrivacyPolicy, err error) { @@ -168,6 +183,9 @@ func preparePrivacyPolicyQuery(ctx context.Context, db prepareDatabase) (sq.Sele PrivacyColTOSLink.identifier(), PrivacyColHelpLink.identifier(), PrivacyColSupportEmail.identifier(), + PrivacyColDocsLink.identifier(), + PrivacyColCustomLink.identifier(), + PrivacyColCustomLinkText.identifier(), PrivacyColIsDefault.identifier(), PrivacyColState.identifier(), ). @@ -185,6 +203,9 @@ func preparePrivacyPolicyQuery(ctx context.Context, db prepareDatabase) (sq.Sele &policy.TOSLink, &policy.HelpLink, &policy.SupportEmail, + &policy.DocsLink, + &policy.CustomLink, + &policy.CustomLinkText, &policy.IsDefault, &policy.State, ) @@ -200,10 +221,13 @@ func preparePrivacyPolicyQuery(ctx context.Context, db prepareDatabase) (sq.Sele func (p *PrivacyPolicy) ToDomain() *domain.PrivacyPolicy { return &domain.PrivacyPolicy{ - TOSLink: p.TOSLink, - PrivacyLink: p.PrivacyLink, - HelpLink: p.HelpLink, - SupportEmail: p.SupportEmail, - Default: p.IsDefault, + TOSLink: p.TOSLink, + PrivacyLink: p.PrivacyLink, + HelpLink: p.HelpLink, + SupportEmail: p.SupportEmail, + Default: p.IsDefault, + DocsLink: p.DocsLink, + CustomLink: p.CustomLink, + CustomLinkText: p.CustomLinkText, } } diff --git a/internal/query/privacy_policy_test.go b/internal/query/privacy_policy_test.go index 55671eef6d..ade541d0cc 100644 --- a/internal/query/privacy_policy_test.go +++ b/internal/query/privacy_policy_test.go @@ -13,18 +13,21 @@ import ( ) var ( - preparePrivacyPolicyStmt = `SELECT projections.privacy_policies3.id,` + - ` projections.privacy_policies3.sequence,` + - ` projections.privacy_policies3.creation_date,` + - ` projections.privacy_policies3.change_date,` + - ` projections.privacy_policies3.resource_owner,` + - ` projections.privacy_policies3.privacy_link,` + - ` projections.privacy_policies3.tos_link,` + - ` projections.privacy_policies3.help_link,` + - ` projections.privacy_policies3.support_email,` + - ` projections.privacy_policies3.is_default,` + - ` projections.privacy_policies3.state` + - ` FROM projections.privacy_policies3` + + preparePrivacyPolicyStmt = `SELECT projections.privacy_policies4.id,` + + ` projections.privacy_policies4.sequence,` + + ` projections.privacy_policies4.creation_date,` + + ` projections.privacy_policies4.change_date,` + + ` projections.privacy_policies4.resource_owner,` + + ` projections.privacy_policies4.privacy_link,` + + ` projections.privacy_policies4.tos_link,` + + ` projections.privacy_policies4.help_link,` + + ` projections.privacy_policies4.support_email,` + + ` projections.privacy_policies4.docs_link,` + + ` projections.privacy_policies4.custom_link,` + + ` projections.privacy_policies4.custom_link_text,` + + ` projections.privacy_policies4.is_default,` + + ` projections.privacy_policies4.state` + + ` FROM projections.privacy_policies4` + ` AS OF SYSTEM TIME '-1 ms'` preparePrivacyPolicyCols = []string{ "id", @@ -36,6 +39,9 @@ var ( "tos_link", "help_link", "support_email", + "docs_link", + "custom_link", + "custom_link_text", "is_default", "state", } @@ -87,23 +93,29 @@ func Test_PrivacyPolicyPrepares(t *testing.T) { "tos.ch", "help.ch", "support@example.com", + "zitadel.com/docs", + "zitadel.com", + "Zitadel", true, domain.PolicyStateActive, }, ), }, object: &PrivacyPolicy{ - ID: "pol-id", - CreationDate: testNow, - ChangeDate: testNow, - Sequence: 20211109, - ResourceOwner: "ro", - State: domain.PolicyStateActive, - PrivacyLink: "privacy.ch", - TOSLink: "tos.ch", - HelpLink: "help.ch", - SupportEmail: "support@example.com", - IsDefault: true, + ID: "pol-id", + CreationDate: testNow, + ChangeDate: testNow, + Sequence: 20211109, + ResourceOwner: "ro", + State: domain.PolicyStateActive, + PrivacyLink: "privacy.ch", + TOSLink: "tos.ch", + HelpLink: "help.ch", + SupportEmail: "support@example.com", + DocsLink: "zitadel.com/docs", + CustomLink: "zitadel.com", + CustomLinkText: "Zitadel", + IsDefault: true, }, }, { diff --git a/internal/query/projection/privacy_policy.go b/internal/query/projection/privacy_policy.go index 2bec8fea18..1fb4c4acb8 100644 --- a/internal/query/projection/privacy_policy.go +++ b/internal/query/projection/privacy_policy.go @@ -14,21 +14,24 @@ import ( ) const ( - PrivacyPolicyTable = "projections.privacy_policies3" + PrivacyPolicyTable = "projections.privacy_policies4" - PrivacyPolicyIDCol = "id" - PrivacyPolicyCreationDateCol = "creation_date" - PrivacyPolicyChangeDateCol = "change_date" - PrivacyPolicySequenceCol = "sequence" - PrivacyPolicyStateCol = "state" - PrivacyPolicyIsDefaultCol = "is_default" - PrivacyPolicyResourceOwnerCol = "resource_owner" - PrivacyPolicyInstanceIDCol = "instance_id" - PrivacyPolicyPrivacyLinkCol = "privacy_link" - PrivacyPolicyTOSLinkCol = "tos_link" - PrivacyPolicyHelpLinkCol = "help_link" - PrivacyPolicySupportEmailCol = "support_email" - PrivacyPolicyOwnerRemovedCol = "owner_removed" + PrivacyPolicyIDCol = "id" + PrivacyPolicyCreationDateCol = "creation_date" + PrivacyPolicyChangeDateCol = "change_date" + PrivacyPolicySequenceCol = "sequence" + PrivacyPolicyStateCol = "state" + PrivacyPolicyIsDefaultCol = "is_default" + PrivacyPolicyResourceOwnerCol = "resource_owner" + PrivacyPolicyInstanceIDCol = "instance_id" + PrivacyPolicyPrivacyLinkCol = "privacy_link" + PrivacyPolicyTOSLinkCol = "tos_link" + PrivacyPolicyHelpLinkCol = "help_link" + PrivacyPolicySupportEmailCol = "support_email" + PrivacyPolicyDocsLinkCol = "docs_link" + PrivacyPolicyCustomLinkCol = "custom_link" + PrivacyPolicyCustomLinkTextCol = "custom_link_text" + PrivacyPolicyOwnerRemovedCol = "owner_removed" ) type privacyPolicyProjection struct{} @@ -56,6 +59,9 @@ func (*privacyPolicyProjection) Init() *old_handler.Check { handler.NewColumn(PrivacyPolicyTOSLinkCol, handler.ColumnTypeText), handler.NewColumn(PrivacyPolicyHelpLinkCol, handler.ColumnTypeText), handler.NewColumn(PrivacyPolicySupportEmailCol, handler.ColumnTypeText), + handler.NewColumn(PrivacyPolicyDocsLinkCol, handler.ColumnTypeText, handler.Default("https://zitadel.com/docs")), + handler.NewColumn(PrivacyPolicyCustomLinkCol, handler.ColumnTypeText), + handler.NewColumn(PrivacyPolicyCustomLinkTextCol, handler.ColumnTypeText), handler.NewColumn(PrivacyPolicyOwnerRemovedCol, handler.ColumnTypeBool, handler.Default(false)), }, handler.NewPrimaryKey(PrivacyPolicyInstanceIDCol, PrivacyPolicyIDCol), @@ -132,6 +138,9 @@ func (p *privacyPolicyProjection) reduceAdded(event eventstore.Event) (*handler. handler.NewCol(PrivacyPolicyTOSLinkCol, policyEvent.TOSLink), handler.NewCol(PrivacyPolicyHelpLinkCol, policyEvent.HelpLink), handler.NewCol(PrivacyPolicySupportEmailCol, policyEvent.SupportEmail), + handler.NewCol(PrivacyPolicyDocsLinkCol, policyEvent.DocsLink), + handler.NewCol(PrivacyPolicyCustomLinkCol, policyEvent.CustomLink), + handler.NewCol(PrivacyPolicyCustomLinkTextCol, policyEvent.CustomLinkText), handler.NewCol(PrivacyPolicyIsDefaultCol, isDefault), handler.NewCol(PrivacyPolicyResourceOwnerCol, policyEvent.Aggregate().ResourceOwner), handler.NewCol(PrivacyPolicyInstanceIDCol, policyEvent.Aggregate().InstanceID), @@ -164,6 +173,15 @@ func (p *privacyPolicyProjection) reduceChanged(event eventstore.Event) (*handle if policyEvent.SupportEmail != nil { cols = append(cols, handler.NewCol(PrivacyPolicySupportEmailCol, *policyEvent.SupportEmail)) } + if policyEvent.DocsLink != nil { + cols = append(cols, handler.NewCol(PrivacyPolicyDocsLinkCol, *policyEvent.DocsLink)) + } + if policyEvent.CustomLink != nil { + cols = append(cols, handler.NewCol(PrivacyPolicyCustomLinkCol, *policyEvent.CustomLink)) + } + if policyEvent.CustomLinkText != nil { + cols = append(cols, handler.NewCol(PrivacyPolicyCustomLinkTextCol, *policyEvent.CustomLinkText)) + } return handler.NewUpdateStatement( &policyEvent, cols, diff --git a/internal/query/projection/privacy_policy_test.go b/internal/query/projection/privacy_policy_test.go index 2d768f7e4b..fadd121e73 100644 --- a/internal/query/projection/privacy_policy_test.go +++ b/internal/query/projection/privacy_policy_test.go @@ -32,6 +32,9 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { "tosLink": "http://tos.link", "privacyLink": "http://privacy.link", "helpLink": "http://help.link", + "docsLink": "http://docs.link", + "customLink": "http://custom.link", + "customLinkText": "Custom Link", "supportEmail": "support@example.com"}`), ), org.PrivacyPolicyAddedEventMapper), }, @@ -42,7 +45,7 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { executer: &testExecuter{ executions: []execution{ { - expectedStmt: "INSERT INTO projections.privacy_policies3 (creation_date, change_date, sequence, id, state, privacy_link, tos_link, help_link, support_email, is_default, resource_owner, instance_id) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)", + expectedStmt: "INSERT INTO projections.privacy_policies4 (creation_date, change_date, sequence, id, state, privacy_link, tos_link, help_link, support_email, docs_link, custom_link, custom_link_text, is_default, resource_owner, instance_id) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15)", expectedArgs: []interface{}{ anyArg{}, anyArg{}, @@ -53,6 +56,9 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { "http://tos.link", "http://help.link", domain.EmailAddress("support@example.com"), + "http://docs.link", + "http://custom.link", + "Custom Link", false, "ro-id", "instance-id", @@ -74,6 +80,9 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { "tosLink": "http://tos.link", "privacyLink": "http://privacy.link", "helpLink": "http://help.link", + "docsLink": "http://docs.link", + "customLink": "http://custom.link", + "customLinkText": "Custom Link", "supportEmail": "support@example.com"}`), ), org.PrivacyPolicyChangedEventMapper), }, @@ -83,7 +92,7 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { executer: &testExecuter{ executions: []execution{ { - expectedStmt: "UPDATE projections.privacy_policies3 SET (change_date, sequence, privacy_link, tos_link, help_link, support_email) = ($1, $2, $3, $4, $5, $6) WHERE (id = $7) AND (instance_id = $8)", + expectedStmt: "UPDATE projections.privacy_policies4 SET (change_date, sequence, privacy_link, tos_link, help_link, support_email, docs_link, custom_link, custom_link_text) = ($1, $2, $3, $4, $5, $6, $7, $8, $9) WHERE (id = $10) AND (instance_id = $11)", expectedArgs: []interface{}{ anyArg{}, uint64(15), @@ -91,6 +100,9 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { "http://tos.link", "http://help.link", domain.EmailAddress("support@example.com"), + "http://docs.link", + "http://custom.link", + "Custom Link", "agg-id", "instance-id", }, @@ -116,7 +128,7 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { executer: &testExecuter{ executions: []execution{ { - expectedStmt: "DELETE FROM projections.privacy_policies3 WHERE (id = $1) AND (instance_id = $2)", + expectedStmt: "DELETE FROM projections.privacy_policies4 WHERE (id = $1) AND (instance_id = $2)", expectedArgs: []interface{}{ "agg-id", "instance-id", @@ -142,7 +154,7 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { executer: &testExecuter{ executions: []execution{ { - expectedStmt: "DELETE FROM projections.privacy_policies3 WHERE (instance_id = $1)", + expectedStmt: "DELETE FROM projections.privacy_policies4 WHERE (instance_id = $1)", expectedArgs: []interface{}{ "agg-id", }, @@ -163,6 +175,9 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { "tosLink": "http://tos.link", "privacyLink": "http://privacy.link", "helpLink": "http://help.link", + "docsLink": "http://docs.link", + "customLink": "http://custom.link", + "customLinkText": "Custom Link", "supportEmail": "support@example.com"}`), ), instance.PrivacyPolicyAddedEventMapper), }, @@ -172,7 +187,7 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { executer: &testExecuter{ executions: []execution{ { - expectedStmt: "INSERT INTO projections.privacy_policies3 (creation_date, change_date, sequence, id, state, privacy_link, tos_link, help_link, support_email, is_default, resource_owner, instance_id) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)", + expectedStmt: "INSERT INTO projections.privacy_policies4 (creation_date, change_date, sequence, id, state, privacy_link, tos_link, help_link, support_email, docs_link, custom_link, custom_link_text, is_default, resource_owner, instance_id) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15)", expectedArgs: []interface{}{ anyArg{}, anyArg{}, @@ -183,6 +198,9 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { "http://tos.link", "http://help.link", domain.EmailAddress("support@example.com"), + "http://docs.link", + "http://custom.link", + "Custom Link", true, "ro-id", "instance-id", @@ -204,6 +222,9 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { "tosLink": "http://tos.link", "privacyLink": "http://privacy.link", "helpLink": "http://help.link", + "docsLink": "http://docs.link", + "customLink": "http://custom.link", + "customLinkText": "Custom Link", "supportEmail": "support@example.com"}`), ), instance.PrivacyPolicyChangedEventMapper), }, @@ -213,7 +234,7 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { executer: &testExecuter{ executions: []execution{ { - expectedStmt: "UPDATE projections.privacy_policies3 SET (change_date, sequence, privacy_link, tos_link, help_link, support_email) = ($1, $2, $3, $4, $5, $6) WHERE (id = $7) AND (instance_id = $8)", + expectedStmt: "UPDATE projections.privacy_policies4 SET (change_date, sequence, privacy_link, tos_link, help_link, support_email, docs_link, custom_link, custom_link_text) = ($1, $2, $3, $4, $5, $6, $7, $8, $9) WHERE (id = $10) AND (instance_id = $11)", expectedArgs: []interface{}{ anyArg{}, uint64(15), @@ -221,6 +242,9 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { "http://tos.link", "http://help.link", domain.EmailAddress("support@example.com"), + "http://docs.link", + "http://custom.link", + "Custom Link", "agg-id", "instance-id", }, @@ -246,7 +270,7 @@ func TestPrivacyPolicyProjection_reduces(t *testing.T) { executer: &testExecuter{ executions: []execution{ { - expectedStmt: "DELETE FROM projections.privacy_policies3 WHERE (instance_id = $1) AND (resource_owner = $2)", + expectedStmt: "DELETE FROM projections.privacy_policies4 WHERE (instance_id = $1) AND (resource_owner = $2)", expectedArgs: []interface{}{ "instance-id", "agg-id", diff --git a/internal/repository/instance/policy_privacy.go b/internal/repository/instance/policy_privacy.go index ec374583b7..ff1ed75be3 100644 --- a/internal/repository/instance/policy_privacy.go +++ b/internal/repository/instance/policy_privacy.go @@ -24,6 +24,7 @@ func NewPrivacyPolicyAddedEvent( privacyLink, helpLink string, supportEmail domain.EmailAddress, + docsLink, customLink, customLinkText string, ) *PrivacyPolicyAddedEvent { return &PrivacyPolicyAddedEvent{ PrivacyPolicyAddedEvent: *policy.NewPrivacyPolicyAddedEvent( @@ -34,7 +35,10 @@ func NewPrivacyPolicyAddedEvent( tosLink, privacyLink, helpLink, - supportEmail), + supportEmail, + docsLink, + customLink, + customLinkText), } } diff --git a/internal/repository/org/policy_privacy.go b/internal/repository/org/policy_privacy.go index 98916b1124..aad53b79c2 100644 --- a/internal/repository/org/policy_privacy.go +++ b/internal/repository/org/policy_privacy.go @@ -25,6 +25,7 @@ func NewPrivacyPolicyAddedEvent( privacyLink, helpLink string, supportEmail domain.EmailAddress, + docsLink, customLink, customLinkText string, ) *PrivacyPolicyAddedEvent { return &PrivacyPolicyAddedEvent{ PrivacyPolicyAddedEvent: *policy.NewPrivacyPolicyAddedEvent( @@ -35,7 +36,10 @@ func NewPrivacyPolicyAddedEvent( tosLink, privacyLink, helpLink, - supportEmail), + supportEmail, + docsLink, + customLink, + customLinkText), } } diff --git a/internal/repository/policy/policy_privacy.go b/internal/repository/policy/policy_privacy.go index 0b674fff64..8b140026b6 100644 --- a/internal/repository/policy/policy_privacy.go +++ b/internal/repository/policy/policy_privacy.go @@ -15,10 +15,13 @@ const ( type PrivacyPolicyAddedEvent struct { eventstore.BaseEvent `json:"-"` - TOSLink string `json:"tosLink,omitempty"` - PrivacyLink string `json:"privacyLink,omitempty"` - HelpLink string `json:"helpLink,omitempty"` - SupportEmail domain.EmailAddress `json:"supportEmail,omitempty"` + TOSLink string `json:"tosLink,omitempty"` + PrivacyLink string `json:"privacyLink,omitempty"` + HelpLink string `json:"helpLink,omitempty"` + SupportEmail domain.EmailAddress `json:"supportEmail,omitempty"` + DocsLink string `json:"docsLink,omitempty"` + CustomLink string `json:"customLink,omitempty"` + CustomLinkText string `json:"customLinkText,omitempty"` } func (e *PrivacyPolicyAddedEvent) Payload() interface{} { @@ -35,13 +38,17 @@ func NewPrivacyPolicyAddedEvent( privacyLink, helpLink string, supportEmail domain.EmailAddress, + docsLink, customLink, customLinkText string, ) *PrivacyPolicyAddedEvent { return &PrivacyPolicyAddedEvent{ - BaseEvent: *base, - TOSLink: tosLink, - PrivacyLink: privacyLink, - HelpLink: helpLink, - SupportEmail: supportEmail, + BaseEvent: *base, + TOSLink: tosLink, + PrivacyLink: privacyLink, + HelpLink: helpLink, + SupportEmail: supportEmail, + DocsLink: docsLink, + CustomLink: customLink, + CustomLinkText: customLinkText, } } @@ -60,10 +67,13 @@ func PrivacyPolicyAddedEventMapper(event eventstore.Event) (eventstore.Event, er type PrivacyPolicyChangedEvent struct { eventstore.BaseEvent `json:"-"` - TOSLink *string `json:"tosLink,omitempty"` - PrivacyLink *string `json:"privacyLink,omitempty"` - HelpLink *string `json:"helpLink,omitempty"` - SupportEmail *domain.EmailAddress `json:"supportEmail,omitempty"` + TOSLink *string `json:"tosLink,omitempty"` + PrivacyLink *string `json:"privacyLink,omitempty"` + HelpLink *string `json:"helpLink,omitempty"` + SupportEmail *domain.EmailAddress `json:"supportEmail,omitempty"` + DocsLink *string `json:"docsLink,omitempty"` + CustomLink *string `json:"customLink,omitempty"` + CustomLinkText *string `json:"customLinkText,omitempty"` } func (e *PrivacyPolicyChangedEvent) Payload() interface{} { @@ -116,6 +126,24 @@ func ChangeSupportEmail(supportEmail domain.EmailAddress) func(*PrivacyPolicyCha } } +func ChangeDocsLink(docsLink string) func(*PrivacyPolicyChangedEvent) { + return func(e *PrivacyPolicyChangedEvent) { + e.DocsLink = &docsLink + } +} + +func ChangeCustomLink(customLink string) func(*PrivacyPolicyChangedEvent) { + return func(e *PrivacyPolicyChangedEvent) { + e.CustomLink = &customLink + } +} + +func ChangeCustomLinkText(customLinkText string) func(*PrivacyPolicyChangedEvent) { + return func(e *PrivacyPolicyChangedEvent) { + e.CustomLinkText = &customLinkText + } +} + func PrivacyPolicyChangedEventMapper(event eventstore.Event) (eventstore.Event, error) { e := &PrivacyPolicyChangedEvent{ BaseEvent: *eventstore.BaseEventFromRepo(event), diff --git a/proto/zitadel/admin.proto b/proto/zitadel/admin.proto index 27e222589f..374ad3c88d 100644 --- a/proto/zitadel/admin.proto +++ b/proto/zitadel/admin.proto @@ -6817,6 +6817,23 @@ message UpdatePrivacyPolicyRequest { description: "help / support email address." } ]; + string docs_link = 5 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + example: "\"https://zitadel.com/docs\""; + } + ]; + string custom_link = 6 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "Link to an external resource that will be available to users in the console."; + example: "\"https://external.link\""; + } + ]; + string custom_link_text = 7 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "The button text that would be shown in console pointing to custom link."; + example: "\"External\""; + } + ]; } message UpdatePrivacyPolicyResponse { diff --git a/proto/zitadel/management.proto b/proto/zitadel/management.proto index d5b102b7e3..9b59f13be4 100644 --- a/proto/zitadel/management.proto +++ b/proto/zitadel/management.proto @@ -10495,6 +10495,24 @@ message AddCustomPrivacyPolicyRequest { description: "help / support email address." } ]; + string docs_link = 5 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "Link to documentation to be shown in the console."; + example: "\"https://zitadel.com/docs\""; + } + ]; + string custom_link = 6 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "Link to an external resource that will be available to users in the console."; + example: "\"https://external.link\""; + } + ]; + string custom_link_text = 7 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "The button text that would be shown in console pointing to custom link."; + example: "\"External\""; + } + ]; } message AddCustomPrivacyPolicyResponse { @@ -10527,6 +10545,24 @@ message UpdateCustomPrivacyPolicyRequest { description: "help / support email address." } ]; + string docs_link = 5 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "Link to documentation to be shown in the console."; + example: "\"https://zitadel.com/docs\""; + } + ]; + string custom_link = 6 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "Link to an external resource that will be available to users in the console."; + example: "\"https://external.link\""; + } + ]; + string custom_link_text = 7 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "The button text that would be shown in console pointing to custom link."; + example: "\"External\""; + } + ]; } message UpdateCustomPrivacyPolicyResponse { diff --git a/proto/zitadel/policy.proto b/proto/zitadel/policy.proto index 75d8472103..02b7e453f3 100644 --- a/proto/zitadel/policy.proto +++ b/proto/zitadel/policy.proto @@ -375,6 +375,25 @@ message PrivacyPolicy { description: "help / support email address." } ]; + string docs_link = 7 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "Link to documentation to be shown in the console."; + example: "\"https://zitadel.com/docs\""; + } + ]; + string custom_link = 8 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "Link to an external resource that will be available to users in the console."; + example: "\"https://external.link\""; + } + ]; + string custom_link_text = 9 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "The button text that would be shown in console pointing to custom link."; + example: "\"External\""; + } + ]; + } message NotificationPolicy { diff --git a/proto/zitadel/settings/v2beta/legal_settings.proto b/proto/zitadel/settings/v2beta/legal_settings.proto index b170d5f894..882a99cdba 100644 --- a/proto/zitadel/settings/v2beta/legal_settings.proto +++ b/proto/zitadel/settings/v2beta/legal_settings.proto @@ -37,4 +37,22 @@ message LegalAndSupportSettings { description: "resource_owner_type returns if the setting is managed on the organization or on the instance"; } ]; + string docs_link = 6 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "Link to documentation to be shown in the console."; + example: "\"https://zitadel.com/docs\""; + } +]; +string custom_link = 7 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "Link to an external resource that will be available to users in the console."; + example: "\"https://external.link\""; + } +]; +string custom_link_text = 8 [ + (grpc.gateway.protoc_gen_openapiv2.options.openapiv2_field) = { + description: "The button text that would be shown in console pointing to custom link."; + example: "\"External\""; + } +]; }