Skip to content

Commit 38d7915

Browse files
authored
Merge pull request rails#46541 from rajivraman/patch-1 [ci skip]
Update upgrading_ruby_on_rails.md to accentuate need for cookie rotator.
2 parents 709ec24 + 63ea21a commit 38d7915

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)