A Számlázz.hu szerverein rendszer-átalakítást hajtunk végre, az ezzel kapcsolatos fejlesztői információkat gyűjtöttük össze ebben a cikkben.
(For the English version, please scroll down a bit!)
2024. május 10-én éjjel a szervereinken karbantartást végzünk. Olyan technológiai átalakításokat hajtunk végre, amelyeknek lesz néhány elkerülhetetlen következménye, ami érintheti az API interfészeinken keresztül hozzánk kapcsolódó informatikai rendszereket.
IP cím
A jelenlegi fix IP címünk (195.228.16.193) a fenti dátummal megszűnik, és a jövőben több fix IP címen leszünk elérhetőek.
A szamlazz.hu domain név elérhető lesz az alábbi 3 fix ip címen:
- 18.153.1.171,
- 3.73.114.72,
- 52.59.28.5.
Ezek azok az IP címek ahova a böngészők és/vagy Számla Agent kliensek küldhetik a https kéréseiket.
Viszont azok az IP címek, amiken keresztül a szamlazz.hu hívja a külső partnereit, azok ettől eltérő IP címek lesznek a kialakított infrastruktúra miatt.
A fix IP címek amiről a Számlázz.hu fogja hívni a partnereit:
- 3.73.214.98,
- 3.76.149.232,
- 18.153.156.51
A változás érintheti a Számla Agent vagy az Online pénzügyi adatkapcsolat szolgáltatásainkra épített integrációkat egyaránt. Javasoljuk, ha az IP címünket felvettétek valamilyen white list-re, vagy bármilyen egyéb szűrésnél felhasználjátok, akkor ezt a korlátozást vegyétek ki.
HTTPS tanúsítvány
A HTTPS-re használt SSL tanúsítvány (CERTIFICATE) is megváltozik. A változás csak a Számla Agent szolgáltatást használókat érintheti, mivel a böngészők ezt automatikusan kezelik. A mostani NETLOCK helyett a LET'S ENCRYPT lesz a tanúsítvány kibocsátónk. Ez csak a nagyon régi rendszereket érintheti, ahol kézzel kell telepíteni a hiányzó root CA-t.
A https://certtest.szamlazz.hu oldalon elérhető a tanúsitványt, ahol már most mindenki tudja azt tesztelni, és esetleg beállítani.
A mostani gyakorlattól eltérően nem évente, hanem a fenti dátumtól kezdődően 3 havonta fogjuk megújítani az SSL tanúsítványunkat.
PHP API
Amennyiben a legújabb, 2.10.18-as PHP API verziónál régebbi verzió használatával veszed igénybe Számla Agent szolgáltatásunkat, a PHP API kapcsolat zavartalan működése érdekében kérjük, hogy a 2024.05.10-i karbantartás előtt térj át a 2.10.18-as PHP API verzió használatára, ami az alábbi linkről letölthető: https://docs.szamlazz.hu/#php-api.
- HTTP/1.1 és a HTTP/2.0 header kezelés szabvány elvárásai kapcsán, a header kezelésében a kis és nagybetű megkülönböztetés változott.
- A header szabványos működése mellett a 2.10.18-as PHP API verzióból kikerült a tanúsítvány fix helyen történő ellenőrzése, a rugalmasabb működés érdekében.
- Az agent kérésre kapott válaszban lévő minden header nevét kisbetűsre alakítjuk. Ezekből a Schema-Type, a Content-Type és a Content-Disposition fontos, amit a válasz feldolgozásánál használunk.
In English 🇬🇧
On the night of 10 May 2024, we will be performing maintenance on our servers. We are implementing technological changes that will have some unavoidable consequences that may affect the IT systems connected to us through our API interfaces.
IP address
Our current fix IP address (195.228.16.193) will be discontinued as of the above date, and we will be available on multiple fixed IP addresses in the future. The domain name szamlazz.hu will be available on 3 fixed IP addresses.
However, the IP addresses through which szamlazz.hu will call its external partners will be different IP addresses due to the infrastructure set up. The FIX IP addresses from which szamlazz.hu will call its partners are: 3.73.214.98, 3.76.149.232, 18.153.156.51
The change may affect integrations built into either our Account Agent or Online Financial Data Link services. It is recommended that if you have added the IP address to any white list or use it for any other filtering, you need to remove this restriction.
HTTPS Certificate
The SSL certificate, what we used for HTTPS will also change. The change should only affect people using AGENT, as browsers will handle this automatically. LET'S ENCRYPT will be our new certificate issuer instead of the current NETLOCK. At worst, this may only affect very old systems where you have to manually install the missing root CA.
We have posted the certificate on https://certtest.szamlazz.hu so that everyone can test and possibly configure it now.
PHP API
In the context of the HTTP/1.1 and HTTP/2.0 header handling standard requirements, the distinction between upper and lower case letters in header handling has changed. Before maintenance on 10/05/2024, it is recommended to use PHP API version 2.10.18, what can be downloaded from this link: https://docs.szamlazz.hu/#php-api.
In addition to the standard header handling, the fixed-place certificate validation has been removed in PHP API version 2.10.18 for more flexibility, and therefore the use of PHP API version 2.10.18 is recommended before maintenance on 10/05/2024, what can be downloaded from this link: https://docs.szamlazz.hu/#php-api.
All header names in the response to the agent request will be converted to lower case. Of these, the important ones are Schema-Type, Content-Type and Content-Disposition, which are used when processing the response.