Skip to content

Commit 0e98e47

Browse files
committed
docs: update npm publishing setup with Trusted Publishing instructions
- Add detailed npm Trusted Publishing (OIDC) setup steps - Mark Granular Access Token method as deprecated - Document security benefits and workflow configuration - Reference npm security changes deadline (Nov 15, 2025)
1 parent 03fe863 commit 0e98e47

File tree

1 file changed

+43
-9
lines changed

1 file changed

+43
-9
lines changed

.github/workflows/README.md

Lines changed: 43 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -15,22 +15,56 @@
1515

1616
### Настройка (один раз):
1717

18-
#### 1. Создать NPM Access Token
18+
#### 🔐 NPM Trusted Publishing (Рекомендуется)
19+
20+
**Современный способ без токенов! (с 15 ноября 2025 классические токены будут отключены)**
1921

2022
1. Зайти на [npmjs.com](https://www.npmjs.com/)
21-
2. Settings → Access Tokens → Generate New Token
22-
3. Выбрать тип: **Automation** (для CI/CD)
23-
4. Скопировать токен
23+
2. Перейти к пакету: `@kolkov/angular-editor`
24+
3. **Settings****Publishing Access**
25+
4. **Add Trusted Publisher**
26+
5. Заполнить форму:
27+
- **Provider**: GitHub
28+
- **Organization/User**: `kolkov`
29+
- **Repository**: `angular-editor`
30+
- **Workflow filename**: `npm-publish.yml`
31+
- **Environment**: оставить пустым (или указать `production` если используете)
32+
33+
6. **Save** → Готово! 🎉
34+
35+
**Преимущества:**
36+
- ✅ Не нужны токены (NPM_TOKEN)
37+
- ✅ Автоматическая ротация ключей
38+
- ✅ Provenance (криптографическое подтверждение источника)
39+
- ✅ Повышенная безопасность через OIDC
40+
41+
#### 🔑 Альтернатива: Granular Access Token (устаревший способ)
2442

25-
#### 2. Добавить секрет в GitHub
43+
**Используйте только если Trusted Publishing недоступен**
2644

27-
1. Открыть репозиторий на GitHub
28-
2. Settings → Secrets and variables → Actions
29-
3. New repository secret:
45+
1. Зайти на [npmjs.com](https://www.npmjs.com/)
46+
2. Settings → Access Tokens → Generate New Token
47+
3. Выбрать тип: **Granular Access Token**
48+
4. Настроить:
49+
- **Expiration**: максимум 90 дней
50+
- **Packages**: выбрать `@kolkov/angular-editor`
51+
- **Permissions**: Read and write
52+
5. Скопировать токен
53+
54+
6. Открыть репозиторий на GitHub
55+
7. Settings → Secrets and variables → Actions
56+
8. New repository secret:
3057
- Name: `NPM_TOKEN`
3158
- Secret: вставить токен из npm
3259

33-
#### 3. Готово!
60+
9. Обновить workflow: раскомментировать `NODE_AUTH_TOKEN` в шаге publish
61+
62+
**Недостатки:**
63+
- ⚠️ Токен истекает через 7-90 дней
64+
- ⚠️ Нужно вручную обновлять в GitHub Secrets
65+
- ⚠️ Классические токены будут отключены 15.11.2025
66+
67+
#### ✅ Готово!
3468

3569
Теперь при каждом push тега библиотека будет автоматически опубликована.
3670

0 commit comments

Comments
 (0)