Tovább a tartalomhoz
Dokumentáció ehhez: TrustOrder
ENuptools.io
Markdown

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.

  1. Unicode NFC, a két végéről a whitespace levágva, kisbetű (egyszerű leképezés).
  2. Ha a cím belsejében whitespace van, érvénytelen.
  3. Pontosan egy @.
  4. A domain IDNA-val (UTS #46, nem-tranzicionális) ASCII (punycode) alakra.
  5. A helyi részből az első +-tól minden levágva.
  6. A googlemail.com-ból gmail.com lesz; gmail.com-nál a helyi rész minden .-ja törölve.
  7. 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]
  1. 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.
  2. A 00 kezdet + lesz.
  3. 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… HU régióval +36… lesz.
  4. Érvénytelen, ha a libphonenumber szerint az, ha a nemzeti szám egyetlen ismétlődő számjegy, vagy ha 123456789, 1234567 vagy 0123456789.
  5. 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 a h- is); csak a-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.
    1. Ékezetek le (NFD, a kombináló jelek eldobva), kisbetű.
    2. Minden a-z0-9-en kívüli karakter szóköz; a szóközök összevonva.
    3. A budapesti kerület-előtag (XIII. ker.) elmarad.
    4. 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; az ut marad ut.
    5. 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 az i, v és x betűt (emelet római számmal). Az emelet, az ajtó és a 10-12 második fele elmarad.
    6. 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 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).

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:

Terminál
printf '%s' 'trustorder:v1:email:[email protected]' | shasum -a 256