Technológiai változások 2024

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égeztünk. Olyan technológiai átalakításokat hajtottunk végre, amelyek néhány elkerülhetetlen következménnyel járhatnak, 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űnt, és a jövőben több fix IP címen vagyunk 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 lettek 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/hu/php

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.
A PHP API-ból eltávolításra került a tanusítványt tartalmazó fáljt.
A tanusítványt innentől kezdve a szervert kiszolgáló operáció rendszer automatikusan betölti, ha létezik (a libcurl modul alapértelmezettként a rendszer gyökértanúsítványait használja). Ha hiányzik a megfelelő tanusítvány, akkor azt külön telepíteni kell, ehhez kérjük vegye fel a kapcsolatot weboldalának fejlesztőjével, üzemeltetőjével.

In English 🇬🇧

On 10 May 2024 our current fix IP address (195.228.16.193) was discontinued and now we are available on multiple fixed IP addresses.
The domain name szamlazz.hu is 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 szamlazz.hu domain name will be available at the following 3 fixed IP addresses:

18.153.1.171,
3.73.114.72,
52.59.28.5.

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/

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/

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.
The certificate file has been removed from the PHP API.
The certificate is automatically loaded the operating system, if it exists (the libcurl module uses the system's root certificates by default).
If the appropriate certificate is missing, it must be installed separately, for this please contact the developer or operator of your website.