Difference between revisions of "Outlook Addin"

From regify WIKI
Jump to navigation Jump to search
 
(25 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Outlook New/o365 web BETA Add-In==
+
== Outlook New/o365 web Add-In ==
<div style="border: 5px solid red; background-color: #fff2f2; color: #771010; padding: 5px 5px 5px 20px;">
+
===Installation===
Please note that this add-in for Outlook ''New'' and Outlook ''Web'' (o365) is still '''beta'''.
+
Open your add-in marketplace <span style="display: inline-block; margin: 0; padding: 0;">[[File:Outlook-app-symbol.png|20px|frameless|alt=Outlook Marketplace Symbol]]</span> and search for "regimail". Then follow the instructions on the screen.
* It offers only limited functionality.
 
* It may not be fully translated (defaults to English).
 
* It may not work at all or at all time.
 
* It may not cover all message content and all content types.
 
* It may not encrypt properly.
 
* It may trigger additional "new device" email messages to users.
 
* Also, please check below compatibility notes!
 
  
If you experience any problems and you are willing to report, please send an exact error report with exact versions, all steps you did and maybe even screenshots to support (at) regify.com.
+
=== Usage ===
</div>
+
'''Writing:''' During writing, the top ribbon bar is switching to "Message" view. There, you can click the "Apps" button <span style="display: inline-block; margin: 0; padding: 0;">[[File:Outlook-app-symbol.png|20px|frameless|alt=Outlook Marketplace Symbol]]</span> to reach the regify Add-In for encryption. Follow the instructions on screen.
 +
 
 +
'''Reading:''' If an email is visible in preview, there appears a small "Apps" button <span style="display: inline-block; margin: 0; padding: 0;">[[File:Outlook-app-symbol.png|20px|frameless|alt=Outlook Marketplace Symbol]]</span> on top of the message window. There you can reach the regify Add-In for viewing the message.
 +
 
 +
=== Functions ===
 +
The regimail Add-In for Outlook new and o365 supports the following functions:
 +
* '''Open and decrypt regimails''' and show content and extract attachments.
 +
* '''Encrypt regimails''' from your existing email draft.
 +
* Configure regify settings (regify account settings).
 +
* Additional functions may be added in the future.
 +
 
 +
=== Compatibility notes ===
 +
We tested the following combinations with the regimail Add-In (December 2025):
  
<div style="border: 5px solid blue; background-color: #ececf4; color: #202080; padding: 5px 5px 5px 20px; margin-top: 15px;">
 
<b><u>Compatibility notes for the beta AddIn:</u></b><br>
 
We tested the following combinations on Windows 11 (September 2025):<br>
 
 
<span style="color: green;">✓</span> Works with '''O365 web''' (eg outlook.live.com) on Windows, MacOS and Linux. <sup>(c)</sup><br>
 
<span style="color: green;">✓</span> Works with '''O365 web''' (eg outlook.live.com) on Windows, MacOS and Linux. <sup>(c)</sup><br>
 
<span style="color: green;">✓</span> Works with '''Outlook Classic 2024''' with '''Hosted Exchange 2019''' account on Windows. <sup>(a) (b)</sup><br>
 
<span style="color: green;">✓</span> Works with '''Outlook Classic 2024''' with '''Hosted Exchange 2019''' account on Windows. <sup>(a) (b)</sup><br>
 
<span style="color: green;">✓</span> Works with '''Outlook Classic 2024''' and '''O365 account''' on Windows. <sup>(a)</sup><br>
 
<span style="color: green;">✓</span> Works with '''Outlook Classic 2024''' and '''O365 account''' on Windows. <sup>(a)</sup><br>
 
<span style="color: green;">✓</span> Works with '''Outlook New''' with '''O365 account''' on Windows.<br>
 
<span style="color: green;">✓</span> Works with '''Outlook New''' with '''O365 account''' on Windows.<br>
<span style="color: red;"></span> Not working with '''Outlook New''' with '''Hosted Exchange 2019''' account (Outlook New does not support such accounts in general).<br>
+
<span style="color: orange;">●︎</span> Not working with any '''Outlook Classic''' and '''On-Prem''' Exchange 2019 or 2016 backend. <sup>(a)</sup><br>
 +
<span style="color: orange;">●︎</span> Not working with any '''Outlook Classic 2019 or 2016''' and O365 account. <sup>(a)</sup><br>
 
<span style="color: red;">✗</span> Not working with '''Exchange 2019 OWA''' (web access).<br>
 
<span style="color: red;">✗</span> Not working with '''Exchange 2019 OWA''' (web access).<br>
 
<span style="color: red;">✗</span> Not working with '''Exchange 2016 OWA''' (web access).<br>
 
<span style="color: red;">✗</span> Not working with '''Exchange 2016 OWA''' (web access).<br>
<span style="color: red;">✗</span> Not working with any '''Outlook Classic''' and '''On-Prem''' Exchange 2019 or 2016 backend. <sup>(a)</sup><br>
 
<span style="color: red;">✗</span> Not working with any '''Outlook Classic 2019 or 2016''' and O365 account. <sup>(a)</sup><br>
 
  
 
<span style="font-size: 80%;">(a) Consider using our regular Add-In for Outlook ''Classic'' contained in regify client setup (COM Add-In)!</span>
 
<span style="font-size: 80%;">(a) Consider using our regular Add-In for Outlook ''Classic'' contained in regify client setup (COM Add-In)!</span>
Line 31: Line 32:
  
 
<span style="font-size: 80%;">(c) We've seen issues for saving decrypted regimail message attachments with '''Firefox''' browsers. If you need this, use '''any other up to date web browser''' like Edge, Chrome, Opera, Vivaldi etc.<br>Background: Firefox is interpreting ''content-security-policy'' values different than others. Due to this, Firefox blocks BLOB downloads because of Microsofts ''content-security-policy settings''.</span>
 
<span style="font-size: 80%;">(c) We've seen issues for saving decrypted regimail message attachments with '''Firefox''' browsers. If you need this, use '''any other up to date web browser''' like Edge, Chrome, Opera, Vivaldi etc.<br>Background: Firefox is interpreting ''content-security-policy'' values different than others. Due to this, Firefox blocks BLOB downloads because of Microsofts ''content-security-policy settings''.</span>
</div>
 
  
<span style="font-size: 130%;">FAQ</span><br>
+
=== FAQ for Outlook New/o365 ===
 
'''Q:''' Why don't you decrypt automatically if an encrypted regimail is received (rgf file)?<br>
 
'''Q:''' Why don't you decrypt automatically if an encrypted regimail is received (rgf file)?<br>
 
'''A:''' Office JavaScript Add-Ins cannot run code in the background or automatically when an email is selected or received. Add-In code only executes after the user explicitly opens the add-in. This is a security and performance feature of the Office platform, as documented by Microsoft. Therefore, the regimail Add-In is not able to handle regimails automatically.
 
'''A:''' Office JavaScript Add-Ins cannot run code in the background or automatically when an email is selected or received. Add-In code only executes after the user explicitly opens the add-in. This is a security and performance feature of the Office platform, as documented by Microsoft. Therefore, the regimail Add-In is not able to handle regimails automatically.
  
 
'''Q:''' Why is there no regimail Add-in buttons in the Outlook GUI?<br>
 
'''Q:''' Why is there no regimail Add-in buttons in the Outlook GUI?<br>
'''A:''' There are such buttons in local installed Outlook ''New'', but for Outlook o365 (in the web), the Microsoft Office Add-In API does not offer any integration into the ribbon menus. Therefore, you are forced to start the Add-In using the "Apps" or "More Apps" buttons to run the regimail Add-In.
+
'''A:''' There are such buttons in local installed Outlook Classic 2024, but for Outlook New and o365 (in the web), the Microsoft Office Add-In API does not offer any integration into the ribbon menus. Therefore, you are forced to start the Add-In using the "Apps" or "More Apps" button <span style="display: inline-block; margin: 0; padding: 0;">[[File:Outlook-app-symbol.png|18px|frameless|alt=Outlook Marketplace Symbol]]</span> to run the regimail Add-In.
 
 
 
 
 
 
We offer you to test the new '''BETA''' regimail add-in for Outlook ''New'' and Outlook ''Web'' (o365). If you want to install the beta version of the add-in, please follow these steps:
 
 
 
===Outlook Web (OWA)===
 
In general, you can follow the [https://support.microsoft.com/en-us/office/use-add-ins-in-outlook-1ee261f9-49bf-4ba6-b3e2-2ba7bcab64c8#picktab=classic_outlook instrucions from Microsoft] (on top, select "Outlook on the web" and then scroll down for "Install a custom add-in from a file").
 
# Select to create a '''new email'''.[[File:NewOL Add-Ins-Button.png|right|middle|450px|Outlook WEB, find add-ins button in new email dialog]]
 
# Click the add-ins button.
 
# Select "Get add-ins" option. [[File:NewOL Add-Ins-Select.png|right|middle|200px|Outlook WEB, add additional add-ins from here]]
 
# In the ''Add-Ins for Outlook'' dialog, select "My add-ins" on the left.
 
# Scroll down to ''Custom Addins'' and click the "Add a custom add-in" button.
 
# If "Add from URL..." option is available:
 
#* Enter the URL https://apps1.regify.com/client-beta/outlook_regimail_beta.xml and follow instructions.
 
# If the "Add from URL..." option is not available:
 
#* Right click this Link: [https://apps1.regify.com/client-beta/outlook_regimail_beta.xml outlook_regimail_beta.xml] Select "Save target as..." option or similar to save it to your local PC.
 
#* Then select "Add from File..." option in Outlook add-in dialog and provide the just downloaded file.
 
# Now follow the instructions of Outlook.
 
 
 
==== usage ====
 
 
 
Writing: During writing, the top ribbon bar is switching to "Message" view. There, you can click the "Apps" button to reach the regify add-in for encryption. Follow the instructions on screen.
 
Reading: If an email is visible in preview, there appears a small "Apps" button on top of the message window. There you can reach the regify add-in for viewing the message.
 
  
==== notes ====
+
'''Q:''' I wan't to reset the Add-In settings. How can I enter the settings dialog?<br>
We were asked why we're not adding the buttons to the main menu and compose menu. The simple reason is, that Microsoft does not allow add-ins to place their own buttons.
+
'''A:''' Just create a new empty email. Now run the regimail Add-In using the "Apps" or "More Apps" button <span style="display: inline-block; margin: 0; padding: 0;">[[File:Outlook-app-symbol.png|18px|frameless|alt=Outlook Marketplace Symbol]]</span> in the "Message" tab. The "encrypt now" button appears. Instead of pressing, open the hamburger menu on the upper right and navigate to settings. There, you can click the reset configuration button.
  
===Outlook new===
+
'''Q:''' I can't open a rgf file by double click?<br>
In general, you can follow the [https://support.microsoft.com/en-us/office/use-add-ins-in-outlook-1ee261f9-49bf-4ba6-b3e2-2ba7bcab64c8#picktab=classic_outlook instrucions from Microsoft] (on top, select "New Outlook" and then scroll down for "Install a custom add-in from a file").
+
'''A:''' This is because the Outlook API does not let us know if a user is trying to open the attached rgf file (eg double click). Therefore, the regimail Add-In unfortunately does not know. So the operating system tries to open with some installed software instead of our Add-In (which fails). Just cancel and open the rgf from the Add-In button.
# Click the add-ins button.[[File:Outlook new message.png|right|middle|500px|Outlook new, encrypt as regimail]]
 
# Select "Get add-ins" option.
 
# In the ''Add-Ins for Outlook'' dialog, select "My add-ins" on the left.
 
# Scroll down to ''Custom Addins'' and click the "Add a custom add-in" button.
 
# If "Add from URL..." option is available:
 
#* Enter the URL https://apps1.regify.com/client-beta/outlook_regimail_beta.xml and follow instructions.
 
# If the "Add from URL..." option is not available: [[File:Outlook read message.png|right|middle|500px|Outlook new, decrypt a regimail]]
 
#* Right click this Link: [https://apps1.regify.com/client-beta/outlook_regimail_beta.xml outlook_regimail_beta.xml] Select "Save target as..." option or similar to save it to your local PC.
 
#* Then select "Add from File..." option in Outlook add-in dialog and provide the just downloaded file.
 
# Now follow the instructions of Outlook.
 
  
===Outlook Classic 2024===
+
=== Beta/QA Version ===
The new Outlook AddIn is also capable of running in most recent Outlook Classic 2024. In general, you can follow the [https://support.microsoft.com/en-us/office/use-add-ins-in-outlook-1ee261f9-49bf-4ba6-b3e2-2ba7bcab64c8#picktab=classic_outlook instrucions from Microsoft] (on top, select "Classic Outlook" and then scroll down for "Install a custom add-in from a file").
+
If you like to test the beta version, you can install it from a local file only. Follow this guide:
# Click "File" -> "Manage Add-ins" (button at the bottom). Now the web browser opens up on your webmail email account.
+
# Right click this link [https://apps1.regify.com/ol-qa/outlook_regimail_qa.xml regimail outlook addin beta] and save the file ''outlook_regimail_qa.xml'' to your desktop or other folder (usually by right click on the link and then "Save as…").
# Log-in to your webmail email account.
+
# Click the "Apps" or "More Apps" button <span style="display: inline-block; margin: 0; padding: 0;">[[File:Outlook-app-symbol.png|18px|frameless|alt=Outlook Marketplace Symbol]]</span> in Outlook main ribbon. There, select "Get add-ins".
# Click the plus (+) on top of the Add-Ins list.
+
# Click "My add-ins" on the left and remove any existing regimail add-in.
# Select "Add from URL..." and enter https://apps1.regify.com/client-beta/outlook_regimail_beta.xml
+
# Scroll down to "Custom add-ins" and click "Add a custom add-in" and select "Add from file…".
# Confirm security question.
+
# Select the previously downloaded ''outlook_regimail_qa.xml'' file.
# Close the web browser.
 
  
'''Hints:'''<br>
+
Now you see the regimail QA add-in loaded as beta version.
1) You may need to restart Outlook to let the Add-In appear.<br>
 
2) You find the "Decrypt regimail" button in the "Start" ribbon. Sometimes you might need to switch ribbon tab first.
 
  
 
==Outlook Classic==
 
==Outlook Classic==
===Supported versions===
+
===Compatibility Notes ===
The current add-in for Microsoft Outlook ''Classic'', '''shipped with the current regify client setup''', is available for the following versions:
+
The current Add-In for Microsoft Outlook ''Classic'', '''shipped with the current regify client setup''', is available for the following versions:
 
* Outlook 2019 (32 Bit & 64 Bit)
 
* Outlook 2019 (32 Bit & 64 Bit)
 
* Outlook 2021 / Office 365 (32 Bit & 64 Bit)
 
* Outlook 2021 / Office 365 (32 Bit & 64 Bit)
 
* Outlook 2024 / Office 365 (32 Bit & 64 Bit)
 
* Outlook 2024 / Office 365 (32 Bit & 64 Bit)
  
Please respect that we're no longer supporting Outlook before 2019. Running this e-mail client is also no longer secure. Please consider upgrading to a newer version. Or how about trying [https://www.thunderbird.net/ Mozilla Thunderbird] with its great email and calendar functions if you use IMAP or POP3 capable accounts?
+
Please respect that we're no longer supporting Outlook versions before 2019. Running such old e-mail client is no longer secure. Please consider upgrading to a newer version. Or how about trying [https://www.thunderbird.net/ Mozilla Thunderbird] with its great email and calendar functions if you use IMAP or POP3 capable accounts?
  
 
===Functions===
 
===Functions===
The add-in for Microsoft Outlook ''Classic'' offers the following functions:
+
The regify Add-In for Microsoft Outlook ''Classic'' offers the following functions:
* create new regify e-mails
+
* Create and encrypt new regimails.
* forward, reply and reply all using regify
+
* Forward, Reply and Reply All using regimail.
* reconvert regify mails to ordinary e-mails
+
* Reconvert regimails to ordinary emails.
* automatically reconvert while receiving
+
* Automatically reconvert regimails while receiving.
* configure regify settings (account settings)
+
* Configure regify settings (regify account settings).
* invite new users to regify
+
* Invite new users to regify.
  
 
===Setup===
 
===Setup===
The Outlook add-in is installed automatically (in the correct version) during setup of the regify client. If you do not like to install the Outlook add-in during setup, you can prevent it in the installer GUI. Please find additional information about setup options in the [https://manuals.regify.com/docs/regify_client/current/regify-client_deployment/ regify client deployment manual].
+
The Outlook Add-In is installed automatically (in the correct version) during setup of the '''regify client'''. If you do not like to install the Outlook Add-In during setup, you can prevent it in the installer GUI. Please find additional information about setup options in the [https://manuals.regify.com/docs/regify_client/current/regify-client_deployment/ regify client deployment manual].

Latest revision as of 15:37, 10 February 2026

Outlook New/o365 web Add-In

Installation

Open your add-in marketplace Outlook Marketplace Symbol and search for "regimail". Then follow the instructions on the screen.

Usage

Writing: During writing, the top ribbon bar is switching to "Message" view. There, you can click the "Apps" button Outlook Marketplace Symbol to reach the regify Add-In for encryption. Follow the instructions on screen.

Reading: If an email is visible in preview, there appears a small "Apps" button Outlook Marketplace Symbol on top of the message window. There you can reach the regify Add-In for viewing the message.

Functions

The regimail Add-In for Outlook new and o365 supports the following functions:

  • Open and decrypt regimails and show content and extract attachments.
  • Encrypt regimails from your existing email draft.
  • Configure regify settings (regify account settings).
  • Additional functions may be added in the future.

Compatibility notes

We tested the following combinations with the regimail Add-In (December 2025):

Works with O365 web (eg outlook.live.com) on Windows, MacOS and Linux. (c)
Works with Outlook Classic 2024 with Hosted Exchange 2019 account on Windows. (a) (b)
Works with Outlook Classic 2024 and O365 account on Windows. (a)
Works with Outlook New with O365 account on Windows.
●︎ Not working with any Outlook Classic and On-Prem Exchange 2019 or 2016 backend. (a)
●︎ Not working with any Outlook Classic 2019 or 2016 and O365 account. (a)
Not working with Exchange 2019 OWA (web access).
Not working with Exchange 2016 OWA (web access).

(a) Consider using our regular Add-In for Outlook Classic contained in regify client setup (COM Add-In)!

(b) Due to Microsoft documentation, it works because of Outlook 2024 LTSC (volume licensing). It will not work with any previous Outlook Classic version.

(c) We've seen issues for saving decrypted regimail message attachments with Firefox browsers. If you need this, use any other up to date web browser like Edge, Chrome, Opera, Vivaldi etc.
Background: Firefox is interpreting content-security-policy values different than others. Due to this, Firefox blocks BLOB downloads because of Microsofts content-security-policy settings.

FAQ for Outlook New/o365

Q: Why don't you decrypt automatically if an encrypted regimail is received (rgf file)?
A: Office JavaScript Add-Ins cannot run code in the background or automatically when an email is selected or received. Add-In code only executes after the user explicitly opens the add-in. This is a security and performance feature of the Office platform, as documented by Microsoft. Therefore, the regimail Add-In is not able to handle regimails automatically.

Q: Why is there no regimail Add-in buttons in the Outlook GUI?
A: There are such buttons in local installed Outlook Classic 2024, but for Outlook New and o365 (in the web), the Microsoft Office Add-In API does not offer any integration into the ribbon menus. Therefore, you are forced to start the Add-In using the "Apps" or "More Apps" button Outlook Marketplace Symbol to run the regimail Add-In.

Q: I wan't to reset the Add-In settings. How can I enter the settings dialog?
A: Just create a new empty email. Now run the regimail Add-In using the "Apps" or "More Apps" button Outlook Marketplace Symbol in the "Message" tab. The "encrypt now" button appears. Instead of pressing, open the hamburger menu on the upper right and navigate to settings. There, you can click the reset configuration button.

Q: I can't open a rgf file by double click?
A: This is because the Outlook API does not let us know if a user is trying to open the attached rgf file (eg double click). Therefore, the regimail Add-In unfortunately does not know. So the operating system tries to open with some installed software instead of our Add-In (which fails). Just cancel and open the rgf from the Add-In button.

Beta/QA Version

If you like to test the beta version, you can install it from a local file only. Follow this guide:

  1. Right click this link regimail outlook addin beta and save the file outlook_regimail_qa.xml to your desktop or other folder (usually by right click on the link and then "Save as…").
  2. Click the "Apps" or "More Apps" button Outlook Marketplace Symbol in Outlook main ribbon. There, select "Get add-ins".
  3. Click "My add-ins" on the left and remove any existing regimail add-in.
  4. Scroll down to "Custom add-ins" and click "Add a custom add-in" and select "Add from file…".
  5. Select the previously downloaded outlook_regimail_qa.xml file.

Now you see the regimail QA add-in loaded as beta version.

Outlook Classic

Compatibility Notes

The current Add-In for Microsoft Outlook Classic, shipped with the current regify client setup, is available for the following versions:

  • Outlook 2019 (32 Bit & 64 Bit)
  • Outlook 2021 / Office 365 (32 Bit & 64 Bit)
  • Outlook 2024 / Office 365 (32 Bit & 64 Bit)

Please respect that we're no longer supporting Outlook versions before 2019. Running such old e-mail client is no longer secure. Please consider upgrading to a newer version. Or how about trying Mozilla Thunderbird with its great email and calendar functions if you use IMAP or POP3 capable accounts?

Functions

The regify Add-In for Microsoft Outlook Classic offers the following functions:

  • Create and encrypt new regimails.
  • Forward, Reply and Reply All using regimail.
  • Reconvert regimails to ordinary emails.
  • Automatically reconvert regimails while receiving.
  • Configure regify settings (regify account settings).
  • Invite new users to regify.

Setup

The Outlook Add-In is installed automatically (in the correct version) during setup of the regify client. If you do not like to install the Outlook Add-In during setup, you can prevent it in the installer GUI. Please find additional information about setup options in the regify client deployment manual.