Skip to content

2.5.0 Test Plan

Jump to bottom
Kevin O'Gorman edited this page Oct 18, 2022 · 14 revisions

2.5.0 QA Checklist

For both upgrades and fresh installs, here is a list of functionality that requires testing. You can use this for copy/pasting into your QA report.

If you have submitted a QA report already for a 2.5.0 release candidate with successful basic server testing and application acceptance testing sections, then you can skip these sections in subsequent reports, unless otherwise indicated by the Release Manager. This is to ensure that you focus your QA effort on the release-specific changes as well as changes since the previous release candidate.

Environment

  • Install target:
  • Tails version:
  • Test Scenario:
  • SSH over Tor:
  • Release candidate:
  • General notes:

Basic Server Testing

  • After installing the testinfra dependencies, all tests in ./securedrop-admin verify are passing:
    • Install dependencies on Admin Workstation with cd ~/Persistent/securedrop && ./securedrop-admin setup -t
    • Run tests with ./securedrop-admin verify (this will take a while)
    • Remove test dependencies: rm -rf admin/.venv3/ && ./securedrop-admin setup
  • After performing Application Acceptance Testing, ./securedrop-admin verify tests still pass.
  • QA Matrix checks pass

Command Line User Generation

  • Can successfully add admin user and login

Administration

  • I have backed up and successfully restored the app server following the backup documentation
  • If doing upgrade testing, make a backup on 2.4.2 and restore this backup on this release candidate
  • "Send Test OSSEC Alert" button in the journalist triggers an OSSEC alert and an email is sent
  • Can successfully add journalist account with HOTP authentication

Application Acceptance Testing

Source Interface

Landing page base cases
  • JS warning bar does not appear when using Security Slider high
  • JS warning bar does appear when using Security Slider Low
First submission base cases
  • On generate page, refreshing page produces a new 7-word codename
  • On submit page, empty submissions produce flashed message
  • On submit page, short message submitted successfully
  • On submit page, file greater than 500 MB produces "The connection was reset" in Tor Browser quickly before the entire file is uploaded
  • On submit page, file less than 500 MB submitted successfully
Returning source base cases
  • Nonexistent codename cannot log in
  • Empty codename cannot log in
  • Legitimate codename can log in
  • Returning user can view journalist replies - need to log into journalist interface to test

Journalist Interface

Login base cases
  • Can log in with 2FA tokens
  • incorrect password cannot log in
  • invalid 2fa token cannot log in
  • 2fa immediate reuse cannot log in
  • Journalist account with HOTP can log in
Index base cases
  • Filter by codename works
  • Starring and unstarring works
  • Click select all selects all submissions
  • Selecting all and clicking "Download" works
Individual source page
  • You can submit a reply and a flashed message and new row appears
  • You cannot submit an empty reply
  • Clicking "Delete Source Account" and the source and docs are deleted
  • You can click on a document and successfully decrypt using application private key

Basic Tails Testing

After updating to this release candidate and running securedrop-admin tailsconfig

  • The Updater GUI appears on boot
  • Updating to 2.4.2 is successful

2.5.0 release-specific changes

  • #6403 Unified Redis-backed sessions

    Note: session info is now stored server-side using Redis. Some useful redis-cli commands for testing include:

    • KEYS <pattern> - lists all keys matching a given pattern
    • GET <key> - returns the given key's value
    • TTL <key> - returns the time-to-live for a given key
    • EXPIRE <key> <sec> - sets a given key's expiry to the <sec> value in seconds

    redis-cli should be run in an app server terminal as the instance redis server is only available locally.

Upgrade-only

  • Upgrade completed successfully from 2.4.2
  • revoked_tokens table is no longer present in database

Login

  • Log in to the JI
  • Confirm that you are logged in as the expected user
  • Edit the js cookie signature in Tor Browser and try to continue browsing the JI
  • Confirm that you are logged out
  • Login to the JI
  • note your session id (in an app-server ssh session, use redis-cli and KEYS js_session:* to check it)
  • Log out, then log back in again
  • check your session id again and confirm that you received a new random-looking session id, and that your previous session id is no longer present

Sessions of multiple users are separate

  • Login to the JI as user X in browser A
  • Login to the JI as user Y in browser B
  • Confirm that you are logged in as the expected user in each session

Sessions are renewed in accordance with the new expiration/renewal policy

  • Login to the JI
  • in an app server ssh session use redis-cli, KEYS *, and EXPIRE <key id> 10 to expire the session
  • Try to continue browsing, and confirm that you are logged out automatically
  • Confirm that a "logged out due to inactivity" message is displayed on the login screen
  • Login to the JI
  • use KEYS * and EXPIRE <key> 1799 to set the key expiry time to less than 30min
  • check the key value with GET <key> and verify that the renew-count value is 5
  • continue browsing in the JI
  • Check the key TTL with TTL <key> and verify that it has had an additional 2hrs added
  • check the key value with GET <key> and verify that the renew-count value is 4
  • repeat the expiry/renewal process 4 more times, verifying that renew-count decreases each time
  • once renew-count is 0, verify that the TTL is no longer renewed by browsing the JI

Logout works

  • Login to the JI as user X in browser A
  • Login to the JI as user Y in browser B
  • Logout from user X in browser A
  • Confirm that user X is logged out
  • Confirm that user Y is still logged in

Deleting a user destroy all sessions of the user

  • Login to the JI as admin X in browser A
  • Login to the JI as admin/user Y in browser B
  • From admin X in browser A, delete user Y
  • Confirm that user Y in browser B is logged out

Changing a user password destroy all sessions of the user

  • Login to the JI as admin X in browser A
  • Login to the JI as admin/user Y in browser B
  • From admin X in browser A, change password of user Y
  • Confirm that user Y in browser B is logged out
  • Login to the JI as admin X
  • Change admin X password
  • Confirm that admin X is logged out on password change

API and securedrop-client

Note: use SecureDrop Workstation, configured to connect to your QA instance

  • Login to securedrop-client
  • Confirm that the login is succesful
  • on the app server, confirm that a session id was created
  • confirm that basic authenticated operations (syncing sources, downloading docs, replies) work in the client
  • Log out in the client (keeping the client session open in offline mode
  • on the app server, confirm that the session id was destroyed
  • Confirm that basic authenticated operations are no longer available in the client
  • #6557, #6475 - locale changes
    • Run ./securedrop_admin sdconfig on the Admin Workstation, and confirm that the list of available languages matches those in the filesecuredrop/i18n.json
    • (install only) set up both Portugese locales during installation, and confirm that they are available in the locale widget in the SI and JI, listed including the locale country name.
  • #6550 - double-escaped org names
    • In the Admin Interface, update the organization name to a string including an ampersand
    • verify that the ampersand is rendered correctly in the SI and JI
  • #6425 - removal of minification
    • in the SI index page source, there is no reference to static/gen/source.js, with the file included from static/js/source.js instead.
    • on the JI all sources page, there is no reference to static/gen/journalist.js, with the file included from static/js/journalist.js instead.
    • on the JI all sources page, with JS enabled, source filtering works correctly.
  • #6609 - Arabic
    • (Install only) Verify that ar is an available language when running ./securedrop-admin sdconfig

Preflight testing

Basic testing

  • Install or upgrade occurs without error
    • Only supported languages can be selected in securedrop-admin sdconfig
  • Source interface is available and version string indicates it is 2.5.0
    • Only configured languages can be selected in the Source and Journalist Interfaces
  • A message can be successfully submitted

Tails testing

  • The updater GUI appears on boot
  • The update successfully occurs to 2.5.0
  • After reboot, updater GUI no longer appears
Clone this wiki locally