Skip to content

Commit 63ea21a

Browse files
authored
Update upgrading_ruby_on_rails.md
Added note that without a cookie rotator, user sessions could be invalidated during the upgrade. This recently happened to us.
1 parent eb303ad commit 63ea21a

File tree

1 file changed

+3
-2
lines changed

1 file changed

+3
-2
lines changed

guides/source/upgrading_ruby_on_rails.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -416,14 +416,15 @@ request.content_type #=> "text/csv; header=present; charset=utf-16"
416416
request.media_type #=> "text/csv"
417417
```
418418

419-
### Key generator digest class changing to use SHA256
419+
### Key generator digest class change requires a cookie rotator
420420

421421
The default digest class for the key generator is changing from SHA1 to SHA256.
422422
This has consequences in any encrypted message generated by Rails, including
423423
encrypted cookies.
424424

425425
In order to be able to read messages using the old digest class it is necessary
426-
to register a rotator.
426+
to register a rotator. Failing to do so may result in users having their sessions
427+
invalidated during the upgrade.
427428

428429
The following is an example for rotator for the encrypted and the signed cookies.
429430

0 commit comments

Comments
 (0)