Skip to content

Commit

Permalink
Merge pull request #362 from kobotoolbox/encrypting-forms-minor-edits
Browse files Browse the repository at this point in the history
Update encrypting_forms.md
  • Loading branch information
jamesrkiger authored Mar 13, 2024
2 parents 2230e04 + 57b5c78 commit 196515a
Show file tree
Hide file tree
Showing 9 changed files with 33 additions and 30 deletions.
2 changes: 1 addition & 1 deletion source/about_kobotoolbox.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# About KoboToolbox: Accessible data collection for everyone
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/eccdb7afac11e7af0ce548f7025dad6399a85fe2/source/about_kobotoolbox.md" class="reference">6 Feb 2024</a>
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/ff9303b09ff1c7d67f13fd3dc0e223fe16d545c3/source/about_kobotoolbox.md" class="reference">28 Feb 2024</a>

KoboToolbox makes high quality data accessible to social impact organizations worldwide. Designed by data collection practitioners specifically for challenging settings, KoboToolbox is easy to use, adaptable, and resource efficient.

Expand Down
5 changes: 1 addition & 4 deletions source/audit_logging.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
# Audit Logging Meta Question Type

**Last updated:**
<a href="https://github.com/kobotoolbox/docs/blob/f9bb069f3517cb6d0b581aa7cec180b5ff707d2b/source/audit_logging.md" class="reference">12
Aug 2021</a>
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/4c025cd029fa197f245df6bd394f0ceed21848f5/source/audit_logging.md" class="reference">20 Feb 2024</a>

Audit Logging can be a useful tool to monitor enumerator behavior and discover
which questions are taking longer to answer, better understand how the
Expand Down
30 changes: 18 additions & 12 deletions source/encrypting_forms.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Encrypting Forms
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/94c30eb1a317891733baea7ffcaaa7f7d078a2cd/source/encrypting_forms.md" class="reference">6 Sep 2023</a>
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/18b033da521eb4e00b6ae6a75cbdde57ddaa0a33/source/encrypting_forms.md" class="reference">11 Mar 2024</a>

_This procedure is quite technical and is intended for users who are comfortable
with advanced technical instructions and requires strict attention to detail._
Expand Down Expand Up @@ -35,23 +35,26 @@ key. To understand more about public and private key infrastructure
2. In the downloaded file go to the 'settings' sheet.

3. Add a column _submission_url_ and type
`https://kc.kobotoolbox.org/yourusername/submission` or
`https://kc-eu.kobotoolbox.org/yourusername/submission` (depending
upon the server you are using). Please note that yourusername is your
KoboToolbox user account.
`https://kc.kobotoolbox.org/submission` or
`https://kc-eu.kobotoolbox.org/submission` (depending
upon the server you are using).

4. Add another column _public_key_ (i.e. base64RsaPublicKey). Paste your
5. Add another column _public_key_ (i.e. base64RsaPublicKey). Paste your
compatible public key.

(Please see image below for reference)

![image](/images/encrypting_forms/column.png)

5. Upload the XLS file back to KoboToolbox. You can either import it back to the
6. Upload the XLS file back to KoboToolbox. You can either import it back to the
Form Drafts list and then deploy it as a new survey project, or import it
directly to your deployed Projects list. Once deployed you should see a label
with the text "encrypted" next to your form name.

<p class="note">
Please note that the URL for an authenticated user no longer includes **yourusername** per recent updates.
</p>

## How to decrypt forms

ODK Briefcase is used to download the encrypted files from KoboToolbox and
Expand All @@ -73,8 +76,7 @@ This is required for decryption to be successful.
Enviornment (JRE) of your computer, replacing earlier versions of these
files.
- On **Windows**, the JRE is usually installed here: C:\Program
Files\Java\jre7\lib\securityOn OSX the location is /Library/Internet
Plug-Ins/JavaAppletPlugin.plugin/Contents/Home/lib/security
Files\Java\jre7\lib\security
- On **OSX** the location is /Library/Internet
Plug-Ins/JavaAppletPlugin.plugin/Contents/Home/lib/security

Expand All @@ -89,14 +91,18 @@ This is required for decryption to be successful.

4. Then enter the following:

- `https://kc.kobotoolbox.org/yourusername` OR
`https://kc-eu.kobotoolbox.org/yourusername`(depending on which
- `https://kc.kobotoolbox.org` OR
`https://kc-eu.kobotoolbox.org`(depending on which
server you use)
- Your username
- Your password
- Press **Connect** when done
![image](/images/encrypting_forms/connect.png)

<p class="note">
Please note that the server URLs above no longer need to include **yourusername** per recent updates.
</p>

5. A list of projects is displayed. Select a project that you wish to pull and
press **Pull**. You will receive a message **Success** under the **Pull
Status**.
Expand Down Expand Up @@ -130,7 +136,7 @@ public/private key pair as other methods may not be supported by the software._

1. Open a Windows 'cmd' window.

2. Type the following command: `cd C:\OpenSSL-Win32\bi`n to change to the /bin
2. Type the following command: `cd C:\OpenSSL-Win32\bin` to change to the /bin
directory in the OpenSSL directory.

![image](/images/encrypting_forms/openssl_1.png)
Expand Down
2 changes: 1 addition & 1 deletion source/kobotoolbox_monday_integration.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# KoboToolbox Integration on monday.com
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/f39afcb13c05bce7f4e792903b85df1adbe7a711/source/kobotoolbox_monday_integration.md" class="reference">23 Feb 2024</a>
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/a0b08dd5e4b327efc1018301c75e7c6323c9b71e/source/kobotoolbox_monday_integration.md" class="reference">24 Feb 2024</a>

<p class="note">
This article outlines the early release of the integration between KoboToolbox
Expand Down
2 changes: 1 addition & 1 deletion source/managing_permissions.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Sharing Your Project and Managing Permissions
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/7f83300443438195a50b1cfea0cdc45926d36fc5/source/managing_permissions.md" class="reference">6 Feb 2024</a>
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/51847e7dd985213319ff338e5dbd7075bbf64970/source/managing_permissions.md" class="reference">12 Feb 2024</a>

KoboToolbox allows you to give different levels of access to different users by
setting flexible permission levels within each project. While most users may
Expand Down
2 changes: 1 addition & 1 deletion source/qualitative_analysis.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Qualitative Analysis of Audio Responses
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/7f83300443438195a50b1cfea0cdc45926d36fc5/source/qualitative_analysis.md" class="reference">6 Feb 2024</a>
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/92631e2b6c744c59a0f1637eb76f7f38f1e86bdc/source/qualitative_analysis.md" class="reference">12 Feb 2024</a>

Qualitative analysis can be crucial for research and emergency response, offering in-depth insights often missed in quantitative data collection. KoboToolbox’s qualitative analysis tools help users to efficiently process and understand complex information from open-ended audio responses. Using the qualitative analysis features, you can add new data fields for summarizing, categorizing, and describing audio responses.

Expand Down
16 changes: 8 additions & 8 deletions source/recently_updated.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# Recently updated Support Articles

<!--This page is auto generated using the `scripts/last-updated.py` script, do not update manually-->
1. [Basics of KoboToolbox](welcome.md) (6 Feb 2024)
1. [Sharing Your Project and Managing Permissions](managing_permissions.md) (6 Feb 2024)
1. [Qualitative Analysis of Audio Responses](qualitative_analysis.md) (6 Feb 2024)
1. [About KoboToolbox: Accessible data collection for everyone](about_kobotoolbox.md) (6 Feb 2024)
1. [Restricting Text Responses With Regular Expressions](restrict_responses.md) (6 Feb 2024)
1. [Encrypting Forms](encrypting_forms.md) (11 Mar 2024)
1. [About KoboToolbox: Accessible data collection for everyone](about_kobotoolbox.md) (28 Feb 2024)
1. [KoboToolbox Integration on monday.com](kobotoolbox_monday_integration.md) (24 Feb 2024)
1. [Audit Logging Meta Question Type](audit_logging.md) (20 Feb 2024)
1. [Basics of KoboToolbox](welcome.md) (12 Feb 2024)
1. [Sharing Your Project and Managing Permissions](managing_permissions.md) (12 Feb 2024)
1. [Qualitative Analysis of Audio Responses](qualitative_analysis.md) (12 Feb 2024)
1. [Restricting Text Responses With Regular Expressions](restrict_responses.md) (12 Feb 2024)
1. [Using the Question Library](question_library.md) (5 Jan 2024)
1. [KoboToolbox Integration on monday.com](kobotoolbox_monday_integration.md) (10 Oct 2023)
1. [Resetting Passwords](reset_password.md) (22 Sep 2023)
1. [Data Collection on KoboCollect App (Older Version)](kobocollect-android.md) (21 Sep 2023)
1. [Software Architecture](software_architecture.md) (21 Sep 2023)
2 changes: 1 addition & 1 deletion source/restrict_responses.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Restricting Text Responses With Regular Expressions
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/7f83300443438195a50b1cfea0cdc45926d36fc5/source/restrict_responses.md" class="reference">6 Feb 2024</a>
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/92631e2b6c744c59a0f1637eb76f7f38f1e86bdc/source/restrict_responses.md" class="reference">12 Feb 2024</a>

A regular expression, or regex, is a search pattern used for matching specific
characters and ranges of characters within a string. It is widely used to
Expand Down
2 changes: 1 addition & 1 deletion source/welcome.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Basics of KoboToolbox
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/53a6e1f8b3c5371769411cadbe6ab7abf251e7be/source/welcome.md" class="reference">6 Feb 2024</a>
**Last updated:** <a href="https://github.com/kobotoolbox/docs/blob/048db38b099864b1722b8d0c64135aea9ab55ace/source/welcome.md" class="reference">12 Feb 2024</a>

KoboToolbox is an innovative open source platform for collecting, managing, and visualizing data. It is the mostly widely used data tool for social impact initiatives across the globe. Learn more about [how KoboToolbox supports nonprofit organizations](about_kobotoolbox.md) with access to high quality tools for creating data-driven change.

Expand Down

0 comments on commit 196515a

Please sign in to comment.