From a592b4694674d84d816d4036ba961c19a7753ba6 Mon Sep 17 00:00:00 2001 From: Sarah Jamie Lewis Date: Wed, 22 Jun 2022 10:56:37 -0700 Subject: [PATCH] Export and Import --- docs/profiles/create-a-profile.md | 2 +- docs/profiles/exporting-profile.md | 19 +++++++++++++++++++ docs/profiles/importing-a-profile.md | 21 +++++++++++++++++++++ 3 files changed, 41 insertions(+), 1 deletion(-) create mode 100644 docs/profiles/exporting-profile.md create mode 100644 docs/profiles/importing-a-profile.md diff --git a/docs/profiles/create-a-profile.md b/docs/profiles/create-a-profile.md index ac750824..16491575 100644 --- a/docs/profiles/create-a-profile.md +++ b/docs/profiles/create-a-profile.md @@ -4,7 +4,7 @@ sidebar_position: 1.5 # Creating a New Profile -1. Press the + action button in the right bottom corner +1. Press the `+` action button in the right bottom corner and select "New Profile" 2. Select a display name 3. Select if you want to protect this profile locally with strong encryption: - Password: your account is protected from other people who may use this device diff --git a/docs/profiles/exporting-profile.md b/docs/profiles/exporting-profile.md new file mode 100644 index 00000000..8a055192 --- /dev/null +++ b/docs/profiles/exporting-profile.md @@ -0,0 +1,19 @@ +--- +sidebar_position: 10 +--- + +# Backup or Exporting a Profile + +On the Profile Management Screen: + +1. Select the pencil next to the profile you want to edit +2. Scroll down to the bottom of the screen +3. Select "Export Profile" +4. Choose a location, and a file name +5. Confirm + +Once confirmed, Cwtch will place a copy of the profile at the given location. This file is encrypted to the same +level that the profile is. See [A note on Password Protected (Encrypted) Profiles](/docs/profiles/create-a-profile#a-note-on-password-protected-encrypted-profiles) for more information on encrypted +profiles. + +This file can be [imported](/docs/profiles/importing-a-profile) into another instance of Cwtch on any device. \ No newline at end of file diff --git a/docs/profiles/importing-a-profile.md b/docs/profiles/importing-a-profile.md new file mode 100644 index 00000000..dc377b97 --- /dev/null +++ b/docs/profiles/importing-a-profile.md @@ -0,0 +1,21 @@ +--- +sidebar_position: 11 +--- + +# Importing a Profile + +1. Press the `+` action button in the right bottom corner and select "Import Profile" +2. Select an [exported Cwtch profile file](/docs/profiles/exporting-profile) to import +3. Enter the [password](/docs/profiles/create-a-profile#a-note-on-password-protected-encrypted-profiles) associated with the profile +and confirm. + +Once confirmed, Cwtch will attempt to decrypt the provided file using a key derived from the given password. If successful +the profile will appear on the Profile Management screen and will be ready to use. + +:::note + +While a profile can be imported onto multiple devices, currently only one version of a profile can be in-use across all devices at any one time. + +Attempts to use the same profile across multiple devices may result in availability issues and messaging failures. + +::: \ No newline at end of file