diceware-polski 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/LICENSE +21 -0
- data/LICENSE-LISTS +12 -0
- data/README.md +264 -0
- data/exe/diceware-polski +17 -0
- data/lib/diceware_polski/version.rb +5 -0
- data/lib/diceware_polski.rb +65 -0
- data/lists/diceware-pl-ogonki.txt +7776 -0
- data/lists/diceware-pl.txt +7776 -0
- metadata +57 -0
checksums.yaml
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
---
|
|
2
|
+
SHA256:
|
|
3
|
+
metadata.gz: 8241dc7355f35d6308ce231542087e8ca30dcfe7a27111e15bd183f826eacb08
|
|
4
|
+
data.tar.gz: a247bda3d17113ebd7f39161a4e7af05d74861d476f8f9870aaadac2f9cc9411
|
|
5
|
+
SHA512:
|
|
6
|
+
metadata.gz: dd53b7f0748b9a5e0d08baaea67499df22a96b8d66b0797fc7c89477f46f7968f71e41fdc0306ff4d8cbe38ff83d55e7ce5c0152394db448ab85d6b32fa9b72f
|
|
7
|
+
data.tar.gz: 8c13b1c22e0cd9edc4840b347478e303f9cfdf38fdaca9a5ba9b8c8eda934a178f7a9a4a4ff0ef3fa807d695d81f893cd047c382a4ceeb1705a2cb617a64dd6b
|
data/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Poltrax
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
data/LICENSE-LISTS
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
The word lists in lists/ and the derived data in data/ are licensed under the
|
|
2
|
+
Creative Commons Attribution-ShareAlike 4.0 International License (CC BY-SA 4.0).
|
|
3
|
+
Full text: https://creativecommons.org/licenses/by-sa/4.0/legalcode
|
|
4
|
+
|
|
5
|
+
Copyright (c) 2026 Poltrax
|
|
6
|
+
|
|
7
|
+
Built from:
|
|
8
|
+
- SJP.pl dictionary (https://sjp.pl), licensed under GPL 2, LGPL 2.1, Apache 2.0
|
|
9
|
+
and CC BY 4.0; used here under CC BY 4.0.
|
|
10
|
+
- FrequencyWords by Hermit Dave (https://github.com/hermitdave/FrequencyWords),
|
|
11
|
+
content licensed under CC BY-SA 4.0, generated from OpenSubtitles 2018
|
|
12
|
+
(http://opus.nlpl.eu/OpenSubtitles2018.php).
|
data/README.md
ADDED
|
@@ -0,0 +1,264 @@
|
|
|
1
|
+
# diceware-polski
|
|
2
|
+
|
|
3
|
+
<p align="center"><img src="docs/img/og.jpg" width="600" alt="Mikołaj Rej: A niechaj narodowie wżdy postronni znają, iż Polacy nie gęsi, iż swój DICEWARE mają"></p>
|
|
4
|
+
|
|
5
|
+
Pełna polska lista 7776 słów do tworzenia mocnych i łatwych do zapamiętania haseł metodą Diceware.
|
|
6
|
+
|
|
7
|
+
```text
|
|
8
|
+
kot szyba mleko rower las but sen
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
To tylko przykład - nie używaj go jako hasła.
|
|
12
|
+
|
|
13
|
+
## Zupełnie nie znam się na komputerach
|
|
14
|
+
|
|
15
|
+
Wejdź na **[poltrax-live.github.io/diceware-polski](https://poltrax-live.github.io/diceware-polski/)**, kliknij **Losuj** i przepisz słowa do menedżera haseł (albo na kartkę, którą schowasz w domu). Tyle.
|
|
16
|
+
|
|
17
|
+
Strona losuje w Twojej przeglądarce i niczego nigdzie nie wysyła - możesz ją nawet zapisać i otworzyć bez internetu. Wolisz w ogóle bez komputera? [Rzuć kostką](#kostką).
|
|
18
|
+
|
|
19
|
+
## Do czego takie hasło?
|
|
20
|
+
|
|
21
|
+
Do haseł, które musisz **pamiętać i wpisywać palcami**:
|
|
22
|
+
|
|
23
|
+
- hasło główne do menedżera haseł (Bitwarden, 1Password, KeePassXC…),
|
|
24
|
+
- poczta - bo przez nią da się przejąć wszystkie inne konta,
|
|
25
|
+
- konto Apple, Google albo Microsoft,
|
|
26
|
+
- logowanie do komputera i szyfrowanie dysku,
|
|
27
|
+
- domowe Wi-Fi (łatwo je podyktować gościom).
|
|
28
|
+
|
|
29
|
+
Do całej reszty (sklepy, fora, aplikacje) niech hasła losuje menedżer haseł - tych nie musisz pamiętać. I jedno hasło = jedno miejsce.
|
|
30
|
+
|
|
31
|
+
## W 30 sekund
|
|
32
|
+
|
|
33
|
+
1. Otwórz [generator w przeglądarce](https://poltrax-live.github.io/diceware-polski/) albo rzuć kostką ([instrukcja](#kostką)), albo uruchom skrypt: [Windows](#windows), [macOS](#macos), [Linux](#linux), [Python/JS/Ruby](#dla-programistów-python-javascript-ruby).
|
|
34
|
+
2. Weź 7 słów - nie wybieraj ich sam, niech wylosuje kostka albo komputer.
|
|
35
|
+
3. Zapisz wylosowane hasło w menedżerze haseł, np. Bitwarden, KeePassXC lub 1Password.
|
|
36
|
+
|
|
37
|
+
## Czym jest Diceware i czemu to działa?
|
|
38
|
+
|
|
39
|
+
Diceware to metoda wymyślona przez Arnolda Reinholda w 1995 roku. Rzucasz kostką 5 razy, zapisujesz wyniki jako liczbę od `11111` do `66666`, a potem znajdujesz przypisane do niej słowo. Powtarzasz to dla każdego słowa hasła.
|
|
40
|
+
|
|
41
|
+
Pięć rzutów daje 7776 możliwych wyników, dlatego pełna lista ma dokładnie 7776 słów.
|
|
42
|
+
|
|
43
|
+
Można o tym myśleć jak o losowaniu kul z bardzo dużej maszyny: każdy kolejny prawdziwie losowy wybór mocno zwiększa liczbę kombinacji, które musiałby sprawdzić atakujący.
|
|
44
|
+
|
|
45
|
+
Bezpieczeństwo bierze się wyłącznie z losowości i liczby słów na liście. Nie zależy od tajności listy ani języka - zakładamy, że atakujący zna całą listę.
|
|
46
|
+
|
|
47
|
+
## Która lista?
|
|
48
|
+
|
|
49
|
+
| Plik | Co zawiera i kiedy go wybrać |
|
|
50
|
+
| --- | --- |
|
|
51
|
+
| [`lists/diceware-pl.txt`](lists/diceware-pl.txt) | 7776 słów, które w ogóle nie mają polskich znaków, np. „kot” lub „szyba”. To polecana lista, bo hasło wpiszesz również na ekranie logowania przy szyfrowaniu dysku albo na obcej klawiaturze. |
|
|
52
|
+
| [`lists/diceware-pl-ogonki.txt`](lists/diceware-pl-ogonki.txt) | 7776 słów, także z polskimi znakami. Słowa mogą być łatwiejsze do zapamiętania, ale trzeba uważać, gdzie i na jakiej klawiaturze wpisujemy hasło. |
|
|
53
|
+
|
|
54
|
+
Oba pliki mają format znany z list EFF:
|
|
55
|
+
|
|
56
|
+
```text
|
|
57
|
+
11111 słowo
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Słowa są ułożone alfabetycznie. Na liście z polskimi znakami nie ma par, które po ich usunięciu dawałyby to samo słowo, np. „laska” i „łaska” - zostaje tylko jedno.
|
|
61
|
+
|
|
62
|
+
## Ile słów?
|
|
63
|
+
|
|
64
|
+
| Liczba słów | Siła hasła | Zastosowanie |
|
|
65
|
+
| ---: | ---: | --- |
|
|
66
|
+
| 6 | około 77 bitów | Minimum |
|
|
67
|
+
| 7 | około 90 bitów | Polecamy do ważnych rzeczy, np. hasła głównego do menedżera haseł lub szyfrowania dysku |
|
|
68
|
+
| 8 | około 103 bitów | Jeszcze większy zapas |
|
|
69
|
+
|
|
70
|
+
Komputer kwantowy korzystający z algorytmu Grovera w praktyce „obcina” siłę takiego hasła o połowę. Przy 7 słowach nadal zostaje duży zapas.
|
|
71
|
+
|
|
72
|
+
## Czemu słowa, a nie „Kotek123^&*”?
|
|
73
|
+
|
|
74
|
+
Załóżmy najgorsze: ktoś wykradł bazę haseł z serwisu i ma potężny sprzęt - bilion prób na sekundę.
|
|
75
|
+
|
|
76
|
+
| Hasło | Czas złamania | Zapamiętasz? |
|
|
77
|
+
|---|---|---|
|
|
78
|
+
| `Kotek123^&*` | **ułamek sekundy** | tak |
|
|
79
|
+
| `SAsfbGFD$%dfG` - „wymyślone” palcami | dużo krócej, niż wygląda | nie |
|
|
80
|
+
| 13 naprawdę losowych znaków | ok. 700 tys. lat | nie |
|
|
81
|
+
| 6 losowych słów | ok. 3,5 tys. lat | tak |
|
|
82
|
+
| **7 losowych słów** | **ok. 27 mln lat** | **tak** |
|
|
83
|
+
|
|
84
|
+
`Kotek123^&*` spełnia wszystkie wymogi „silnego hasła”: wielka litera, cyfry, znaki specjalne, 11 znaków. Tyle że to słowo + `123` + te same klawisze z Shiftem - pierwszy schemat, który sprawdzają programy do łamania haseł.
|
|
85
|
+
|
|
86
|
+
`SAsfbGFD$%dfG` wygląda losowo, ale człowiek nie umie losować - palce chodzą po sąsiednich klawiszach (`asdf`, `gfd`, `$%`), a to też są znane wzorce. I nikt tego nie zapamięta.
|
|
87
|
+
|
|
88
|
+
Siedem słów z kostki jest i mocniejsze, i do zapamiętania.
|
|
89
|
+
|
|
90
|
+
<sub>Szacunki: połowa wszystkich kombinacji przy 10¹² prób/s. Jeśli serwis dobrze zabezpiecza hasła (np. bcrypt, Argon2), wszystkie czasy rosną tysiące razy - ale „Kotek” i tak pada w kilka tygodni.</sub>
|
|
91
|
+
|
|
92
|
+
## Jak wylosować hasło?
|
|
93
|
+
|
|
94
|
+
### Kostką
|
|
95
|
+
|
|
96
|
+
To najbardziej „paranoiczna” opcja, która nie wymaga komputera.
|
|
97
|
+
|
|
98
|
+
1. Rzuć 5 razy kostką (albo raz pięcioma kostkami i czytaj od lewej). Zapisz wyniki, np. `4 3 1 3 6`.
|
|
99
|
+
2. Znajdź na liście numer `43136` - obok jest słowo.
|
|
100
|
+
3. Powtórz tyle razy, ile słów chcesz (7 słów = 35 rzutów).
|
|
101
|
+
|
|
102
|
+
Gotowa lista do wydruku: [bez polskich znaków](https://poltrax-live.github.io/diceware-polski/lista.html) / [z polskimi znakami](https://poltrax-live.github.io/diceware-polski/lista-ogonki.html) (Ctrl+P / Cmd+P). Kartka nie ma Wi-Fi ;)
|
|
103
|
+
|
|
104
|
+
Kartkę z rzutami zniszcz, gdy zapamiętasz hasło albo przepiszesz je do menedżera.
|
|
105
|
+
|
|
106
|
+
### Windows
|
|
107
|
+
|
|
108
|
+
1. Pobierz repo (**Code → Download ZIP**) i rozpakuj.
|
|
109
|
+
2. Otwórz rozpakowany folder, kliknij prawym przyciskiem w puste miejsce i wybierz **Otwórz w terminalu**.
|
|
110
|
+
3. Wpisz:
|
|
111
|
+
|
|
112
|
+
```powershell
|
|
113
|
+
powershell -ExecutionPolicy Bypass -File .\haslo.ps1
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
Inne warianty:
|
|
117
|
+
|
|
118
|
+
```powershell
|
|
119
|
+
powershell -ExecutionPolicy Bypass -File .\haslo.ps1 -Slowa 8 # 8 słów
|
|
120
|
+
powershell -ExecutionPolicy Bypass -File .\haslo.ps1 -Ogonki # lista z polskimi znakami
|
|
121
|
+
powershell -ExecutionPolicy Bypass -File .\haslo.ps1 -Separator "-" # słowa rozdzielone myślnikiem
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
`-ExecutionPolicy Bypass` jest potrzebne, bo Windows domyślnie nie uruchamia skryptów pobranych z internetu. Działa tylko dla tego jednego uruchomienia, niczego w systemie nie zmienia.
|
|
125
|
+
|
|
126
|
+
### macOS
|
|
127
|
+
|
|
128
|
+
1. Pobierz repo (**Code → Download ZIP**) - rozpakuje się samo w **Pobranych**.
|
|
129
|
+
2. Otwórz **Terminal** (Cmd + spacja, wpisz „Terminal”).
|
|
130
|
+
3. Wpisz:
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
cd ~/Downloads/diceware-polski-main
|
|
134
|
+
python3 haslo.py
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
Inne warianty:
|
|
138
|
+
|
|
139
|
+
```bash
|
|
140
|
+
python3 haslo.py 8 # 8 słów
|
|
141
|
+
python3 haslo.py --ogonki # lista z polskimi znakami
|
|
142
|
+
python3 haslo.py 7 -s - # słowa rozdzielone myślnikiem
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
Jeśli Mac zapyta o zainstalowanie „narzędzi wiersza poleceń” - zgódź się, to dostarcza Pythona. Ten sam skrypt działa też na Windowsie i Linuxie, jeśli masz Pythona.
|
|
146
|
+
|
|
147
|
+
### Linux
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
git clone https://github.com/Poltrax-live/diceware-polski.git
|
|
151
|
+
cd diceware-polski
|
|
152
|
+
./haslo.sh # 7 słów
|
|
153
|
+
./haslo.sh 8 # 8 słów
|
|
154
|
+
./haslo.sh 7 ogonki # lista z polskimi znakami
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
`haslo.sh` używa `shuf` z `/dev/urandom`. Wolisz Pythona? `python3 haslo.py` działa tak samo jak na Macu.
|
|
158
|
+
|
|
159
|
+
### Dla programistów: Python, JavaScript, Ruby
|
|
160
|
+
|
|
161
|
+
```bash
|
|
162
|
+
pip install diceware-polski # Python 3.9+
|
|
163
|
+
npm install diceware-polski # Node.js 19+ i przeglądarki
|
|
164
|
+
gem install diceware-polski # Ruby 2.7+
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
```python
|
|
168
|
+
import diceware_polski
|
|
169
|
+
diceware_polski.generate() # 7 słów
|
|
170
|
+
diceware_polski.generate(words=8, diacritics=True, separator="-")
|
|
171
|
+
diceware_polski.lookup("43136") # słowo dla rzutu kostką
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
```js
|
|
175
|
+
import { generate, lookup } from "diceware-polski";
|
|
176
|
+
generate({ words: 8, diacritics: true, separator: "-" });
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
```ruby
|
|
180
|
+
require "diceware_polski"
|
|
181
|
+
DicewarePolski.generate(words: 8, diacritics: true, separator: "-")
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
Każda paczka ma też komendę `diceware-polski` (np. `diceware-polski 8 --ogonki`).
|
|
185
|
+
|
|
186
|
+
Generatory korzystają z kryptograficznego generatora liczb losowych systemu, a nie ze zwykłego `random`.
|
|
187
|
+
|
|
188
|
+
## Kilka zasad
|
|
189
|
+
|
|
190
|
+
- Nie wybieraj słów samodzielnie. „Losowo” w głowie nie jest losowo.
|
|
191
|
+
- Nie losuj ponownie tylko dlatego, że wypadło słowo, które Ci się nie podoba. Takie poprawianie wyniku trochę osłabia hasło.
|
|
192
|
+
- Nie zmieniaj wylosowanych słów.
|
|
193
|
+
- Nie generuj ważnych haseł na nieznanych stronach internetowych. [Nasza strona](https://poltrax-live.github.io/diceware-polski/) losuje w przeglądarce, nic nie wysyła i ma jawny kod (`docs/index.html`).
|
|
194
|
+
- Nie proś chatbota AI o wygenerowanie hasła. Hasło może wtedy trafić do cudzych logów.
|
|
195
|
+
- Separator możesz wybrać dowolnie, np. spację albo myślnik.
|
|
196
|
+
- Możesz dopisać cyfrę, jeśli serwis tego wymaga.
|
|
197
|
+
- Gotowe hasło zapisz w menedżerze haseł, np. Bitwarden, KeePassXC lub 1Password.
|
|
198
|
+
|
|
199
|
+
Bitwarden ma własny generator haseł ze słów, ale działa on tylko po angielsku i nie pozwala podpiąć własnej listy. Możesz więc wylosować polskie hasło tutaj, a potem ręcznie zapisać je w Bitwardenie.
|
|
200
|
+
|
|
201
|
+
## Dlaczego zrobiliśmy nową listę?
|
|
202
|
+
|
|
203
|
+
Projekt [MaciekTalaska/diceware-pl](https://github.com/MaciekTalaska/diceware-pl) ma 3888 słów, czyli połowę pełnej listy Diceware.
|
|
204
|
+
|
|
205
|
+
Ta lista działa, ale każde wylosowane słowo daje około 11,9 bitu siły zamiast około 12,9 bitu. Żeby uzyskać podobny poziom bezpieczeństwa, trzeba więc użyć większej liczby słów.
|
|
206
|
+
|
|
207
|
+
Projekt Maćka był dla nas inspiracją i należy mu się za to duże dzięki. Z tej samej listy korzysta [diceware.io](https://diceware.io).
|
|
208
|
+
|
|
209
|
+
Jest jeszcze starsza polska lista z pełnymi 7776 pozycjami (np. na [diceware.net](https://www.diceware.net/?dicelist=polish)), ale sporo w niej cyfr, symboli i strzępków typu `:-(`, `io`, `1975` - trudno z niej zapamiętać hasło.
|
|
210
|
+
|
|
211
|
+
My chcieliśmy pełne 7776 pozycji z samych normalnych słów.
|
|
212
|
+
|
|
213
|
+
## Jak powstała lista?
|
|
214
|
+
|
|
215
|
+
1. **Słowa**
|
|
216
|
+
Wzięliśmy formy podstawowe z otwartego słownika [SJP.pl](https://sjp.pl), dostępnego m.in. na licencji CC BY 4.0.
|
|
217
|
+
|
|
218
|
+
2. **Kolejność**
|
|
219
|
+
Uszeregowaliśmy słowa według częstości występowania w napisach filmowych [OpenSubtitles 2018](https://opus.nlpl.eu/OpenSubtitles2018.php), korzystając z projektu [FrequencyWords](https://github.com/hermitdave/FrequencyWords) Hermita Dave'a na licencji CC BY-SA 4.0. Dzięki temu wyżej trafiały słowa, których ludzie naprawdę używają.
|
|
220
|
+
|
|
221
|
+
3. **Sito**
|
|
222
|
+
Zostawiliśmy słowa mające od 3 do 9 liter. Odfiltrowaliśmy imiona, nazwy, marki, skróty, wulgaryzmy, słowa ponure związane m.in. ze śmiercią, przemocą i chorobami, a także słowa obce, rzadkie, specjalistyczne oraz takie z pułapką ortograficzną, np. „morze” i „może”. Ocenę słów wspomagały modele AI Claude, a potem zrobiliśmy osobną kontrolę słów nieprzyzwoitych i dodaliśmy ręczną czarną listę w [`data/blocklist.txt`](data/blocklist.txt).
|
|
223
|
+
|
|
224
|
+
4. **Pilnowanie listy**
|
|
225
|
+
Skrypty sprawdzają, czy każde słowo jest unikalne i czy lista ma dokładnie 7776 pozycji. Na liście z ogonkami pilnujemy też, żeby po usunięciu polskich znaków dwa słowa nie dawały tego samego wyniku. Wszystkie skrypty użyte do budowania list są w katalogu [`scripts/`](scripts/).
|
|
226
|
+
|
|
227
|
+
## Poprawki i zgłoszenia
|
|
228
|
+
|
|
229
|
+
Jeśli znajdziesz słowo dziwne, obraźliwe albo trudne do napisania, załóż [Issue](../../issues) lub wyślij Pull Request.
|
|
230
|
+
|
|
231
|
+
Każda zmiana słowa zmienia również numerację całej listy, dlatego kolejne wersje list tagujemy. Dzięki temu można wrócić do dokładnie tej wersji, której używał konkretny generator.
|
|
232
|
+
|
|
233
|
+
## Licencja i podziękowania
|
|
234
|
+
|
|
235
|
+
- Listy słów: [CC BY-SA 4.0](LICENSE-LISTS), ponieważ źródło danych o częstości słów również korzysta z CC BY-SA 4.0.
|
|
236
|
+
- Kod i skrypty: [MIT](LICENSE).
|
|
237
|
+
|
|
238
|
+
Dzięki dla:
|
|
239
|
+
|
|
240
|
+
- Mikołaja Reja za inspirację (portret: litografia ok. 1850, [Wikimedia Commons](https://commons.wikimedia.org/wiki/File:Miko%C5%82aj_Rey_z_Nag%C5%82owic.jpg), domena publiczna; oryginał cytatu: „…iż swój język mają”, *Do tego co czytał*, 1562),
|
|
241
|
+
|
|
242
|
+
- [SJP.pl](https://sjp.pl) za otwarty słownik,
|
|
243
|
+
- [Hermita Dave'a i projektu FrequencyWords](https://github.com/hermitdave/FrequencyWords) za dane o częstości słów,
|
|
244
|
+
- [OpenSubtitles i OPUS](https://opus.nlpl.eu/OpenSubtitles2018.php) za korpus napisów,
|
|
245
|
+
- [Arnolda Reinholda](https://world.std.com/~reinhold/diceware.html) za metodę Diceware,
|
|
246
|
+
- [EFF](https://www.eff.org/dice) za listy i dobry opis metody,
|
|
247
|
+
- [Maćka Talaski](https://github.com/MaciekTalaska/diceware-pl) za wcześniejszą polską listę i inspirację.
|
|
248
|
+
|
|
249
|
+
## English summary
|
|
250
|
+
|
|
251
|
+
Web generator: https://poltrax-live.github.io/diceware-polski/ (runs locally in the browser, no network requests). Printable lists: `docs/lista.html`, `docs/lista-ogonki.html`.
|
|
252
|
+
|
|
253
|
+
|
|
254
|
+
`diceware-polski` provides two complete Polish Diceware word lists with exactly 7,776 entries each.
|
|
255
|
+
The recommended list contains only words without Polish characters, while the second list also includes words with Polish diacritics.
|
|
256
|
+
Seven randomly selected words provide about 90 bits of entropy and are recommended for important passwords.
|
|
257
|
+
Passwords can be generated with physical dice or the included scripts for Windows, macOS, Linux, and as packages for Python (`pip install diceware-polski`), JavaScript (`npm install diceware-polski`) and Ruby (`gem install diceware-polski`).
|
|
258
|
+
The generators use the operating system's cryptographically secure random number generator.
|
|
259
|
+
The word lists are licensed under CC BY-SA 4.0, while the scripts are available under the MIT license.
|
|
260
|
+
Please do not generate important passwords on websites or ask an AI chatbot to create them.
|
|
261
|
+
|
|
262
|
+
Zrobiliśmy to w [Poltrax](https://poltrax.live), gdzie na co dzień śledzimy GPS-em zawodników na trasach biegów i rajdów rowerowych - tym razem kropki zamieniliśmy na słowa.
|
|
263
|
+
|
|
264
|
+
Autorzy: Michał Piórkowski i [Claude.ai](https://claude.ai).
|
data/exe/diceware-polski
ADDED
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
#!/usr/bin/env ruby
|
|
2
|
+
# frozen_string_literal: true
|
|
3
|
+
|
|
4
|
+
require "optparse"
|
|
5
|
+
require_relative "../lib/diceware_polski"
|
|
6
|
+
|
|
7
|
+
options = { words: DicewarePolski::DEFAULT_WORDS, diacritics: false, separator: " " }
|
|
8
|
+
OptionParser.new do |opts|
|
|
9
|
+
opts.banner = "Użycie: diceware-polski [LICZBA_SŁÓW] [opcje]"
|
|
10
|
+
opts.on("-o", "--ogonki", "Lista z polskimi znakami") { options[:diacritics] = true }
|
|
11
|
+
opts.on("-s", "--separator ZNAK", "Znak między słowami (domyślnie spacja)") { |s| options[:separator] = s }
|
|
12
|
+
opts.on("-v", "--version", "Wersja") { puts DicewarePolski::VERSION; exit }
|
|
13
|
+
end.parse!
|
|
14
|
+
|
|
15
|
+
options[:words] = Integer(ARGV.first) if ARGV.first
|
|
16
|
+
puts DicewarePolski.generate(**options)
|
|
17
|
+
warn format("(siła: ok. %d bitów)", DicewarePolski.entropy_bits(words: options[:words]))
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require "securerandom"
|
|
4
|
+
require_relative "diceware_polski/version"
|
|
5
|
+
|
|
6
|
+
# Polish Diceware word lists (7776 words each) and a passphrase generator.
|
|
7
|
+
#
|
|
8
|
+
# DicewarePolski.generate # => "kot szyba mleko ..." (7 words, no diacritics)
|
|
9
|
+
# DicewarePolski.generate(words: 8, diacritics: true, separator: "-")
|
|
10
|
+
# DicewarePolski.lookup("43136") # => word for a five-dice roll
|
|
11
|
+
module DicewarePolski
|
|
12
|
+
Error = Class.new(StandardError)
|
|
13
|
+
|
|
14
|
+
LIST_SIZE = 7776
|
|
15
|
+
DEFAULT_WORDS = 7
|
|
16
|
+
LISTS_DIR = File.expand_path("../lists", __dir__)
|
|
17
|
+
LIST_FILES = {
|
|
18
|
+
plain: File.join(LISTS_DIR, "diceware-pl.txt"),
|
|
19
|
+
diacritics: File.join(LISTS_DIR, "diceware-pl-ogonki.txt")
|
|
20
|
+
}.freeze
|
|
21
|
+
|
|
22
|
+
module_function
|
|
23
|
+
|
|
24
|
+
# Returns a passphrase built from words chosen with SecureRandom.
|
|
25
|
+
def generate(words: DEFAULT_WORDS, diacritics: false, separator: " ")
|
|
26
|
+
raise ArgumentError, "words must be a positive integer" unless words.is_a?(Integer) && words.positive?
|
|
27
|
+
|
|
28
|
+
list = words_list(diacritics: diacritics)
|
|
29
|
+
Array.new(words) { list[SecureRandom.random_number(list.size)] }.join(separator)
|
|
30
|
+
end
|
|
31
|
+
|
|
32
|
+
# Returns the word for a five-dice roll such as "43136".
|
|
33
|
+
def lookup(roll, diacritics: false)
|
|
34
|
+
roll = roll.to_s
|
|
35
|
+
raise ArgumentError, "roll must be five digits from 1 to 6" unless roll.match?(/\A[1-6]{5}\z/)
|
|
36
|
+
|
|
37
|
+
dice_table(diacritics: diacritics).fetch(roll)
|
|
38
|
+
end
|
|
39
|
+
|
|
40
|
+
# Approximate passphrase strength in bits.
|
|
41
|
+
def entropy_bits(words: DEFAULT_WORDS)
|
|
42
|
+
words * Math.log2(LIST_SIZE)
|
|
43
|
+
end
|
|
44
|
+
|
|
45
|
+
def words_list(diacritics: false)
|
|
46
|
+
dice_table(diacritics: diacritics).values
|
|
47
|
+
end
|
|
48
|
+
|
|
49
|
+
def dice_table(diacritics: false)
|
|
50
|
+
key = diacritics ? :diacritics : :plain
|
|
51
|
+
@dice_tables ||= {}
|
|
52
|
+
@dice_tables[key] ||= load_table(LIST_FILES.fetch(key))
|
|
53
|
+
end
|
|
54
|
+
|
|
55
|
+
def load_table(path)
|
|
56
|
+
table = File.foreach(path, encoding: "UTF-8").each_with_object({}) do |line, acc|
|
|
57
|
+
roll, word = line.split("\t", 2)
|
|
58
|
+
acc[roll] = word.strip.freeze
|
|
59
|
+
end
|
|
60
|
+
raise Error, "#{path}: expected #{LIST_SIZE} words, got #{table.size}" unless table.size == LIST_SIZE
|
|
61
|
+
|
|
62
|
+
table.freeze
|
|
63
|
+
end
|
|
64
|
+
private_class_method :load_table
|
|
65
|
+
end
|