.. _faq:

Frequently Asked Questions
==========================

Chrome Extension
----------------

Which browsers are supported by the Chrome Extension?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The Chrome Extension is designed to work exclusively with the Google Chrome browser due to its reliance on Google OAuth2 authentication.
Other browsers may not support the necessary features for the extension to function correctly.

Why is the Extension not working on my browser?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Ensure you are using the Google Chrome browser, as the extension is not compatible with other browsers.
Additionally, check that you have granted all necessary permissions during installation.

**Ensure Chrome Profile is using the same account as the Gmail account.**

.. image:: ./faq_images/chrome-account.png
    :align: center

.. warning::
    .. raw:: html

        <p>Please check if necessary permissions is given <a href="https://myaccount.google.com/connections" target="_blank" rel="noopener noreferrer">here</a> for troubleshooting tips.</p>

If permissions is **not given**
_______________________________

You should see something like this:

.. image:: ./faq_images/app-connections.png
    :align: center
    :width: 80%

If permissions is given but **without** access to *"View your email messages and settings"*
________________________________________________________________________________________________________

You should see something like this:

.. image:: ./faq_images/app-connections-main.png
    :align: center
    :width: 80%

Click on the app name to see the details:

.. image:: ./faq_images/chrome-ext-half-access.png
    :align: center
    :width: 80%

Lack of permissions will cause the extension to not work properly.

**To reset the permissions:**

1. Please click on *"Delete all connections you have with SafeQuard Chrome Extension"* to reset the permissions
2. Open up gmail on Google Chrome Browser to grant the necessary permissions by following the installation steps in :ref:`Accept Permissions <ext_instal>`

If permissions is given **with** access to *"View your email messages and settings"*
____________________________________________________________________________________

You should see something like this:

.. image:: ./faq_images/app-connections-main.png
    :align: center
    :width: 80%

Click on the app name to see the details:

.. image:: ./faq_images/chrome-ext-full-access.png
    :align: center
    :width: 80%

The extension should work properly now. If it still does not work, please try to reinstall the extension by following the installation steps in :ref:`Chrome Extension <chrome_ext>`.
Removing all connections and permissions as mentioned above before reinstalling the extension is recommended.

WebApp
------

Which browsers are supported by the WebApp?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The WebApp is designed to work on most modern browsers (Mobile/Tablet Browser Included), including Google Chrome, Mozilla Firefox, Brave Browser, Microsoft Edge, and Safari. However, for the best experience, we recommend using the latest version of Google Chrome.

Why is the WebApp not working on my browser?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Login with Google
_________________

First time user needs to accept Email Permission. Refer to :ref:`Here <Trials>` for installation and usage instructions.


Login with Outlook
__________________
First time user needs to accept Email Permission. Refer to :ref:`Here <Trials>` for installation and usage instructions.

Outlook Add-in
--------------
Which versions of Outlook are supported by the Outlook Add-in?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. table:: Currently Supported Modes for Outlook
  :widths: 10 15 20 20 50

  +----------+-----------------+-------------------+-----------------------------+-------------------------------------------------+
  | Platform | Type            | Support for Enc   | Support for Dec             | Remarks                                         |
  +==========+=================+===================+=============================+=================================================+
  |  Windows |  Browser        | .. centered:: ✅  | .. centered:: ✅            ||                                                |
  |          |  App            | .. centered:: ✅  | .. centered:: ✅            || Works for both Outlook Desktop New and Classic |
  +----------+-----------------+-------------------+-----------------------------+-------------------------------------------------+
  |  Android |  Browser [#f1]_ | .. centered:: ✅  | .. centered:: ✅            || More testing required                          |
  |          |  App            | .. centered:: ❌  | .. centered:: Content Only  || Needs debugging [#f2]_                         |
  +----------+-----------------+-------------------+-----------------------------+-------------------------------------------------+
  |  iOS     |  Browser [#f1]_ | .. centered:: ✅  | .. centered:: ✅            || Decryption of attachment size limited to 5mb   |
  |          |  App            | .. centered:: ❌  | .. centered:: Content Only  ||                                                |
  +----------+-----------------+-------------------+-----------------------------+-------------------------------------------------+
  |  iPadOS  |  Browser [#f1]_ | .. centered:: ✅  | .. centered:: ✅            || Decryption of attachment size limited to 5mb   |
  |          |  App            | .. centered:: ❌  | .. centered:: Content Only  ||                                                |
  +----------+-----------------+-------------------+-----------------------------+-------------------------------------------------+
  |  macOS   |  Browser        | .. centered:: ❌  | .. centered:: ✅            || Decryption of attachment size limited to 5mb   |
  |          |  App            | .. centered:: ❌  | .. centered:: ❌            || Requires further development                   |
  +----------+-----------------+-------------------+-----------------------------+-------------------------------------------------+

.. rubric:: Notes

.. [#f1] Browser has to be in Desktop Site mode for the add in to work
.. [#f2] Android App decryption has a bug that after decrypting 1 email it gets stuck on the decrypted email viewing (workaround, restart the app to decrypt another message)