Update strings for recovery key

Co-authored-by: trevor-signal <131492920+trevor-signal@users.noreply.github.com>
2026-04-17 23:34:14 +01:00 · 2026-03-27 15:41:16 -05:00
parent 0744e06fa9
commit 56c736b963
5 changed files with 80 additions and 21 deletions
--- a/_locales/en/messages.json
+++ b/_locales/en/messages.json
@@ -8402,22 +8402,42 @@
    "messageformat": "show your backup key",
    "description": "Shown as part of an OS prompt with a final string like 'Signal Desktop is trying to show your backup key'"
  },
+  "icu:Preferences--local-backups--view-recovery-key--os-prompt--mac": {
+    "messageformat": "show your recovery key",
+    "description": "Shown as part of an OS prompt with a final string like 'Signal Desktop is trying to show your recovery (backup) key'"
+  },
  "icu:Preferences--local-backups--view-backup-key--os-prompt--windows": {
    "messageformat": "Verify your identity to view your backup key.",
    "description": "Shown as the body text of an OS prompt with a title like \"Making sure it's you\""
  },
+  "icu:Preferences--local-backups--view-recovery-key--os-prompt--windows": {
+    "messageformat": "Verify your identity to view your recovery key.",
+    "description": "Shown as the body text of an OS prompt with a title like \"Making sure it's you\""
+  },
  "icu:Preferences--local-backups--view-backup-key--os-prompt-description--linux": {
    "messageformat": "View backup key",
    "description": "If linux system has pkcheck and we were able to install .policy files, this is the dialog header the user will see on the polkit prompt before showing the key"
  },
+  "icu:Preferences--local-backups--view-recovery-key--os-prompt-description--linux": {
+    "messageformat": "View recovery key",
+    "description": "If linux system has pkcheck and we were able to install .policy files, this is the dialog header the user will see on the polkit prompt before showing the key"
+  },
  "icu:Preferences--local-backups--view-backup-key--os-prompt-message--linux": {
    "messageformat": "Authentication is required to view your backup key.",
    "description": "If linux system has pkcheck and we were able to install .policy files, this is the dialog text the user will see on the polkit prompt before showing the key"
  },
+  "icu:Preferences--local-backups--view-recovery-key--os-prompt-message--linux": {
+    "messageformat": "Authentication is required to view your recovery key.",
+    "description": "If linux system has pkcheck and we were able to install .policy files, this is the dialog text the user will see on the polkit prompt before showing the key"
+  },
  "icu:Preferences--local-backups-backup-key-text-box": {
    "messageformat": "Backup key text box",
    "description": "ARIA label for the text box used to view or confirm the backup key for local message backups."
  },
+  "icu:Preferences--local-backups-recovery-key-text-box": {
+    "messageformat": "Recovery key",
+    "description": "ARIA label for the text box used to view or confirm the recovery (backup) key for local message backups."
+  },
  "icu:Preferences--local-backups-enter-backup-key": {
    "messageformat": "Enter key",
    "description": "Placeholder text for the text box used to confirm the backup key for local message backups."
@@ -8426,33 +8446,45 @@
    "messageformat": "Record your backup key",
    "description": "Title for viewing the backup key for local message backups."
  },
+  "icu:Preferences--local-backups-record-recovery-key": {
+    "messageformat": "Record your recovery key",
+    "description": "Title for viewing the recovery (backup) key for local message backups."
+  },
  "icu:Preferences--local-backups-record-backup-key-description": {
    "messageformat": "This key is required to recover your account and data. Store this key somewhere safe. If you lose it, you won’t be able to recover your account. <learnMoreLink>Learn more.</learnMoreLink>",
-    "description": "Description for viewing the backup key for local message backups."
+    "description": "Description for viewing the recovery (backup) key for local message backups."
  },
  "icu:Preferences--local-backups-confirm-backup-key": {
    "messageformat": "Confirm your backup key",
    "description": "Title for confirming the backup key for local message backups by re-entering it into a text box."
  },
+  "icu:Preferences--local-backups-confirm-recovery-key": {
+    "messageformat": "Confirm your recovery key",
+    "description": "Title for confirming the recovery (backup) key for local message backups by re-entering it into a text box."
+  },
  "icu:Preferences--local-backups-confirm-backup-key-description": {
    "messageformat": "Enter the backup key that you just recorded",
    "description": "Description for confirming the backup key for local message backups by re-entering it into a text box."
  },
+  "icu:Preferences--local-backups-confirm-recovery-key-description": {
+    "messageformat": "Enter the recovery key that you just recorded",
+    "description": "Description for confirming the recovery (backup) key for local message backups by re-entering it into a text box."
+  },
  "icu:Preferences__local-backups-confirm-key-modal-title": {
    "messageformat": "Keep your key safe",
-    "description": "Title of modal shown after you confirmed the backup key for local on-device backups in settings"
+    "description": "Title of modal shown after you confirmed the recovery (backup) key for local on-device backups in settings"
  },
  "icu:Preferences__local-backups-confirm-key-modal-body": {
    "messageformat": "Signal will not be able to help you restore your backup if you lose your key. Store it somewhere safe and secure, and do not share it with others.",
-    "description": "Body text of modal shown after you confirmed the backup key for local on-device backups in settings"
+    "description": "Body text of modal shown after you confirmed the recovery (backup) key for local on-device backups in settings"
  },
  "icu:Preferences__local-backups-confirm-key-modal-continue": {
    "messageformat": "Continue",
-    "description": "Text of the primary button on modal shown after you confirmed the backup key for local on-device backups in settings"
+    "description": "Text of the primary button on modal shown after you confirmed the recovery (backup) key for local on-device backups in settings"
  },
  "icu:Preferences--local-backups-see-backup-key-again": {
    "messageformat": "See key again",
-    "description": "Link text to return to the previous backup key page, shown when confirming the backup key for local message backups."
+    "description": "Link text to return to the previous recovery key page, shown when confirming the recovery (backup) key for local message backups."
  },
  "icu:Preferences__local-backups-last-backup": {
    "messageformat": "Last backup",
@@ -8492,12 +8524,16 @@
  },
  "icu:Preferences__local-backups-copy-key": {
    "messageformat": "Copy to clipboard",
-    "description": "Button label for copying the backup key to clipboard in the settings for local on-device backups"
+    "description": "Button label for copying the recovery (backup) key to clipboard in the settings for local on-device backups"
  },
  "icu:Preferences__local-backups-copied-key": {
    "messageformat": "Backup key copied",
    "description": "Toast message after you copied the backup key to clipboard from settings for local on-device backups"
  },
+  "icu:Preferences__local-backups-copied-recovery-key": {
+    "messageformat": "Recovery key copied",
+    "description": "Toast message after you copied the backup key to clipboard from settings for local on-device backups"
+  },
  "icu:Preferences__local-backups--enable--os-prompt--mac": {
    "messageformat": "enable backups",
    "description": "Shown as part of an OS prompt with a final string like 'Signal Desktop is trying to enable backups'"
@@ -8514,6 +8550,18 @@
    "messageformat": "Authentication is required to enable backups.",
    "description": "If linux system has pkcheck and we were able to install .policy files, this is the dialog text the user will see on the polkit prompt before enabling backups"
  },
+  "icu:Preferences__local-backups-auth-error--unauthorized": {
+    "messageformat": "This action could not be completed because system authentication failed. Please try again or open the Signal app on your mobile device and go to Backup Settings to view your recovery key.",
+    "description": "Error shown in local backups settings when system authentication fails while trying to view the recovery key."
+  },
+  "icu:Preferences__local-backups-auth-error--unauthorized-no-windows-ucv": {
+    "messageformat": "This action could not be completed because Windows Hello is not enabled on your computer. Please set up Windows Hello and try again, or open the Signal app on your mobile device and go to Backup Settings to view your recovery key.",
+    "description": "Error shown in local backups settings on Windows when Windows Hello is not available while trying to view the recovery key."
+  },
+  "icu:Preferences__local-backups-auth-error--unavailable": {
+    "messageformat": "The action could not be completed because authentication is not available on this computer. Please open the Signal app on your mobile device and go to Backup Settings to view your recovery key.",
+    "description": "Error shown in local backups settings when system authentication is unavailable while trying to view the recovery key."
+  },
  "icu:Preferences__view-key": {
    "messageformat": "View key",
    "description": "Button to view the backup key which is used to restore a message history backup"
@@ -8522,10 +8570,18 @@
    "messageformat": "Backup key",
    "description": "Name for the key code used to restore a message history backup"
  },
+  "icu:Preferences__recovery-key": {
+    "messageformat": "Recovery key",
+    "description": "Name for the key code used to restore a message history backup"
+  },
  "icu:Preferences__backup-key-description": {
    "messageformat": "Your backup key is a 64-digit code used to restore your backup",
    "description": "Description for the key code used to restore a message history backup"
  },
+  "icu:Preferences__recovery-key-description": {
+    "messageformat": "Your recovery key is a 64-digit code used to restore your backup",
+    "description": "Description for the key code used to restore a message history backup"
+  },
  "icu:Preferences__backup-other-ways": {
    "messageformat": "Other ways to back up",
    "description": "Heading on the backups settings view for alternative backup methods such as on-device backups."
--- a/ts/components/PreferencesLocalBackups.dom.tsx
+++ b/ts/components/PreferencesLocalBackups.dom.tsx
@@ -204,9 +204,9 @@ export function PreferencesLocalBackups({
        <FlowingControl>
          <div className="Preferences__two-thirds-flow">
            <label>
-              {i18n('icu:Preferences__backup-key')}
+              {i18n('icu:Preferences__recovery-key')}
              <div className="Preferences__description">
-                {i18n('icu:Preferences__backup-key-description')}
+                {i18n('icu:Preferences__recovery-key-description')}
              </div>
            </label>
          </div>
@@ -314,7 +314,7 @@ export function PreferencesLocalBackups({
          <AxoAlertDialog.Content escape="cancel-is-noop">
            <AxoAlertDialog.Body>
              <AxoAlertDialog.Description>
-                {getOSAuthErrorString(authError) ?? i18n('icu:error')}
+                {getOSAuthErrorString(i18n, authError) ?? i18n('icu:error')}
              </AxoAlertDialog.Description>
            </AxoAlertDialog.Body>
            <AxoAlertDialog.Footer>
@@ -524,7 +524,7 @@ function LocalBackupsBackupKeyViewer({
  let footerLeft: React.JSX.Element | undefined;
  let footerRight: React.JSX.Element;
  if (isStepViewOrReference) {
-    title = i18n('icu:Preferences--local-backups-record-backup-key');
+    title = i18n('icu:Preferences--local-backups-record-recovery-key');
    description = (
      <I18n
        id="icu:Preferences--local-backups-record-backup-key-description"
@@ -552,9 +552,9 @@ function LocalBackupsBackupKeyViewer({
      );
    }
  } else {
-    title = i18n('icu:Preferences--local-backups-confirm-backup-key');
+    title = i18n('icu:Preferences--local-backups-confirm-recovery-key');
    description = i18n(
-      'icu:Preferences--local-backups-confirm-backup-key-description'
+      'icu:Preferences--local-backups-confirm-recovery-key-description'
    );
    footerLeft = (
      <AxoButton.Root
@@ -689,7 +689,7 @@ function LocalBackupsBackupKeyTextarea({

  return (
    <textarea
-      aria-label={i18n('icu:Preferences--local-backups-backup-key-text-box')}
+      aria-label={i18n('icu:Preferences--local-backups-recovery-key-text-box')}
      className="Preferences--LocalBackupsBackupKey"
      cols={20}
      dir="ltr"
@@ -706,6 +706,7 @@ function LocalBackupsBackupKeyTextarea({
 }

 function getOSAuthErrorString(
+  i18n: LocalizerType,
  authError: Omit<PromptOSAuthResultType, 'success'> | undefined
 ): string | undefined {
  if (!authError) {
@@ -714,12 +715,14 @@ function getOSAuthErrorString(

  // TODO: DESKTOP-8895
  if (authError === 'unauthorized') {
-    return 'This action could not be completed because system authentication failed. Please try again or open the Signal app on your mobile device and go to Backup Settings to view your backup key.';
+    return i18n('icu:Preferences__local-backups-auth-error--unauthorized');
  }

  if (authError === 'unauthorized-no-windows-ucv') {
-    return 'This action could not be completed because Windows Hello is not enabled on your computer. Please set up Windows Hello and try again, or open the Signal app on your mobile device and go to Backup Settings to view your backup key.';
+    return i18n(
+      'icu:Preferences__local-backups-auth-error--unauthorized-no-windows-ucv'
+    );
  }

-  return 'The action could not be completed because authentication is not available on this computer. Please open the Signal app on your mobile device and go to Backup Settings to view your backup key.';
+  return i18n('icu:Preferences__local-backups-auth-error--unavailable');
 }
--- a/ts/components/ToastManager.dom.tsx
+++ b/ts/components/ToastManager.dom.tsx
@@ -318,7 +318,7 @@ export function renderToast({
  if (toastType === ToastType.CopiedBackupKey) {
    return (
      <Toast onClose={hideToast} timeout={3 * SECOND}>
-        {i18n('icu:Preferences__local-backups-copied-key')}
+        {i18n('icu:Preferences__local-backups-copied-recovery-key')}
      </Toast>
    );
  }
--- a/ts/scripts/gen-policy-files.node.ts
+++ b/ts/scripts/gen-policy-files.node.ts
@@ -47,9 +47,9 @@ async function main() {
        'utf8'
      ),
      description:
-        'icu:Preferences--local-backups--view-backup-key--os-prompt-description--linux',
+        'icu:Preferences--local-backups--view-recovery-key--os-prompt-description--linux',
      message:
-        'icu:Preferences--local-backups--view-backup-key--os-prompt-message--linux',
+        'icu:Preferences--local-backups--view-recovery-key--os-prompt-message--linux',
    },
  ];

--- a/ts/util/promptOSAuth.preload.ts
+++ b/ts/util/promptOSAuth.preload.ts
@@ -26,7 +26,7 @@ export async function promptOSAuth(
        );
      } else if (reason === 'view-aep') {
        localeString = window.SignalContext.i18n(
-          'icu:Preferences--local-backups--view-backup-key--os-prompt--mac'
+          'icu:Preferences--local-backups--view-recovery-key--os-prompt--mac'
        );
      } else {
        throw missingCaseError(reason);
@@ -44,7 +44,7 @@ export async function promptOSAuth(
        );
      } else if (reason === 'view-aep') {
        localeString = window.SignalContext.i18n(
-          'icu:Preferences--local-backups--view-backup-key--os-prompt--windows'
+          'icu:Preferences--local-backups--view-recovery-key--os-prompt--windows'
        );
      } else {
        throw missingCaseError(reason);