authentication-patterns · rohitg00 — скилл для Claude Code: OAuth2, JWT, RBAC
Скилл authentication-patterns для Claude Code содержит паттерны аутентификации и авторизации: JWT, OAuth2 с PKCE, RBAC и middleware. Используйте при разработке защищённого бэкенда.
Apache-2.0 ★ 2 858 обновлён 2026-05-12
npx skills add rohitg00/awesome-claude-code-toolkit --skill authentication-patterns -a claude-codeЧто делает authentication-patterns
Скилл содержит TypeScript-примеры для реализации безопасной аутентификации в Node.js приложениях. Включает короткоживущие access-токены (15 минут) и длинные refresh-токены (7 дней) в HTTP-only cookies, middleware для проверки токенов, OAuth2 Authorization Code Flow с PKCE для публичных клиентов и модель ролевого контроля (RBAC) с проверкой прав на уровне роутов и данных.
Каждый паттерн сопровождается анти-паттернами: хранение JWT в localStorage (уязвимо для XSS), использование одного секрета для нескольких сервисов вместо пары ключей для RS256, отсутствие валидации claims (iss, aud, exp), кастомное хеширование паролей вместо bcrypt или argon2.
Чек-лист помогает не пропустить критичные пункты: проверка токенов на обоих слоях (route и data access), revocation через версию или blocklist, CSRF-защита для cookie-auth, разные сообщения об ошибках для неправильного пароля и отсутствия юзера (защита от перебора).
Какие задачи решает
- Выпустить access- и refresh-токены с разными сроками жизни
- Защитить роут от неавторизованных запросов
- Реализовать OAuth2 с PKCE для публичного клиента
- Разделить доступ по ролям и правам (создание, чтение, редактирование, удаление)
- Избежать уязвимостей: XSS, перебор юзеров, утечка секретов
Примеры запросов агенту
- Реализуй OAuth2 авторизацию с PKCE для нашего фронтенда
- Добавь middleware для проверки JWT в защищённые роуты
- Настрой RBAC: admin может всё, editor создаёт посты, viewer только читает
Как установить authentication-patterns
1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill authentication-patterns -a claude-code2Вручную: положить файлы
~/.claude/skills/authentication-patterns/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/authentication-patterns/
1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill authentication-patterns -a codex2Вручную: положить файлы
.agents/skills/authentication-patterns/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill authentication-patterns -a cursor2Вручную: положить файлы
.cursor/skills/authentication-patterns/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rohitg00/awesome-claude-code-toolkit skills/authentication-patterns2Вручную: положить файлы
.github/skills/authentication-patterns/SKILL.md1Через Skills CLI (Vercel)
npx skills add rohitg00/awesome-claude-code-toolkit --skill authentication-patterns -a gemini-cli2Командой платформы
gemini skills install https://github.com/rohitg00/awesome-claude-code-toolkit --path skills/authentication-patternsВручную: положить файлы
.devin/skills/authentication-patterns/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об authentication-patterns
Как установить authentication-patterns в Claude Code?
Выполни npx skills add rohitg00/awesome-claude-code-toolkit --skill authentication-patterns -a claude-code. Скилл будет доступен в ~/.claude/skills/authentication-patterns/SKILL.md.
Что входит в authentication-patterns?
Примеры JWT токенов (access и refresh), middleware для проверки токенов, OAuth2 Authorization Code Flow с PKCE, ролевой контроль доступа (RBAC), анти-паттерны и чек-лист для безопасной реализации.
Почему refresh-токены нужно хранить в HTTP-only cookies?
HTTP-only cookies защищены от XSS-атак, так как JavaScript не может их прочитать, в отличие от localStorage. Secure флаг гарантирует передачу только по HTTPS, SameSite защищает от CSRF.
Исходный текст
SKILL.md · Apache-2.0
---
name: authentication-patterns
description: Authentication and authorization patterns including OAuth2, JWT, RBAC, session management, and PKCE flows
---
# Authentication Patterns
## JWT Access and Refresh Tokens
```typescript
import jwt from "jsonwebtoken";
interface TokenPayload {
sub: string;
email: string;
roles: string[];
}
function generateTokens(user: User) {
const accessToken = jwt.sign(
{ sub: user.id, email: user.email, roles: user.roles },
process.env.JWT_SECRET!,
{ expiresIn: "15m", issuer: "auth-service" }
);
const refreshToken = jwt.sign(
{ sub: user.id, tokenVersion: user.tokenVersion },
process.env.REFRESH_SECRET!,
{ expiresIn: "7d", issuer: "auth-service" }
);
return { accessToken, refreshToken };
}
function verifyAccessToken(token: string): TokenPayload {
return jwt.verify(token, process.env.JWT_SECRET!, {
issuer: "auth-service",
}) as TokenPayload;
}
```
Short-lived access tokens (15 minutes) with longer-lived refresh tokens (7 days). Store refresh tokens in HTTP-only cookies.
## Auth Middleware
```typescript
function authenticate(req: Request, res: Response, next: NextFunction) {
const header = req.headers.authorization;
if (!header?.startsWith("Bearer ")) {
return res.status(401).json({ error: "Missing authorization header" });
}
try {
const payload = verifyAccessToken(header.slice(7));
req.user = payload;
next();
} catch (error) {
if (error instanceof jwt.TokenExpiredError) {
return res.status(401).json({ error: "Token expired" });
}
return res.status(401).json({ error: "Invalid token" });
}
}
function authorize(...roles: string[]) {
return (req: Request, res: Response, next: NextFunction) => {
if (!req.user) return res.status(401).json({ error: "Not authenticated" });
if (!roles.some(role => req.user.roles.includes(role))) {
return res.status(403).json({ error: "Insufficient permissions" });
}
next();
};
}
app.get("/admin/users", authenticate, authorize("admin"), listUsers);
```
## OAuth2 Authorization Code Flow with PKCE
```typescript
import crypto from "crypto";
function generatePKCE() {
const verifier = crypto.randomBytes(32).toString("base64url");
const challenge = crypto
.createHash("sha256")
.update(verifier)
.digest("base64url");
return { verifier, challenge };
}
app.get("/auth/login", (req, res) => {
const { verifier, challenge } = generatePKCE();
req.session.codeVerifier = verifier;
const params = new URLSearchParams({
response_type: "code",
client_id: process.env.OAUTH_CLIENT_ID!,
redirect_uri: `${process.env.APP_URL}/auth/callback`,
scope: "openid profile email",
code_challenge: challenge,
code_challenge_method: "S256",
state: crypto.randomBytes(16).toString("hex"),
});
res.redirect(`${process.env.OAUTH_AUTHORIZE_URL}?${params}`);
});
app.get("/auth/callback", async (req, res) => {
const { code } = req.query;
const tokenResponse = await fetch(process.env.OAUTH_TOKEN_URL!, {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
grant_type: "authorization_code",
code: code as string,
redirect_uri: `${process.env.APP_URL}/auth/callback`,
client_id: process.env.OAUTH_CLIENT_ID!,
code_verifier: req.session.codeVerifier,
}),
});
const tokens = await tokenResponse.json();
const userInfo = jwt.decode(tokens.id_token);
req.session.user = { id: userInfo.sub, email: userInfo.email };
res.redirect("/dashboard");
});
```
## RBAC Model
```typescript
interface Permission {
resource: string;
action: "create" | "read" | "update" | "delete";
}
const ROLE_PERMISSIONS: Record<string, Permission[]> = {
viewer: [
{ resource: "posts", action: "read" },
{ resource: "comments", action: "read" },
],
editor: [
{ resource: "posts", action: "create" },
{ resource: "posts", action: "read" },
{ resource: "posts", action: "update" },
{ resource: "comments", action: "create" },
{ resource: "comments", action: "read" },
],
admin: [
{ resource: "*", action: "create" },
{ resource: "*", action: "read" },
{ resource: "*", action: "update" },
{ resource: "*", action: "delete" },
],
};
function hasPermission(roles: string[], resource: string, action: string): boolean {
return roles.some(role =>
ROLE_PERMISSIONS[role]?.some(
p => (p.resource === resource || p.resource === "*") && p.action === action
)
);
}
```
## Anti-Patterns
- Storing JWTs in `localStorage` (vulnerable to XSS; use HTTP-only cookies)
- Using symmetric secrets for JWTs across multiple services (use RS256 with key pairs)
- Not validating `iss`, `aud`, and `exp` claims on token verification
- Implementing custom password hashing instead of using bcrypt/argon2
- Missing CSRF protection on cookie-based authentication
- Returning different error messages for "user not found" vs "wrong password" (user enumeration)
## Checklist
- [ ] Access tokens are short-lived (15 minutes or less)
- [ ] Refresh tokens stored in HTTP-only, Secure, SameSite cookies
- [ ] Passwords hashed with bcrypt or argon2 (never MD5/SHA)
- [ ] OAuth2 PKCE flow used for public clients
- [ ] RBAC permissions checked at both route and data access layers
- [ ] Token revocation supported via version counter or blocklist
- [ ] CSRF protection enabled for cookie-based auth
- [ ] Authentication errors do not reveal whether the user exists
© rohitg00 · Apache-2.0 · rohitg00/awesome-claude-code-toolkit
Похожие скиллы
Все скиллы по теме «Бэкенд и API» →Сначала — authentication-patterns от других авторов.