OWACurrent en:Commissioning: Unterschied zwischen den Versionen
K (gramr) |
(re-ordering documentation to more accurately describe install flow) |
||
| (6 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
= Obtaining a Cryptshare for OWA Release = | = Obtaining a Cryptshare for OWA Release = | ||
You | You may obtain the latest version of Cryptshare for OWA in the Cryptshare Customer section on the [https://login.cryptshare.com/ Pointsharp GmbH Homepage]. | ||
= | |||
= Overview = | |||
To install and use the OWA add-in, the following steps are required: | To install and use the OWA add-in, the following steps are required: | ||
* [[{{NAMESPACE}}:SSL & HTTPS Access|Enable SSL / HTTPS on the Cryptshare Server]] | * [[{{NAMESPACE}}:SSL & HTTPS Access|Enable SSL / HTTPS on the Cryptshare Server]] | ||
* Upload the add-in to the Cryptshare Server | * Upload the add-in to the Cryptshare Server | ||
* Create an app registration permitting Microsoft Graph access on the Microsoft Azure App Portal | |||
* Upload CSOW language packs to the Cryptshare Server | * Upload CSOW language packs to the Cryptshare Server | ||
* Deploy the provided add-in via Microsoft Exchange Online | * Deploy the provided add-in via Microsoft Exchange Online | ||
{{NoteBox|title=SSL/HTTPS is mandatory!|content=The add-in cannot function without SSL or HTTPS being set up correctly. Refer to [[{{NAMESPACE}}:SSL & HTTPS Access|SSL & HTTPS Access]] for setup instructions. For additional information, refer to the [[CSSCurrent_en:Requirements_for_all_Systems|related guide in the Server documentation.]]}} | |||
== First installation steps == | |||
Before continuing, make sure that [[{{NAMESPACE}}:SSL & HTTPS Access|SSL/HTTPS access]] is enabled on the server. | |||
In order to finalize the installation, you must be able to access the [https://portal.azure.com/ Microsoft Azure App Portal], and have the permissions to create new application registrations for your tenant. | |||
== Upload the add-in == | |||
1. Open the administration interface of the Cryptshare Server and navigate to '''Add-on Products → Cryptshare for OWA'''. The opened view will display information about the currently installed add-in, if available, and provides the option to upload the add-in package. | |||
2. Click on 'Browse...' and select the previously downloaded .zip file. | |||
[[File:FileBrowseDialogue.png|frameless|border|x50px]][[File:72319892.png|frameless|border|x50px]] | |||
3. Click on 'Upload Add-In' to start the upload process. | |||
[[File:UploadAddinButton.png|frameless|border]] | |||
4. After the add-in has been installed successfully, the view should update with relevant information about the installed add-in version. | |||
[[File:UploadSuccessful.png|frameless|border|x300px]] | |||
5. Copy the manifest URL to your clipboard (Ctrl+C), or store it somewhere else for the time being. You will need this to deploy the add-in once ready. | |||
== Setting up Micosoft Graph Access == | |||
The add-in utilizes Microsoft Graph to provide some of it's functionality. This requires registering an application on the Azure App platform, and granting it the relevant permissions for your desired tenants. | |||
For detailed instructions, please refer to [[{{NAMESPACE}}:Setting_up_MS_Graph|the documentation on Azure app registration.]] | |||
[[ | == Upload language packages== | ||
Please refer to the Server documentation '[[CSSCurrent_en:Installing Language Packages|Installing Language Packages]]' on how to install language packages. | |||
Language packages for the OWA add-in are available [[{{NAMESPACE}}:Language_Packages|here.]] | |||
= Deployment = | == Deployment == | ||
The Add-in is now provided by the Cryptshare Server at the manifest URL you have copied in the previous | The Add-in is now provided by the Cryptshare Server at the manifest URL you have copied in the previous steps. | ||
To make it accessible to your users, you will have to deploy the add-in. | To make it accessible to your users, you will have to deploy the add-in. | ||
| Zeile 37: | Zeile 52: | ||
The following links will redirect to the knowledgebase articles of Microsoft for the respective setups. Follow the "Custom Apps" sections of these guides. | The following links will redirect to the knowledgebase articles of Microsoft for the respective setups. Follow the "Custom Apps" sections of these guides. | ||
{{NoteBox|title=Single-User deployment has changed|content=Due to changes made in Outlook by Microsoft, the process of adding custom add-ins to single user installations has recently changed. Please follow the instructions found in the official documentation below, as they are subject to change with the releases of newer Outlook on the Web clients.}} | |||
*[https://learn.microsoft.com/en-us/microsoft-365/admin/manage/manage-deployment-of-add-ins?view=o365-worldwide Deployment via Microsoft Exchange Online (Recommended)] | |||
*[https://support.microsoft.com/en-us/office/using-add-ins-in-outlook-on-the-web-8f2ce816-5df4-44a5-958c-f7f9d6dabdce Single-User Deployment] | |||
Aktuelle Version vom 26. Januar 2024, 16:07 Uhr
You may obtain the latest version of Cryptshare for OWA in the Cryptshare Customer section on the Pointsharp GmbH Homepage.
Overview
To install and use the OWA add-in, the following steps are required:
- Enable SSL / HTTPS on the Cryptshare Server
- Upload the add-in to the Cryptshare Server
- Create an app registration permitting Microsoft Graph access on the Microsoft Azure App Portal
- Upload CSOW language packs to the Cryptshare Server
- Deploy the provided add-in via Microsoft Exchange Online
First installation steps
Before continuing, make sure that SSL/HTTPS access is enabled on the server.
In order to finalize the installation, you must be able to access the Microsoft Azure App Portal, and have the permissions to create new application registrations for your tenant.
Upload the add-in
1. Open the administration interface of the Cryptshare Server and navigate to Add-on Products → Cryptshare for OWA. The opened view will display information about the currently installed add-in, if available, and provides the option to upload the add-in package.
2. Click on 'Browse...' and select the previously downloaded .zip file.
3. Click on 'Upload Add-In' to start the upload process.
4. After the add-in has been installed successfully, the view should update with relevant information about the installed add-in version.
5. Copy the manifest URL to your clipboard (Ctrl+C), or store it somewhere else for the time being. You will need this to deploy the add-in once ready.
Setting up Micosoft Graph Access
The add-in utilizes Microsoft Graph to provide some of it's functionality. This requires registering an application on the Azure App platform, and granting it the relevant permissions for your desired tenants.
For detailed instructions, please refer to the documentation on Azure app registration.
Upload language packages
Please refer to the Server documentation 'Installing Language Packages' on how to install language packages.
Language packages for the OWA add-in are available here.
Deployment
The Add-in is now provided by the Cryptshare Server at the manifest URL you have copied in the previous steps.
To make it accessible to your users, you will have to deploy the add-in.
You may either deploy it using Microsoft Exchange Online, or deploy it on a single-user basis. The following links will redirect to the knowledgebase articles of Microsoft for the respective setups. Follow the "Custom Apps" sections of these guides.