Hash-elés
A TrustOrder soha nem kap nyers személyes adatot. A kliens normalizálja az azonosítót, és a SHA-256 hash-ét küldi:
hash = kisbetűs hex( sha256( "trustorder:v1:" + kind + ":" + normalizált érték ) )A kind értéke email, phone, address vagy domain. A bemenet UTF-8. A vezetéken a hash pontosan 64 kisbetűs hex karakter (^[0-9a-f]{64}$); minden mást 400-zal elutasít. Ha egy érték nem normalizálható, ahhoz ne küldj hash-t.
Ugyanannak a vásárlónak minden boltban ugyanazt a hash-t kell adnia, ezért a szabályokat pontosan kövesd. A WooCommerce-bővítmény ezeket valósítja meg; a lenti értékekkel a saját megvalósításodat tesztelheted.
- Unicode NFC, a két végéről a whitespace levágva, kisbetű (egyszerű leképezés).
- Ha a cím belsejében whitespace van, érvénytelen.
- Pontosan egy
@. - A domain IDNA-val (UTS #46, nem-tranzicionális) ASCII (punycode) alakra.
- A helyi részből az első
+-tól minden levágva. - A
googlemail.com-bólgmail.comlesz;gmail.com-nál a helyi rész minden.-ja törölve. - Az üres helyi rész érvénytelen; a teljes cím legfeljebb 254 bájt.
| Bemenet | Normalizálva |
|---|---|
[email protected] |
[email protected] |
[email protected] |
[email protected] |
user@bücher.de |
[email protected] |
Telefon
Szekció neve “Telefon”- A két végéről a whitespace levágva; megengedett: számjegy,
+, szóköz és- / ( ) .. Bármi más érvénytelenné teszi. - A
00kezdet+lesz. - libphonenumberrel értelmezd, alapértelmezett régióként a számlázási országgal (ha nincs, a szállítási országgal). A
06…HUrégióval+36…lesz. - Érvénytelen, ha a libphonenumber szerint az, ha a nemzeti szám egyetlen ismétlődő számjegy, vagy ha
123456789,1234567vagy0123456789. - Kimenet E.164-ben:
+36301234567.
A 06 30 123 4567, a 0630/123-4567 és a +36 30 123 4567 (HU régióval) mind +36301234567.
Formátum: ország|irányítószám|utca és házszám, a szállítási címből.
- Ország: kétbetűs ISO 3166 kód, kisbetűvel.
- Irányítószám: minden whitespace törölve, kisbetű, a záró pontok és az
<ország>-előtag levágva (hu-nál ah-is); csaka-z,0-9és-maradhat. - Utca: az 1. címsorból; ha abban nincs házszám, az 1. és a 2. címsorból együtt.
- Ékezetek le (NFD, a kombináló jelek eldobva), kisbetű.
- Minden
a-z0-9-en kívüli karakter szóköz; a szóközök összevonva. - A budapesti kerület-előtag (
XIII. ker.) elmarad. - A közterület-típusok egységesítve:
u,utca→utca;krt,korut→korut;ter,tr→ter;rkp,rakpart→rakpart;stny,setany→setany;ltp,lakotelep→lakotelep; azutmaradut. - A szavak az első olyan számig maradnak, amely szó után áll: ez a házszám. A közvetlenül utána álló egyetlen betű hozzáragad (
12/A→12a), kivéve azi,vésxbetűt (emelet római számmal). Az emelet, az ajtó és a10-12második fele elmarad. - Magyarországon kívül a cím kezdődhet számmal (
10 Downing Street); ilyenkor minden szó megmarad.
| 1. címsor | Normalizálva |
|---|---|
Petőfi Sándor u. 12/A 3. em. 5. (HU, 1051) |
hu|1051|petofi sandor utca 12a |
Fő út 3 (HU, 1051) |
hu|1051|fo ut 3 |
Andrássy krt. 10-12. (HU, 1062) |
hu|1062|andrassy korut 10 |
Az e-mail domainje
Szekció neve “Az e-mail domainje”Az eldobható e-mail-szolgáltatások kiszűréséhez a TrustOrder a cím domainjét is nézi. Küldd el a punycode domain és minden legalább kétcímkés szülő-szuffixének hash-ét, a legspecifikusabbtól, legfeljebb ötöt (email_domain_hashes). Így az x.mailinator.com sem csúszik át a mailinator.com listabejegyzésen. Ha ötnél több ilyen szuffix van, az öt legkevésbé specifikus marad.
Az MX-rekordot magad ellenőrizd, a boltban, és csak az eredményt küldd az email_domain_mx mezőben (true, false, vagy null, ha nem tudod).
Tesztértékek
Szekció neve “Tesztértékek”| Fajta | Normalizált érték | Hash |
|---|---|---|
email |
[email protected] |
8cd79ce2224abde026ddc67563fe5edb8b5eb41846c63cd550a76ea76cc2eddd |
phone |
+36301234567 |
038e5821814169825ae568bfefdb18ca31d4d2e0a0f5941b6da27df45d50ddf4 |
address |
hu|1051|petofi sandor utca 12a |
956b4ad633a194c484c3fdd6d6145ec1ac929b211438b3452e79b4853f65df96 |
domain |
gmail.com |
4672a2431309380c7954c449b3ff20d2cd31968853d6e98137dd3b0be3652dae |
domain |
mailinator.com |
d612e31dc021a25d209e94df9ba873a15ed02e08a48782ca56defc5b1710c8e6 |
Gyors ellenőrzés parancssorból: