Autenticación y autorización
Implemente estrategias de autenticación y autorización de usuarios para proteger los endpoints de su API en el edge.
Autenticación y autorización es una lección gratuita de Edge Computing with Cloudflare Workers & Deno en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Edge Computing with Cloudflare Workers & Deno, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Edge Computing with Cloudflare Workers & Deno incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
Securing Edge APIs
Welcome! In this lesson, we'll dive into Authentication and Authorization for your edge API endpoints.
These are crucial concepts for protecting your applications and ensuring only the right users can access specific resources.
AuthN vs. AuthZ
Let's clarify two key terms:
- Authentication (AuthN): Verifies who you are. Think of it like showing your ID to prove your identity.
- Authorization (AuthZ): Determines what you can do. This is like your ID granting you access to certain areas, but not others.
They often work together, but are distinct processes.
Common Edge Auth Methods
At the edge, we need lightweight and efficient authentication methods. Common approaches include:
- API Keys: Simple secrets used to identify an application or user.
- JSON Web Tokens (JWTs): Self-contained, digitally signed tokens for secure information exchange.
- OAuth/OIDC: More complex protocols for delegated authorization, often relying on JWTs.
We'll focus on API Keys and JWTs.
Implementing API Key Auth
API Keys are straightforward. A client sends a secret key, usually in a header, and your Worker validates it. Let's see a simple example:
export default {
async fetch(request, env, ctx) {
const apiKey = request.headers.get('X-API-Key');
// In a real app, fetch 'MY_API_KEY' from env.MY_API_KEY
if (apiKey !== 'super-secret-key-123') {
return new Response('Unauthorized: Invalid API Key', { status: 401 });
}
return new Response('Access Granted!', { status: 200 });
},
};API Key Auth Explained
In the example, the Worker checks for the X-API-Key header. If it doesn't match our expected secret, access is denied with a 401 Unauthorized status.
For production, always store your API keys securely, typically in Cloudflare Worker environment variables, not directly in your code.
JSON Web Tokens (JWTs)
JWTs are powerful for edge applications because they are self-contained. Once issued by an identity provider, a JWT can be verified by your Worker without needing to contact a central server every time.
A JWT has three parts: Header, Payload, and Signature, separated by dots.
Verifying JWTs on the Edge
Your Worker will receive a JWT, usually in the Authorization: Bearer header. The critical step is to verify its signature to ensure it hasn't been tampered with.
While full cryptographic verification requires a library, here's where you'd typically extract and prepare for verification:
export default {
async fetch(request, env, ctx) {
const authHeader = request.headers.get('Authorization');
if (!authHeader || !authHeader.startsWith('Bearer ')) {
return new Response('Unauthorized: No token', { status: 401 });
}
const token = authHeader.split(' ')[1];
// In a real app, you'd use a crypto library and a secret key
// to verify the token's signature, expiry, and claims.
// e.g., using 'jose' library with `await jwtVerify(token, secretKey)`
if (token) {
// For this example, we'll assume a successful (mock) verification
return new Response('Access Granted with JWT!', { status: 200 });
}
return new Response('Unauthorized: Invalid JWT', { status: 401 });
},
};Role-Based Authorization (RBAC)
Once a user is authenticated (e.g., via a verified JWT), you need to decide what actions they are authorized to perform. This is where Role-Based Access Control (RBAC) comes in.
RBAC assigns permissions to roles (e.g., 'admin', 'user', 'guest'), and users are assigned one or more roles. Your Worker then checks the user's role before allowing an action.
Implementing RBAC in Worker
You can embed user roles or permissions directly into the JWT payload as 'claims'. After verifying the JWT, your Worker can read these claims and enforce authorization rules.
export default {
async fetch(request, env, ctx) {
// Assume JWT is already verified and we have the user's role
// In a real app, this 'userRole' would come from the decoded JWT payload.
const userRole = 'editor'; // Example role from a verified token
if (request.url.includes('/admin') && userRole !== 'admin') {
return new Response('Forbidden: Admins only!', { status: 403 });
}
if (request.method === 'POST' && userRole === 'guest') {
return new Response('Forbidden: Guests cannot create!', { status: 403 });
}
return new Response(`Welcome, ${userRole}! Request processed.`, { status: 200 });
},
};Test Your Understanding
Which of the following statements correctly describe the difference between Authentication and Authorization?
Recap: AuthN & AuthZ
Great job! You've learned the fundamentals of securing your edge APIs.
- Authentication confirms identity.
- Authorization controls access.
- API Keys offer simple authentication.
- JWTs provide secure, self-contained authentication and can carry authorization claims.
- RBAC (Role-Based Access Control) helps define permissions based on user roles.
These strategies are vital for building robust and secure edge applications.
Preguntas frecuentes
¿La lección «Autenticación y autorización» es gratis?
Sí — el texto completo de «Autenticación y autorización» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Edge Computing with Cloudflare Workers & Deno, actualiza a CoddyKit PRO. El curso de Edge Computing with Cloudflare Workers & Deno incluye 4 lecciones en total.
¿Qué aprenderé en «Autenticación y autorización»?
Implemente estrategias de autenticación y autorización de usuarios para proteger los endpoints de su API en el edge. Practicas Edge Computing with Cloudflare Workers & Deno con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Edge Computing with Cloudflare Workers & Deno?
No se requiere experiencia previa. Edge Computing with Cloudflare Workers & Deno en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.
¿Cuánto tiempo toma la lección «Autenticación y autorización»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Edge Computing with Cloudflare Workers & Deno?
Sí. Cada lección de Edge Computing with Cloudflare Workers & Deno incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Autenticación y autorización
- Limitación de tasa y protección contra DDoS
- Gestión segura de secretos
- Saneamiento de entradas y prevención de inyecciones