Skip to content

LG-752 Verify by mail / undeliverable as addressed processing#2684

Merged
stevegsa merged 11 commits intomasterfrom
stevegsa-undeliverable-as-addressed
Dec 6, 2018
Merged

LG-752 Verify by mail / undeliverable as addressed processing#2684
stevegsa merged 11 commits intomasterfrom
stevegsa-undeliverable-as-addressed

Conversation

@stevegsa
Copy link
Contributor

@stevegsa stevegsa commented Dec 5, 2018

Why: We need to track whether a user has an undeliverable address when they attempt to verify by mail.

How: Download the USPS undeliverable address otp/codes from their sftp site daily. Add a bounced_at field to usps_confirmation_codes and add an index on otp fingerprint. For each code find the entry by otp fingerprint, set the bounced_at timestamp, and send an email notification to the user. Use locking to prevent a user from being notified twice.

Hi! Before submitting your PR for review, and/or before merging it, please
go through the checklists below. These represent the more critical elements
of our code quality guidelines. The rest of the list can be found in
CONTRIBUTING.md

Controllers

  • When adding a new controller that requires the user to be fully
    authenticated, make sure to add before_action :confirm_two_factor_authenticated
    as the first callback.

Database

  • Unsafe migrations are implemented over several PRs and over several
    deploys to avoid production errors. The strong_migrations gem
    will warn you about unsafe migrations and has great step-by-step instructions
    for various scenarios.

  • Indexes were added if necessary. This article provides a good overview
    of indexes in Rails.

  • Verified that the changes don't affect other apps (such as the dashboard)

  • When relevant, a rake task is created to populate the necessary DB columns
    in the various environments right before deploying, taking into account the users
    who might not have interacted with this column yet (such as users who have not
    set a password yet)

  • Migrations against existing tables have been tested against a copy of the
    production database. See LG-228 Make migrations safer and more resilient #2127 for an example when a migration caused deployment
    issues. In that case, all the migration did was add a new column and an index to
    the Users table, which might seem innocuous.

Encryption

  • The changes are compatible with data that was encrypted with the old code.

Routes

  • GET requests are not vulnerable to CSRF attacks (i.e. they don't change
    state or result in destructive behavior).

Session

  • When adding user data to the session, use the user_session helper
    instead of the session helper so the data does not persist beyond the user's
    session.

Testing

  • Tests added for this feature/bug
  • Prefer feature/integration specs over controller specs
  • When adding code that reads data, write tests for nil values, empty strings,
    and invalid inputs.

Why: We need to track whether a user has an undeliverable address when they attempt to verify by mail.

How: Download the USPS undeliverable address otp/codes from their sftp site daily.  Add a bounced_at field to usps_confirmation_codes and add an index on otp fingerprint.  For each code find the entry by otp fingerprint, set the bounced_at timestamp, and send an email notification to the user.  Use locking to prevent a user from being notified twice.
@stevegsa stevegsa force-pushed the stevegsa-undeliverable-as-addressed branch from 11290cf to 6a2baf2 Compare December 5, 2018 06:26
@stevegsa
Copy link
Contributor Author

stevegsa commented Dec 5, 2018

Schema:

screen shot 2018-12-05 at 1 27 23 am

link_text: Go to %{app}
reset_password: If you can't remember your password, go to %{app} to reset it.
undeliverable_address:
call_to_action: Please sign in to login.gov and follow instructions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We tell people to sign in and follow instructions, but the instructions they see will them to enter the code we couldn't send them, right? Should we build in something, either here or in another PR, that shows users something if their letter bounced?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The GUI and this email verbiage is up in the air right now. I guess depending on where we go with the GUI will drive what we say here. Docauth currently does not have a way to change the address so we would need to add a new flow for that.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Okay, cool. Those are all things we can handle outside this PR once we know what needs to happen.

user
temp_file = Tempfile.new('foo')
File.open(temp_file.path, 'w') do |file|
file.puts otp
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The file we get here is just a list of OTPs?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

correct

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Huh, well that makes this easy then

@stevegsa stevegsa merged commit 7412ddd into master Dec 6, 2018
@amathews-fs amathews-fs deleted the stevegsa-undeliverable-as-addressed branch January 7, 2021 18:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants