# Hash-elés

> Hogyan lesz az e-mail-címből, a telefonszámból, a szállítási címből és az e-mail domainjéből a TrustOrder által elfogadott hash. Normalizálási szabályok és tesztértékek.

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:

```text
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.

## E-mail

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 |
|---|---|
| `Foo.Bar+shop@GoogleMail.com` | `foobar@gmail.com` |
| `x.y+z@freemail.hu` | `x.y@freemail.hu` |
| `user@bücher.de` | `user@xn--bcher-kva.de` |

## Telefon

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`.

## Cím

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 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

| Fajta | Normalizált érték | Hash |
|---|---|---|
| `email` | `foobar@gmail.com` | `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:

```bash
printf '%s' 'trustorder:v1:email:foobar@gmail.com' | shasum -a 256
```
