Skip to content

Commit bdd5a50

Browse files
committed
Import 2.3 upgrade notes
1 parent f99217b commit bdd5a50

1 file changed

Lines changed: 36 additions & 0 deletions

File tree

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Upgrade notes for SimpleSAMLphp 2.3
2+
3+
SimpleSAMLphp 2.3 is a minor new release which introduces a few new features.
4+
The following changes are relevant for installers and/or developers.
5+
6+
- Session ID's are now hashed when stored in a database. This means all old sessions are effectively
7+
invalidated by this upgrade. We recommend clearing your session store as part of the upgrade-routine.
8+
9+
- Endpoints are now only accepted in array-style. The old string-style was deprecated for 9 yrs
10+
already and was broken anyway. See [endpoints]
11+
12+
[endpoints]: https://simplesamlphp.org/docs/stable/simplesamlphp-metadata-endpoints.html
13+
14+
## Deprecations
15+
16+
The following classes were marked `deprecated` and will be removed in a next major release.
17+
18+
- SimpleSAML\Utils\Net
19+
20+
The following methods were marked `deprecated` and will be removed in a next major release.
21+
22+
- SimpleSAML\Utils\Crypto::aesDecrypt - use the xml-security library instead - See commit `52ef3a78d1faf22e040efd5d0fd1f234da2458eb` for an example.
23+
- SimpleSAML\Utils\Crypto::aesEncrypt - use the xml-security library instead - See commit `52ef3a78d1faf22e040efd5d0fd1f234da2458eb` for an example.
24+
- SimpleSAML\Utils\Crypto::pwHash - Use \Symfony\Component\PasswordHasher\NativePasswordHasher::hash instead
25+
- SimpleSAML\Utils\Crypto::pwValid - Use \Symfony\Component\PasswordHasher\NativePasswordHasher::verify instead
26+
- SimpleSAML\Utils\Crypto::secureCompare - Use hash_equals() instead
27+
- SimpleSAML\Utils\Net::ipCIDRcheck - Use \Symfony\Component\HttpFoundation\IpUtils::checkIp instead
28+
29+
The following properties were marked `deprecated` and will be removed in a next major release.
30+
31+
- SimpleSAML\Locale\Language::$language_names - Use \Symfony\Component\Intl\Languages::getNames() instead
32+
33+
## BC break
34+
35+
Plain-text admin-passwords are no longer allowed.
36+
Please use the `bin/pwgen.php` script to generate a secure password hash.

0 commit comments

Comments
 (0)