From 44f7a0607822d67ddf7d316fa8a355480da2b7d9 Mon Sep 17 00:00:00 2001 From: "dobby-yivi-agent[bot]" <275734547+dobby-yivi-agent[bot]@users.noreply.github.com> Date: Sat, 9 May 2026 18:33:10 +0000 Subject: [PATCH] docs(addons): explain expected Outlook security/Yivi prompts and popup-blocker workaround MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds a new closing list item to the Outlook install instructions (en + nl) covering two recurring user-confusion points: 1. The "PostGuard wants to open a dialog" Outlook security prompt and the Yivi signing prompt are part of the standard flow — users should expect them and click Allow. 2. If nothing happens after clicking Send/Decrypt, popups are likely blocked; pointer to allow popups for the relevant domain. Refs encryption4all/postguard-outlook-addon#60, encryption4all/postguard-outlook-addon#59 Co-Authored-By: Claude Opus 4.7 --- src/lib/locales/en.json | 2 +- src/lib/locales/nl.json | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/lib/locales/en.json b/src/lib/locales/en.json index d0df8d4..f2d296c 100644 --- a/src/lib/locales/en.json +++ b/src/lib/locales/en.json @@ -81,7 +81,7 @@ "title": "Add PostGuard to your mail client", "par": "Using the PostGuard addon for Thunderbird or Outlook, you can send encrypted emails in a breeze!", "Thunderbird": "
  1. Download and save the file postguard-tb-addon.xpi somewhere on your computer, where you can find it again easily.

  2. Within Thunderbird:

    • under the menu Tools, go to Add-ons and Themes,
    • click on the cog icon next to Manage Your Extensions and select Install Add-on From File ...,
    • a file selection window opens; go to the folder where you stored the file postguard-tb-addon.xpi and select it,
    • Thunderbird tells you what an add-on can do; when you wish to continue, click the Add button.
  3. Now, when you compose a new mail message, a new header is shown with a button to switch PostGuard on or off. When on, it will encrypt the message for all recipients. Each recipient needs to use the Yivi app to prove that (s)he really posesses the email address that you used.
", - "Outlook": "

  1. Adding the add-on:

    • Note: PostGuard for Outlook only works in New Outlook and Outlook on the web. Classic Outlook is not supported.
    • Download the manifest.xml file and save it somewhere you can find it again.
    • Open aka.ms/olksideload in your browser.
    • Click My add-ins.
    • Under Custom Add-ins, click Add a custom add-in, then Add from file.... If you do not see this option, your organization probably does not allow custom add-ins to be installed. Please contact your administrator.
    • Select the manifest.xml file you just downloaded and confirm to install.
    • Restart Outlook (close and reopen the desktop client, or refresh the browser tab if you are using Outlook on the web) to complete the activation of the add-in.
  2. Now, when you compose a new mail message, the PostGuard add-in is available from the Apps menu in the Outlook ribbon. Note: Outlook currently lists custom add-ins under the Apps menu rather than as a dedicated ribbon button — click Apps in the ribbon, then select PostGuard Add-in to open it. The add-in contains a button called Send encrypted Email. When clicking, it will encrypt and send the message to all recipients. Each recipient needs to use the Yivi app to prove that (s)he really possesses the email address that you used. Also, a copy of the sent mail is stored in the folder PostGuard Sent Items as a draft email (currently, Microsoft only allows to create messages as a draft).
  3. After receiving a PostGuard encrypted email, the email can be decrypted by opening the message, clicking Apps in the Outlook ribbon, selecting PostGuard Add-in, and then clicking the Decrypt Email button.
", + "Outlook": "

  1. Adding the add-on:

    • Note: PostGuard for Outlook only works in New Outlook and Outlook on the web. Classic Outlook is not supported.
    • Download the manifest.xml file and save it somewhere you can find it again.
    • Open aka.ms/olksideload in your browser.
    • Click My add-ins.
    • Under Custom Add-ins, click Add a custom add-in, then Add from file.... If you do not see this option, your organization probably does not allow custom add-ins to be installed. Please contact your administrator.
    • Select the manifest.xml file you just downloaded and confirm to install.
    • Restart Outlook (close and reopen the desktop client, or refresh the browser tab if you are using Outlook on the web) to complete the activation of the add-in.
  2. Now, when you compose a new mail message, the PostGuard add-in is available from the Apps menu in the Outlook ribbon. Note: Outlook currently lists custom add-ins under the Apps menu rather than as a dedicated ribbon button — click Apps in the ribbon, then select PostGuard Add-in to open it. The add-in contains a button called Send encrypted Email. When clicking, it will encrypt and send the message to all recipients. Each recipient needs to use the Yivi app to prove that (s)he really possesses the email address that you used. Also, a copy of the sent mail is stored in the folder PostGuard Sent Items as a draft email (currently, Microsoft only allows to create messages as a draft).
  3. After receiving a PostGuard encrypted email, the email can be decrypted by opening the message, clicking Apps in the Outlook ribbon, selecting PostGuard Add-in, and then clicking the Decrypt Email button.

  4. What to expect when sending or decrypting:

    • Security prompts are normal. When you send or decrypt a message, Outlook opens a small PostGuard wants to open a dialog window. This is a standard Outlook security prompt for any add-in that opens a dialog — click Allow (or OK) to continue. The Yivi signing prompt that follows is also part of the standard process; it is how PostGuard verifies your identity before encrypting or decrypting.
    • If nothing happens after clicking the button, your browser or Outlook is likely blocking pop-ups for the add-in dialog. Allow pop-ups for outlook.office.com (web) or for the PostGuard add-in domain (desktop), then try again. In most browsers you can do this from the pop-up icon that appears in the address bar after the click is blocked.
", "instruction.header": "Install instructions", "instruction.download": "Download for:", "outlookWarning": "Heads up: some Outlook accounts (typically those provided by an organization) do not allow custom add-ins. If your account is one of them, the Custom Add-ins section described below will be missing from aka.ms/olksideload and PostGuard for Outlook cannot be installed. Please contact your administrator, or use PostGuard for Thunderbird or the web app instead." diff --git a/src/lib/locales/nl.json b/src/lib/locales/nl.json index 697d72e..4bc3bce 100644 --- a/src/lib/locales/nl.json +++ b/src/lib/locales/nl.json @@ -81,7 +81,7 @@ "title": "Voeg PostGuard toe aan uw e-mailclient", "par": "Met de PostGuard add-on voor Thunderbird of Outlook kunt je in een handomdraai versleutelde e-mails verzenden!", "Thunderbird": "
  1. Download en bewaar het bestand postguard-tb-addon.xpi ergens op uw computer, waar je het gemakkelijk terug kunt vinden.

  2. Binnen Thunderbird:

    • ga onder het menu Tools naar Add-ons en thema's,
    • klik op het tandwielpictogram naast Uw extensies beheren en selecteer Add-on installeren vanuit bestand...,
    • een venster voor bestandsselectie wordt geopend; ga naar de map waar je het bestand postguard-tb-addon.xpi hebt opgeslagen en selecteer het,
    • Thunderbird vertelt je wat een add-on kan doen; als je wilt doorgaan, klikt je op de knop Toevoegen.
  3. Als je nu een nieuw mailbericht opstelt, wordt er een nieuwe balk getoond met een knop om PostGuard aan of uit te zetten. Indien ingeschakeld, wordt het bericht voor alle ontvangers versleuteld. Elke ontvanger moet de Yivi-app gebruiken om te bewijzen dat hij/zij echt in het bezit is van het e-mailadres dat je hebt gebruikt.
", - "Outlook": "

  1. De add-on toevoegen:

    • Let op: PostGuard voor Outlook werkt alleen in nieuwe Outlook en Outlook op het web. Klassiek Outlook wordt niet ondersteund.
    • Download het bestand manifest.xml en bewaar het ergens waar je het gemakkelijk terug kunt vinden.
    • Open aka.ms/olksideload in je browser.
    • Klik op Mijn invoegtoepassingen.
    • Onder Mijn invoegtoepassingen, klik op Aangepaste invoegtoepassing toevoegen en vervolgens op Toevoegen uit bestand. Als je deze optie niet ziet, staat je organisatie waarschijnlijk niet toe dat aangepaste add-ins worden geïnstalleerd. Neem contact op met je beheerder.
    • Selecteer het manifest.xml-bestand dat je zojuist hebt gedownload en bevestig om te installeren.
    • Herstart Outlook (sluit en heropen de desktopclient, of vernieuw het tabblad als je Outlook op het web gebruikt) om de activatie van de add-in te voltooien.
  2. Als je nu een nieuw e-mailbericht opstelt, is de PostGuard-add-in beschikbaar via het menu Apps in het Outlook-lint. Let op: Outlook plaatst aangepaste add-ins momenteel onder het Apps-menu in plaats van als aparte knop in het lint — klik op Apps in het lint en selecteer vervolgens PostGuard Add-in om de add-in te openen. De add-in bevat een knop met de naam Gecodeerde e-mail verzenden. Wanneer je erop klikt, wordt het bericht gecodeerd en naar alle ontvangers verzonden. Elke ontvanger moet de Yivi-app gebruiken om te bewijzen dat hij/zij echt over het door je gebruikte e-mailadres beschikt. Ook wordt een kopie van de verzonden e-mail opgeslagen in de map PostGuard Sent Items als concept-e-mail (momenteel staat Microsoft alleen toe om berichten als concept te maken).
  3. Na ontvangst van een met PostGuard versleutelde e-mail kan de e-mail worden ontsleuteld door het bericht te openen, op Apps in het Outlook-lint te klikken, PostGuard Add-in te selecteren en vervolgens op de knop E-mail ontsleutelen te klikken.
", + "Outlook": "

  1. De add-on toevoegen:

    • Let op: PostGuard voor Outlook werkt alleen in nieuwe Outlook en Outlook op het web. Klassiek Outlook wordt niet ondersteund.
    • Download het bestand manifest.xml en bewaar het ergens waar je het gemakkelijk terug kunt vinden.
    • Open aka.ms/olksideload in je browser.
    • Klik op Mijn invoegtoepassingen.
    • Onder Mijn invoegtoepassingen, klik op Aangepaste invoegtoepassing toevoegen en vervolgens op Toevoegen uit bestand. Als je deze optie niet ziet, staat je organisatie waarschijnlijk niet toe dat aangepaste add-ins worden geïnstalleerd. Neem contact op met je beheerder.
    • Selecteer het manifest.xml-bestand dat je zojuist hebt gedownload en bevestig om te installeren.
    • Herstart Outlook (sluit en heropen de desktopclient, of vernieuw het tabblad als je Outlook op het web gebruikt) om de activatie van de add-in te voltooien.
  2. Als je nu een nieuw e-mailbericht opstelt, is de PostGuard-add-in beschikbaar via het menu Apps in het Outlook-lint. Let op: Outlook plaatst aangepaste add-ins momenteel onder het Apps-menu in plaats van als aparte knop in het lint — klik op Apps in het lint en selecteer vervolgens PostGuard Add-in om de add-in te openen. De add-in bevat een knop met de naam Gecodeerde e-mail verzenden. Wanneer je erop klikt, wordt het bericht gecodeerd en naar alle ontvangers verzonden. Elke ontvanger moet de Yivi-app gebruiken om te bewijzen dat hij/zij echt over het door je gebruikte e-mailadres beschikt. Ook wordt een kopie van de verzonden e-mail opgeslagen in de map PostGuard Sent Items als concept-e-mail (momenteel staat Microsoft alleen toe om berichten als concept te maken).
  3. Na ontvangst van een met PostGuard versleutelde e-mail kan de e-mail worden ontsleuteld door het bericht te openen, op Apps in het Outlook-lint te klikken, PostGuard Add-in te selecteren en vervolgens op de knop E-mail ontsleutelen te klikken.

  4. Wat te verwachten bij het verzenden of ontsleutelen:

    • Beveiligingsmeldingen zijn normaal. Wanneer je een bericht verzendt of ontsleutelt, opent Outlook een klein venster met de melding PostGuard wil een dialoogvenster openen. Dit is een standaard Outlook-beveiligingsmelding voor elke add-in die een dialoogvenster opent — klik op Toestaan (of OK) om door te gaan. De Yivi-ondertekenmelding die daarna verschijnt hoort ook bij het standaardproces; zo verifieert PostGuard jouw identiteit voordat er versleuteld of ontsleuteld wordt.
    • Als er niets gebeurt nadat je op de knop hebt geklikt, dan blokkeert je browser of Outlook waarschijnlijk pop-ups voor het add-in-dialoogvenster. Sta pop-ups toe voor outlook.office.com (web) of voor het domein van de PostGuard add-in (desktop) en probeer het opnieuw. In de meeste browsers kun je dit doen via het pop-uppictogram dat na de blokkade in de adresbalk verschijnt.
", "instruction.header": "Installatie instructies", "instruction.download": "Downloaden voor:", "outlookWarning": "Let op: sommige Outlook-accounts (meestal accounts van een organisatie) staan geen aangepaste add-ins toe. Als dat voor jouw account geldt, ontbreekt het onderdeel Aangepaste add-ins dat hieronder wordt beschreven op aka.ms/olksideload en kan PostGuard voor Outlook niet worden geïnstalleerd. Neem contact op met je beheerder, of gebruik in plaats daarvan PostGuard voor Thunderbird of de webversie."