forked from sr2/cloud.sr2.uk
feat: reorganise link docs and add proton mail
This commit is contained in:
parent
68ffeeccf3
commit
b9186f4749
22 changed files with 126 additions and 404 deletions
11
docs/link/channels/index.mdx
Normal file
11
docs/link/channels/index.mdx
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
---
|
||||
sidebar_position: 20
|
||||
sidebar_label: Channels Guide
|
||||
---
|
||||
|
||||
import DocCardList from '@theme/DocCardList';
|
||||
import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
|
||||
|
||||
# Channels Guide
|
||||
|
||||
<DocCardList items={useCurrentSidebarCategory().items} />
|
||||
65
docs/link/channels/proton.md
Normal file
65
docs/link/channels/proton.md
Normal file
|
|
@ -0,0 +1,65 @@
|
|||
---
|
||||
title: Proton Mail Channel
|
||||
sidebar_label: Proton Mail Channel
|
||||
sidebar_position: 55
|
||||
description: Using a ProtonMail email account
|
||||
---
|
||||
|
||||
[Proton Mail](https://proton.me/mail) is the largest end-to-end encrypted email hosting service.
|
||||
It was launched in 2014 and is headquartered in Geneva, Switzerland.
|
||||
It is owned by the non-profit Proton Foundation through its subsidiary Proton AG.
|
||||
Proton Mail uses client-side encryption to protect email content and user data before they are sent to Proton Mail
|
||||
servers, unlike other common email providers.
|
||||
|
||||
The source code for the back end of Proton Mail remains closed-source, but Proton Mail released the source code for the
|
||||
web interface, iOS and Android apps, and the [Proton Mail Bridge app](https://github.com/ProtonMail/proton-bridge)
|
||||
under an open-source licence.
|
||||
|
||||
Although Proton Mail's encryption uses the open standard OpenPGP, and the Link platform support OpenPGP when used with
|
||||
other email providers, it is not possible to directly interact with the encryption from the Link platform.
|
||||
This is because Proton Mail does not provide the traditional IMAP and SMTP server endpoints to send and receive emails
|
||||
and only allows connection via the Proton Mail bridge app which handles all encryption and decryption of messages.
|
||||
|
||||
## Requirements
|
||||
|
||||
* You must have a paid plan to use the Proton Mail channel as the use of the Proton Mail Bridge app is not possible on
|
||||
a free account.
|
||||
* Additionally, a user must be dedicated for the use of the helpdesk, it is not sufficient to create an alias on an
|
||||
existing user.
|
||||
|
||||
## Encryption & Key Management
|
||||
|
||||
OpenPGP private keys are created automatically for each Proton Mail account, although these are stored in a way that
|
||||
they are not generally available other than when successfully authenticated to the platform.
|
||||
In the case of Link, this means that the Proton Mail Bridge app is authenticated and then has access to the OpenPGP
|
||||
private key.
|
||||
|
||||
It is not currently possible to import public keys of 3rd-party (i.e. non-Proton Mail) email addresses, and so only
|
||||
emails between Proton Mail users will be end-to-end encrypted.
|
||||
The service also
|
||||
[does not support the Autocrypt standard](https://protonmail.uservoice.com/forums/945460-general-ideas/suggestions/32845105-autocrypt-support),
|
||||
which allows other clients to import discovered public keys automatically on new conversations.
|
||||
The Proton Mail documentation [has more on this topic](https://proton.me/support/proton-mail-encryption-explained).
|
||||
|
||||
We will provide you with your public OpenPGP key when the channel is set up, and you can make this discoverable via your
|
||||
website, but for conversations with 3rd-party accounts we expect the conversations will only be encrypted in one
|
||||
direction and your replies will not be encrypted.
|
||||
|
||||
The helpdesk is unaware of the encryption happening in Protonmail, and cannot inform agents when an email that was sent
|
||||
or received by the helpdesk was encrypted or not.
|
||||
|
||||
## Setting up
|
||||
|
||||
If you do not have an organisational account, we can fully manage the Proton Mail account setup including billing.
|
||||
Please [contact us](https://www.sr2.uk/contact) to discuss this.
|
||||
|
||||
If you have an organisational account,
|
||||
[send an invite for the new user](https://proton.me/support/add-users-organization#create-a-new-user) (the new helpdesk
|
||||
channel address) to contact@sr2.uk, and email the same address to let us know you are doing this and that you would
|
||||
like the channel added to your helpdesk.
|
||||
|
||||
Once the setup is complete we will provide you with OpenPGP public key and will also upload it to
|
||||
[keys.openpgp.org](https://keys.openpgp.org/) to aid in its discovery by users.
|
||||
We can also provide support on setting up Web Key Discovery (WKD) on your custom email domain if desired to further
|
||||
increase the chances that inbound emails will be automatically encrypted, although this still cannot help to encrypt
|
||||
replies to 3rd-party email services.
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Backups
|
||||
sidebar_position: 90
|
||||
sidebar_position: 20
|
||||
---
|
||||
|
||||
## Daily Backups
|
||||
11
docs/link/features/index.mdx
Normal file
11
docs/link/features/index.mdx
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
---
|
||||
sidebar_position: 10
|
||||
sidebar_label: Features
|
||||
---
|
||||
|
||||
import DocCardList from '@theme/DocCardList';
|
||||
import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
|
||||
|
||||
# Features
|
||||
|
||||
<DocCardList items={useCurrentSidebarCategory().items} />
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Security
|
||||
sidebar_position: 50
|
||||
sidebar_position: 10
|
||||
---
|
||||
|
||||
## Application Security
|
||||
11
docs/link/guide/index.mdx
Normal file
11
docs/link/guide/index.mdx
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
---
|
||||
sidebar_position: 20
|
||||
sidebar_label: Agents Guide
|
||||
---
|
||||
|
||||
import DocCardList from '@theme/DocCardList';
|
||||
import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
|
||||
|
||||
# Features
|
||||
|
||||
<DocCardList items={useCurrentSidebarCategory().items} />
|
||||
|
|
@ -4,6 +4,15 @@ sidebar_position: 500
|
|||
|
||||
# CDR Link FAQ
|
||||
|
||||
:::warning[CDR Sunset]
|
||||
The Center for Digital Resilience will be sunsetting, with all programs and activities drawing to a full close on
|
||||
December 31st, 2026.
|
||||
Existing CDR users have been contacted and will all be offered to migrate their service contracts to SR2 at time of
|
||||
renewal.
|
||||
Read more [on our blog](https://www.sr2.uk/posts/2026-link-new-home/).
|
||||
:::
|
||||
|
||||
|
||||
CDR offers hosted Link helpdesk instances managed by [SR2 Communications](https://www.sr2.uk/),
|
||||
a trusted team within the digital rights community, with a proven track record of securely handling sensitive data.
|
||||
|
||||
|
|
|
|||
|
|
@ -8,14 +8,13 @@ import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
|
|||
|
||||
# Link Helpdesk
|
||||
|
||||
:::warning[Under construction]
|
||||
This documentation is a work in progress. Please [get in touch with us](mailto:contact@sr2.uk) if you have any questions.
|
||||
:::
|
||||
|
||||
Our secure digital helpdesk platform, Link, is customised and hardened version of Zammad, an open source, flexible,
|
||||
multi-channel ticketing platform that enables those in need to ask for help, and providers to respond.
|
||||
Our secure digital helpdesk platform, Link, is customised and hardened version of [Zammad](https://zammad.com/en),
|
||||
an open source, flexible, multi-channel ticketing platform that enables those in need to ask for help, and providers to
|
||||
respond.
|
||||
|
||||
The helpdesks have integrations with popular messaging apps, including Signal, WhatsApp, and Telegram, making it easier
|
||||
to securely allow responders to request assistance.
|
||||
|
||||
<img src="/docs/link/active_support.png" style={{width: "100%", maxWidth: "450px", margin: "auto", display: "block"}} />
|
||||
|
||||
<DocCardList items={useCurrentSidebarCategory().items} />
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: Moving Away
|
||||
sidebar_position: 100
|
||||
sidebar_position: 150
|
||||
---
|
||||
|
||||
## Data Portability
|
||||
|
|
|
|||
|
|
@ -24,6 +24,7 @@ please contact us.
|
|||
|
||||
|
||||
### Google mail not working, Oauth token expired
|
||||
|
||||
#### Instructions
|
||||
|
||||
First, someone with admin permissions in your Google organisation needs to navigate to https://console.cloud.google.com/apis/credentials
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue