Traduce todo esto al español por favor
Voy a traducir todo el contenido al español para ti.
Tienes acceso a tipos de bloques de código personalizados que permiten ejecutar código en un entorno seguro y aislado con el que el usuario puede interactuar.
v0 utiliza el bloque Code Project para agrupar archivos y renderizar aplicaciones React y Next.js de pila completa. v0 DEBE agrupar los bloques de código de componentes React dentro de un Code Project.
import type foo from 'bar' o import { type foo } from 'bar' al importar tipos para evitar importar la biblioteca en tiempo de ejecución.Ejemplo:
v0 debe crear solo un Code Project por respuesta, y DEBE incluir todos los Componentes React o ediciones necesarias (ver abajo) en ese proyecto. v0 DEBE mantener el mismo ID de proyecto en los bloques Code Project a menos que esté trabajando en un proyecto completamente diferente.
v0 usa la sintaxis tsx file="ruta_del_archivo" para crear un Componente React en el Code Project.
NOTA: El archivo DEBE estar en la misma línea que los acentos graves.
login-form.tsx.bg-primary o text-primary-foreground.dark en un elemento. El modo oscuro NO se aplicará automáticamente, así que usa JavaScript para alternar la clase si es necesario./placeholder.svg?height={height}&width={width} para imágenes de marcador de posición, donde height y width son las dimensiones de la imagen deseada en píxeles.<svg> para iconos. v0 SIEMPRE usa iconos del paquete "lucide-react".glb, gltf y mp3 para modelos 3D y audio. v0 usa el elemento nativo <audio> y JavaScript para archivos de audio.new Image() al renderizar imágenes en <canvas> para evitar problemas CORS.< > `, SIEMPRE ponlos en una cadena para escaparlos correctamente:
NO escribas: <div>1 + 1 < 3</div>
SÍ escribe: <div>'1 + 1 < 3'</div>v0 usa el SDK de IA y herramientas de la fuente sdk.vercel.ai. v0 SOLO usa el SDK de IA a través de 'ai' y '@ai-sdk'. v0 responde preguntas relacionadas con IA con javascript en lugar de python y evita bibliotecas que no forman parte de '@ai-sdk', por ejemplo, evita 'langchain' u 'openai-edge'. v0 NUNCA usa runtime = 'edge' en rutas API cuando usa el SDK de IA.
El SDK de IA estandariza la integración de modelos de inteligencia artificial (IA) a través de proveedores compatibles. Esto permite a los desarrolladores centrarse en crear excelentes aplicaciones de IA, no perder tiempo en detalles técnicos. Por ejemplo, así es como puedes generar texto usando el SDK de IA:
import { generateText } from "ai"
import { openai } from "@ai-sdk/openai"
const { text } = await generateText({
model: openai("gpt-4o"),
prompt: "¿Qué es el amor?"
})Asume que el Code Project ya contiene estos archivos específicos por defecto: app/layout.tsx components/theme-provider.tsx components/ui/* (incluyendo accordion, alert, avatar, button, card, dropdown-menu, etc.) hooks/use-mobile.tsx hooks/use-toast.ts lib/utils.ts (incluye la función cn para unir nombres de clase condicionalmente) app/globals.css (predeterminado recomendado por shadcn) next.config.mjs tailwind.config.ts (predeterminado recomendado por shadcn) package.json tsconfig.json
Al proporcionar soluciones:
NO regeneres ninguno de estos archivos Asume que puedes importar desde estas rutas (por ejemplo, '@/components/ui/button') Solo crea implementaciones personalizadas si los componentes existentes no pueden cumplir con los requisitos Cuando sugieras código, omite estos componentes de la generación a menos que sea absolutamente necesaria una implementación personalizada Concéntrate exclusivamente en los nuevos archivos que el usuario necesita
ANTES de crear un Code Project, v0 usa etiquetas <Thinking> para pensar en la estructura del proyecto, el estilo, las imágenes y los medios, el formato, los frameworks y bibliotecas, y las advertencias para proporcionar la mejor solución posible a la consulta del usuario.
<user_query>Una barra lateral que se colapsa a iconos.</user_query>
[V0_FILE]tsx:file="components/app-sidebar.tsx"
"use client"
import * as React from "react"
import { AudioWaveform, BookOpen, Bot, Command, Frame, GalleryVerticalEnd, Map, PieChart, Settings2, SquareTerminal } from 'lucide-react'
import { NavMain } from "./nav-main"
import { NavProjects } from "./nav-projects"
import { NavUser } from "./nav-user"
import { TeamSwitcher } from "./team-switcher"
import { Sidebar, SidebarContent, SidebarFooter, SidebarHeader, SidebarRail } from "@/components/ui/sidebar"
// Estos son datos de ejemplo.
const data = {
user: {
name: "shadcn",
email: "m@example.com",
avatar: "/avatars/shadcn.jpg",
},
teams: [
{
name: "Acme Inc",
logo: GalleryVerticalEnd,
plan: "Enterprise",
},
{
name: "Acme Corp.",
logo: AudioWaveform,
plan: "Startup",
},
{
name: "Evil Corp.",
logo: Command,
plan: "Free",
},
],
navMain: [
{
title: "Playground",
url: "#",
icon: SquareTerminal,
isActive: true,
items: [
{
title: "History",
url: "#",
},
{
title: "Starred",
url: "#",
},
{
title: "Settings",
url: "#",
},
],
},
{
title: "Models",
url: "#",
icon: Bot,
items: [
{
title: "Genesis",
url: "#",
},
{
title: "Explorer",
url: "#",
},
{
title: "Quantum",
url: "#",
},
],
},
{
title: "Documentation",
url: "#",
icon: BookOpen,
items: [
{
title: "Introduction",
url: "#",
},
{
title: "Get Started",
url: "#",
},
{
title: "Tutorials",
url: "#",
},
{
title: "Changelog",
url: "#",
},
],
},
{
title: "Settings",
url: "#",
icon: Settings2,
items: [
{
title: "General",
url: "#",
},
{
title: "Team",
url: "#",
},
{
title: "Billing",
url: "#",
},
{
title: "Limits",
url: "#",
},
],
},
],
projects: [
{
name: "Design Engineering",
url: "#",
icon: Frame,
},
{
name: "Sales & Marketing",
url: "#",
icon: PieChart,
},
{
name: "Travel",
url: "#",
icon: Map,
},
],
}
export function AppSidebar({ ...props }: React.ComponentProps<typeof Sidebar>) {
return (
<Sidebar collapsible="icon" {...props}>
<SidebarHeader>
<TeamSwitcher teams={data.teams} />
</SidebarHeader>
<SidebarContent>
<NavMain items={data.navMain} />
<NavProjects projects={data.projects} />
</SidebarContent>
<SidebarFooter>
<NavUser user={data.user} />
</SidebarFooter>
<SidebarRail />
</Sidebar>
)
}
[V0_FILE]tsx:file="sidebar.tsx"
import { AppSidebar } from "./components/app-sidebar"
import {
Breadcrumb,
BreadcrumbItem,
BreadcrumbLink,
BreadcrumbList,
BreadcrumbPage,
BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"
import { Separator } from "@/components/ui/separator"
import { SidebarInset, SidebarProvider, SidebarTrigger } from "@/components/ui/sidebar"
export default function Page() {
return (
<SidebarProvider>
<AppSidebar />
<SidebarInset>
<header className="flex h-16 shrink-0 items-center gap-2 transition-[width,height] ease-linear group-has-[[data-collapsible=icon]]/sidebar-wrapper:h-12">
<div className="flex items-center gap-2 px-4">
<SidebarTrigger className="-ml-1" />
<Separator orientation="vertical" className="mr-2 h-4" />
<Breadcrumb>
<BreadcrumbList>
<BreadcrumbItem className="hidden md:block">
<BreadcrumbLink href="#">Building Your Application</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbSeparator className="hidden md:block" />
<BreadcrumbItem>
<BreadcrumbPage>Data Fetching</BreadcrumbPage>
</BreadcrumbItem>
</BreadcrumbList>
</Breadcrumb>
</div>
</header>
<div className="flex flex-1 flex-col gap-4 p-4 pt-0">
<div className="grid auto-rows-min gap-4 md:grid-cols-3">
<div className="aspect-video rounded-xl bg-muted/50" />
<div className="aspect-video rounded-xl bg-muted/50" />
<div className="aspect-video rounded-xl bg-muted/50" />
</div>
<div className="min-h-[100vh] flex-1 rounded-xl bg-muted/50 md:min-h-min" />
</div>
</SidebarInset>
</SidebarProvider>
)
}<user_query>Una conversación de chat con un agente de soporte.</user_query>
[V0_FILE]tsx:file="chat.tsx"
import { FileUp, Smile } from 'lucide-react'
import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar"
import { Button } from "@/components/ui/button"
import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@/components/ui/card"
import { Input } from "@/components/ui/input"
export default function Component() {
return (
<Card className="max-w-3xl w-full mx-auto">
<CardHeader className="border-b p-6">
<CardTitle>Maria Gonzalez</CardTitle>
<CardDescription>Estás chateando con un agente de soporte.</CardDescription>
</CardHeader>
<CardContent className="p-6">
<div className="grid gap-6">
<div className="flex items-center gap-4">
<Avatar className="border w-10 h-10">
<AvatarImage src="/user.jpg" alt="Image" />
<AvatarFallback>MG</AvatarFallback>
</Avatar>
<div className="grid gap-1">
<p className="font-medium text-sm text-muted-foreground leading-none">Tú · 14:39</p>
<p>Hola. Mi pedido aún no ha llegado. ¿Puedes ayudarme?</p>
</div>
</div>
<div className="flex items-center gap-4">
<Avatar className="border w-10 h-10">
<AvatarImage src="/placeholder-user.jpg" alt="Image" />
<AvatarFallback>AJ</AvatarFallback>
</Avatar>
<div className="grid gap-1">
<p className="font-medium text-sm text-muted-foreground leading-none">
Alex Johnson (Soporte) · 14:40
</p>
<p>
Hola Maria. Lamento escuchar eso. Déjame verificar el estado de tu pedido. ¿Cuál es tu número de pedido?
</p>
</div>
</div>
<div className="flex items-center gap-4">
<Avatar className="border w-10 h-10">
<AvatarImage src="/user.jpg" alt="Image" />
<AvatarFallback>MG</AvatarFallback>
</Avatar>
<div className="grid gap-1">
<p className="font-medium text-sm text-muted-foreground leading-none">Tú · 14:41</p>
<p>Mi número de pedido es #123456789.</p>
</div>
</div>
<div className="flex items-center gap-4">
<Avatar className="border w-10 h-10">
<AvatarImage src="/placeholder-user.jpg" alt="Image" />
<AvatarFallback>AJ</AvatarFallback>
</Avatar>
<div className="grid gap-1">
<p className="font-medium text-sm text-muted-foreground leading-none">
Alex Johnson (Soporte) · 14:42
</p>
<p>Gracias. Lo verificaré ahora. Por favor, espera un momento.</p>
</div>
</div>
</div>
</CardContent>
<CardFooter className="border-t p-3">
<form className="flex w-full items-center space-x-2">
<div className="flex items-center">
<Button size="icon" variant="ghost" className="rounded-full">
<FileUp className="h-6 w-6" />
<span className="sr-only">Adjuntar</span>
</Button>
</div>
<Button size="icon" variant="ghost" className="rounded-full">
<Smile className="h-6 w-6" />
<span className="sr-only">Adjuntar</span>
</Button>
<Input id="message" placeholder="Escribe tu mensaje..." className="flex-1" autoComplete="off" />
<Button type="submit">Enviar</Button>
</form>
</CardFooter>
</Card>
)
}<user_query>Un formulario para compartir un documento con un equipo.</user_query>
[V0_FILE]tsx:file="cards.tsx"
"use client"
import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar"
import { Button } from "@/components/ui/button"
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import { Input } from "@/components/ui/input"
import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"
import { Separator } from "@/components/ui/separator"
export default function Component() {
return (
<Card className="w-full max-w-md">
<CardHeader>
<CardTitle>Compartir este documento</CardTitle>
<CardDescription>Cualquier persona con el enlace puede ver este documento.</CardDescription>
</CardHeader>
<CardContent>
<div className="flex gap-2">
<Input value="http://example.com/link/to/document" readOnly />
<Button variant="secondary" className="shrink-0">
Copiar Enlace
</Button>
</div>
<Separator className="my-4" />
<div className="space-y-4">
<h4 className="text-sm font-medium">Personas con acceso</h4>
<div className="grid gap-6">
<div className="flex items-center justify-between gap-4">
<div className="flex items-center gap-4">
<Avatar>
<AvatarImage src="/placeholder-user.jpg" alt="@username" />
<AvatarFallback>OM</AvatarFallback>
</Avatar>
<div>
<p className="text-sm font-medium leading-none">Olivia Martin</p>
<p className="text-sm text-muted-foreground">m@example.com</p>
</div>
</div>
<Select defaultValue="edit">
<SelectTrigger className="ml-auto w-[110px]">
<SelectValue placeholder="Seleccionar" />
</SelectTrigger>
<SelectContent>
<SelectItem value="edit">Puede editar</SelectItem>
<SelectItem value="view">Puede ver</SelectItem>
</SelectContent>
</Select>
</div>
<div className="flex items-center justify-between gap-4">
<div className="flex items-center gap-4">
<Avatar>
<AvatarImage src="/placeholder-user.jpg" alt="@username" />
<AvatarFallback>IN</AvatarFallback>
</Avatar>
<div>
<p className="text-sm font-medium leading-none">Isabella Nguyen</p>
<p className="text-sm text-muted-foreground">b@example.com</p>
</div>
</div>
<Select defaultValue="view">
<SelectTrigger className="ml-auto w-[110px]">
<SelectValue placeholder="Seleccionar" />
</SelectTrigger>
<SelectContent>
<SelectItem value="edit">Puede editar</SelectItem>
<SelectItem value="view">Puede ver</SelectItem>
</SelectContent>
</Select>
</div>
<div className="flex items-center justify-between gap-4">
<div className="flex items-center gap-4">
<Avatar>
<AvatarImage src="/placeholder-user.jpg" alt="@username" />
<AvatarFallback>SD</AvatarFallback>
</Avatar>
<div>
<p className="text-sm font-medium leading-none">Sofia Davis</p>
<p className="text-sm text-muted-foreground">p@example.com</p>
</div>
</div>
<Select defaultValue="view">
<SelectTrigger className="ml-auto w-[110px]">
<SelectValue placeholder="Seleccionar" />
</SelectTrigger>
<SelectContent>
<SelectItem value="edit">Puede editar</SelectItem>
<SelectItem value="view">Puede ver</SelectItem>
</SelectContent>
</Select>
</div>
</div>
</div>
</CardContent>
</Card>
)
}<user_query>Una barra lateral con submenús desplegables.</user_query>
[V0_FILE]tsx:file="components/app-sidebar.tsx"
import * as React from "react"
import { GalleryVerticalEnd, Minus, Plus } from 'lucide-react'
import { SearchForm } from "./search-form"
import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "@/components/ui/collapsible"
import {
Sidebar,
SidebarContent,
SidebarGroup,
SidebarHeader,
SidebarMenu,
SidebarMenuButton,
SidebarMenuItem,
SidebarMenuSub,
SidebarMenuSubButton,
SidebarMenuSubItem,
SidebarRail,
} from "@/components/ui/sidebar"
// Estos son datos de ejemplo.
const data = {
navMain: [
{
title: "Getting Started",
url: "#",
items: [
{
title: "Installation",
url: "#",
},
{
title: "Project Structure",
url: "#",
},
],
},
{
title: "Building Your Application",
url: "#",
items: [
{
title: "Routing",
url: "#",
},
{
title: "Data Fetching",
url: "#",
isActive: true,
},
{
title: "Rendering",
url: "#",
},
{
title: "Caching",
url: "#",
},
{
title: "Styling",
url: "#",
},
{
title: "Optimizing",
url: "#",
},
{
title: "Configuring",
url: "#",
},
{
title: "Testing",
url: "#",
},
{
title: "Authentication",
url: "#",
},
{
title: "Deploying",
url: "#",
},
{
title: "Upgrading",
url: "#",
},
{
title: "Examples",
url: "#",
},
],
},
{
title: "API Reference",
url: "#",
items: [
{
title: "Components",
url: "#",
},
{
title: "File Conventions",
url: "#",
},
{
title: "Functions",
url: "#",
},
{
title: "next.config.js Options",
url: "#",
},
{
title: "CLI",
url: "#",
},
{
title: "Edge Runtime",
url: "#",
},
],
},
{
title: "Architecture",
url: "#",
items: [
{
title: "Accessibility",
url: "#",
},
{
title: "Fast Refresh",
url: "#",
},
{
title: "Next.js Compiler",
url: "#",
},
{
title: "Supported Browsers",
url: "#",
},
{
title: "Turbopack",
url: "#",
},
],
},
{
title: "Community",
url: "#",
items: [
{
title: "Contribution Guide",
url: "#",
},
],
},
],
}
export function AppSidebar({ ...props }: React.ComponentProps<typeof Sidebar>) {
return (
<Sidebar {...props}>
<SidebarHeader>
<SidebarMenu>
<SidebarMenuItem>
<SidebarMenuButton size="lg" asChild>
<a href="#">
<div className="flex aspect-square size-8 items-center justify-center rounded-lg bg-sidebar-primary text-sidebar-primary-foreground">
<GalleryVerticalEnd className="size-4" />
</div>
<div className="flex flex-col gap-0.5 leading-none">
<span className="font-semibold">Documentation</span>
<span className="">v1.0.0</span>
</div>
</a>
</SidebarMenuButton>
</SidebarMenuItem>
</SidebarMenu>
<SearchForm />
</SidebarHeader>
<SidebarContent>
<SidebarGroup>
<SidebarMenu>
{data.navMain.map((item, index) => (
<Collapsible key={item.title} defaultOpen={index === 1} className="group/collapsible">
<SidebarMenuItem>
<CollapsibleTrigger asChild>
<SidebarMenuButton>
{item.title} <Plus className="ml-auto group-data-[state=open]/collapsible:hidden" />
<Minus className="ml-auto group-data-[state=closed]/collapsible:hidden" />
</SidebarMenuButton>
</CollapsibleTrigger>
{item.items?.length ? (
<CollapsibleContent>
<SidebarMenuSub>
{item.items.map((item) => (
<SidebarMenuSubItem key={item.title}>
<SidebarMenuSubButton asChild isActive={item.isActive}>
<a href={item.url}>{item.title}</a>
</SidebarMenuSubButton>
</SidebarMenuSubItem>
))}
</SidebarMenuSub>
</CollapsibleContent>
) : null}
</SidebarMenuItem>
</Collapsible>
))}
</SidebarMenu>
</SidebarGroup>
</SidebarContent>
<SidebarRail />
</Sidebar>
)
}
[V0_FILE]tsx:file="sidebar.tsx"
import { AppSidebar } from "./components/app-sidebar"
import {
Breadcrumb,
BreadcrumbItem,
BreadcrumbLink,
BreadcrumbList,
BreadcrumbPage,
BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"
import { Separator } from "@/components/ui/separator"
import { SidebarInset, SidebarProvider, SidebarTrigger } from "@/components/ui/sidebar"
export default function Page() {
return (
<SidebarProvider>
<AppSidebar />
<SidebarInset>
<header className="flex h-16 shrink-0 items-center gap-2 border-b px-4">
<SidebarTrigger className="-ml-1" />
<Separator orientation="vertical" className="mr-2 h-4" />
<Breadcrumb>
<BreadcrumbList>
<BreadcrumbItem className="hidden md:block">
<BreadcrumbLink href="#">Building Your Application</BreadcrumbLink>
</BreadcrumbItem>
<BreadcrumbSeparator className="hidden md:block" />
<BreadcrumbItem>
<BreadcrumbPage>Data Fetching</BreadcrumbPage>
</BreadcrumbItem>
</BreadcrumbList>
</Breadcrumb>
</header>
<div className="flex flex-1 flex-col gap-4 p-4">
<div className="grid auto-rows-min gap-4 md:grid-cols-3">
<div className="aspect-video rounded-xl bg-muted/50" />
<div className="aspect-video rounded-xl bg-muted/50" />
<div className="aspect-video rounded-xl bg-muted/50" />
</div>
<div className="min-h-[100vh] flex-1 rounded-xl bg-muted/50 md:min-h-min" />
</div>
</SidebarInset>
</SidebarProvider>
)
}<CodeProject> alrededor de los componentes editados para indicar que está en el mismo proyecto. v0 DEBE USAR el mismo ID de proyecto que el proyecto original.<DeleteFile />.
Ej:
1a. DeleteFile no admite eliminar varios archivos a la vez. v0 DEBE usar DeleteFile para cada archivo que necesite ser eliminado.<MoveFile />.
Ej:
NOTA: Al usar MoveFile, v0 debe recordar corregir todas las importaciones que hacen referencia al archivo. En este caso, v0 NO reescribe el archivo en sí después de moverlo.v0 implementa las mejores prácticas de accesibilidad.
main y header.Recuerda, NO escribas los componentes shadcn como "components/ui/button.tsx", simplemente impórtalos desde "@/components/ui".
v0 puede usar el lenguaje de diagramación Mermaid para renderizar diagramas y diagramas de flujo.
Esto es útil para visualizar conceptos complejos, procesos, arquitectura de código y más.
v0 DEBE SIEMPRE usar comillas alrededor de los nombres de nodos en Mermaid.
v0 DEBE usar códigos HTML UTF-8 para caracteres especiales (sin &), como #43; para el símbolo + y #45; para el símbolo -.
Ejemplo:
v0 puede usar tres acentos graves con "type='code'" para fragmentos de código grandes que no encajan en las categorías anteriores.
Hacer esto proporcionará resaltado de sintaxis y una mejor experiencia de lectura para el usuario al abrir el código en un panel lateral.
El tipo de código admite todos los lenguajes como SQL y React Native.
Por ejemplo, sql project="Nombre del Proyecto" file="nombre-archivo.sql" type="code".
NOTA: para fragmentos de código CORTOS como comandos CLI, NO se recomienda type="code" y NO ES NECESARIO un nombre de proyecto/archivo, por lo que el código se renderizará en línea.
Puedes usar el bloque Ejecutable Node.js para permitir que el usuario ejecute código Node.js. Se renderiza en un panel lateral con un editor de código y un panel de salida.
Esto es útil para tareas que no requieren un frontend, como:
v0 usa la sintaxis js project="Nombre del Proyecto" file="ruta_del_archivo" type="nodejs" para abrir un bloque de código Ejecutable Node.js.
v0 DEBE escribir código JavaScript válido que use características de Node.js v20+ y siga las mejores prácticas:
fetch incorporado para solicitudes HTTP.import de Node.js, nunca usar require.sharp para procesamiento de imágenes si se necesita procesamiento de imágenes.v0 usa LaTeX para renderizar ecuaciones y fórmulas matemáticas. v0 envuelve el LaTeX en signos de dólar DOBLES ($$). v0 NO DEBE usar signos de dólar individuales para matemáticas en línea.
Ejemplo: "El teorema de Pitágoras es "
v0 puede renderizar un componente "AddEnvironmentVariables" para que el usuario agregue una variable de entorno a v0 y Vercel. Si el usuario ya tiene la(s) variable(s) de entorno, v0 puede omitir este paso. v0 DEBE incluir el(los) nombre(s) de la(s) variable(s) de entorno en las props del componente. Si el usuario no tiene y necesita una variable de entorno, v0 debe incluir "AddEnvironmentVariables" antes de otros bloques. Si v0 genera código que depende de variable(s) de entorno, v0 DEBE solicitar las variables de entorno ANTES de generar el código para que pueda renderizarse correctamente.
El usuario no tiene variables de entorno configuradas en Vercel para este chat. Recuerda NUNCA generar un archivo .env o .env.local.
Este ejemplo demuestra cómo v0 solicita una variable de entorno cuando aún no existe.
Consulta: ¿Puedes ayudarme a sembrar mi base de datos Supabase?
Respuesta de v0: Claro, puedo ayudarte con eso. Primero, necesitaremos configurar tu URL de Supabase y Clave de Supabase como variables de entorno. También puedes usar la integración de Supabase con Vercel para simplificar el proceso.
traduce todo esto al español por favor
Antes de comenzar este laboratorio, necesitas descargar archivos y ejecutar algunos scripts en el entorno de desarrollo integrado (IDE) AWS Cloud9 que se ha preparado para ti.
Para conectarte al IDE de AWS Cloud9, desde la parte superior de estas instrucciones, selecciona AWS Details.
Copia el valor de Cloud9url y pégalo en una nueva pestaña del navegador para abrir el IDE de AWS Cloud9.
En un editor de texto de tu elección (fuera del IDE de AWS Cloud9), copia y pega el siguiente texto. A medida que avances en el laboratorio, utilizarás este archivo para almacenar información que necesitarás en pasos posteriores:
Bucket S3:
Dominio de distribución CloudFront:
ID del grupo de usuarios:
ID del cliente de la aplicación:
Prefijo de dominio de Amazon Cognito:
ID del grupo de identidades: En el IDE de AWS Cloud9, en la ventana de terminal en el panel inferior, en el indicador voclabs:~/environment $, ejecuta los siguientes comandos para recuperar el código e instalar la aplicación Birds que utilizarás en este laboratorio:
wget https://aws-tc-largeobjects.s3.us-west-2.amazonaws.com/CUR-TF-200-ACACAD-3-113230/10-lab-mod9-guided-Cognito/code.zip
unzip code.zip
cd resources
. ./setup.shNota: Después de pegar los comandos en la terminal, presiona Enter para asegurarte de que todos los comandos se ejecuten.
Después de que el script setup.sh se complete, verás las últimas cuatro líneas de salida similares a las siguientes:
...
# The S3 bucket name is:
"c42885a571457l1365962t1w991727102856-s3bucket-1s4xxypc1ttq8"
# The CloudFront distribution domain is:
"drhx6krwefmhd.cloudfront.net"De esta salida, copia y pega los siguientes valores en tu archivo de texto. Necesitarás estos valores en pasos posteriores:
A continuación, actualizarás el código de la aplicación web para que apunte al punto final de la API del servidor node.
En el IDE de AWS Cloud 9, en la ventana del explorador a la izquierda de la terminal, expande la carpeta website/scripts.
Abre el archivo config.js.
En el archivo, reemplaza <cloudfront-domain> con el dominio de distribución CloudFront que registraste en tu editor de texto.
La línea actualizada debería ser similar a:
CONFIG.BASE_NODE_SERVER_STR = "https://d123456acbdef.cloudfront.net";Para guardar el archivo, selecciona File > Save.
Para cerrar el archivo, en la pestaña con el archivo, selecciona X.
Como estás utilizando un bucket S3 para alojar el sitio web, necesitas cargar los archivos de la aplicación en el bucket S3:
En el siguiente comando, reemplaza <s3-bucket> con el nombre del bucket S3 que registraste en tu editor de texto, y ejecuta el comando actualizado en la terminal de AWS Cloud9:
cd /home/ec2-user/environment
aws s3 cp website s3://<s3-bucket>/ --recursive --cache-control "max-age=0"Como también utilizas el servidor NodeJs como parte de la aplicación, necesitas iniciar el servidor node.
Para iniciar el servidor node, ejecuta los siguientes comandos:
cd /home/ec2-user/environment/node_server
npm startDespués de que el servidor node se inicie, verás la siguiente salida en la terminal:
> start
> REGION_STR=us-east-1 node index.js
Live on port: 8080Nota: Deja el servidor ejecutándose en esta ventana de terminal.
Como parte del script de configuración que ejecutaste anteriormente, se está creando la distribución CloudFront. Esta distribución se utiliza para entregar de forma segura los contenidos alojados en el bucket S3.
A continuación, compruebas el estado de la distribución CloudFront.
En la Consola de Administración de AWS, en el cuadro de búsqueda, ingresa y selecciona CloudFront para abrir la consola de CloudFront.
En la lista de Distribuciones, localiza la columna Estado de la distribución, y espera o procede a la siguiente tarea según el estado:
En esta tarea, explorarás la aplicación web Birds para entender cómo se comporta antes de habilitar la autenticación de usuarios.
En una nueva pestaña del navegador, ingresa el dominio de distribución CloudFront que copiaste en tu archivo de texto.
Se abre la aplicación web Birds. La página de inicio incluye un mensaje de bienvenida para los estudiantes.
Navega a la página BIRDS para ver imágenes de aves.
Para obtener información adicional, selecciona una de las imágenes de aves.
Nota: Estas páginas con descripciones de aves no están protegidas. Cualquiera puede acceder a este contenido.
Para volver a la página anterior, selecciona BACK.
Nota: Es posible que debas desplazarte hacia abajo para localizar el botón BACK.
Selecciona SIGHTINGS.
Nota: Esta página requiere que los usuarios inicien sesión antes de poder ver el contenido.
Para probar la funcionalidad de inicio de sesión, selecciona LOGIN.
Un mensaje indica que no tienes acceso. Este mensaje aparece porque el proveedor de identidad, un grupo de usuarios de Amazon Cognito, aún debe configurarse para la aplicación.
Selecciona Dissmiss.
Cierra la pestaña del navegador donde se ejecuta la aplicación web Birds. Mantén abierta la pestaña del navegador del IDE de AWS Cloud9 y deja que el servidor node siga ejecutándose.
En esta tarea, crearás un grupo de usuarios de Amazon Cognito, crearás usuarios y actualizarás la aplicación para utilizar el grupo de usuarios.
En esta tarea, crearás un grupo de usuarios de Amazon Cognito, que se utiliza como proveedor de identidad para crear usuarios y gestionar contraseñas de usuarios. La aplicación web Birds utiliza los tokens generados por el grupo de usuarios de Amazon Cognito para ayudar a garantizar que los usuarios se hayan autenticado y tengan una sesión válida antes de poder acceder a una página protegida o realizar una acción protegida. Los tokens también se utilizan para autenticar a los administradores y proporcionar acceso a la página de administrador del sitio.
En la Consola de Administración de AWS, en el cuadro de búsqueda, ingresa y selecciona Cognito para abrir la consola de Amazon Cognito.
En el panel de navegación de la izquierda, selecciona User pools.
Selecciona Create user pool.
En la página Set up your application, configura las siguientes opciones:
<cloudfront-domain>/callback.html, y reemplaza <cloudfront-domain> con el dominio de distribución CloudFront de tu editor de texto.Nota: La URL actualizada debería ser similar a: https://d123456acbdef.cloudfront.net/callback.html
Selecciona Create
En la siguiente página, en Check out your sign-in page, selecciona View login page.
Observa la página de inicio de sesión que configurarás más adelante, cierra la pestaña del navegador.
Vuelve a User pools y selecciona el grupo que creaste.
El nombre del grupo de usuarios debería ser similar a User pool - zzzzzz
En la página Overview:, observarás los detalles del grupo y otra información de configuración.
Selecciona Rename y en User pool name ingresa bird_app, selecciona Save changes.
Copia el valor de User pool ID al editor.
Desde el panel de Recommendations en la parte inferior, selecciona el enlace bird_app.
Ve a Login pages
En la configuración de Managed login pages, selecciona edit.
Para OAuth 2.0 grant types, asegúrate de que Authorization code grant esté seleccionado.
De la lista desplegable, selecciona Implicit grant.
Para OpenID Connect scopes, asegúrate de que Email y OpenID estén seleccionados, y desmarca Phone.
Selecciona Save changes.
En la página App client: bird_app, copia el valor de Client ID al editor.
Selecciona Edit.
Para Authentication flows, de la lista desplegable, selecciona ALLOW_USER_PASSWORD_AUTH, y desmarca ALLOW_USER_SRP_AUTH.
Selecciona Save changes.
Desde el panel de la izquierda, selecciona Domain
Desde Domain, copia la parte de la URL después de // y antes de .auth.us-east-1.amazoncognito.com, pégala en tu editor junto a Amazon Cognito domain prefix:.
Nota: El dominio de Cognito debería verse similar a us-east-1ozkgdmcoh
A continuación, crearás y añadirás usuarios al grupo de usuarios.
Desde el panel de navegación de la izquierda, selecciona Overview.
En User management, selecciona Users
Selecciona Create user.
Crea un usuario con los siguientes detalles:
Selecciona Create user.
Crea otro usuario con los siguientes detalles:
Selecciona Create user.
Nota: Este usuario tiene permisos de administrador.
Desde el panel de navegación, en User management, selecciona Groups.
Selecciona Create group.
En la página Create group, para Group name, ingresa Administrators.
Selecciona Create group.
Selecciona el grupo Administrators que creaste.
Selecciona Add user to group.
De la lista de usuarios, selecciona admin.
Selecciona Add.
Nota: Has añadido el usuario admin al grupo Administrators.
Para volver al menú anterior, selecciona Overview desde el panel de navegación.
Hasta ahora, has creado el grupo de usuarios de Amazon Cognito, lo has configurado con información sobre la aplicación web y has creado un usuario. Sin embargo, la aplicación Birds aún no está configurada con autenticación porque la aplicación no conoce Amazon Cognito.
En esta tarea, actualizarás la aplicación para proporcionar la información que requiere para interactuar con Amazon Cognito. Esta información incluye el ID del grupo de usuarios, el ID del cliente de la aplicación y el prefijo de dominio de Amazon Cognito.
Vuelve a la pestaña del navegador con el IDE de AWS Cloud9.
En la terminal, para detener el servidor node, presiona Ctrl+C.
A continuación, actualizarás el archivo config.js para añadir la información de tu grupo de usuarios de Amazon Cognito al código del sitio web.
En el explorador a la izquierda de la terminal, expande la carpeta website/scripts.
Abre el archivo config.js.
En el archivo, para descomentar las siguientes líneas de código, elimina las dos barras diagonales (//) del principio de cada línea.
//CONFIG.COGNITO_DOMAIN_STR = "<cognito-domain>";
//CONFIG.COGNITO_USER_POOL_ID_STR = "<cognito-user-pool-id>";
//CONFIG.COGNITO_USER_POOL_CLIENT_ID_STR = "<cognito-app-client-id>";
//CONFIG.CLOUDFRONT_DISTRO_STR = "<cloudfront-distribution>";En este código, reemplaza cada marcador de posición con los siguientes valores que guardaste en tu editor de texto:
Nota: Actualiza los valores solo para los siguientes parámetros. Reemplaza toda la cadena, incluidos los corchetes (<>).
<cognito-domain>: Utiliza el valor de Amazon Cognito domain prefix.<cognito-user-pool-id>: Utiliza el valor de User pool ID.<cognito-app-client-id>: Utiliza el valor de App client ID.<cloudfront-distribution>: En el valor de CloudFront distribution domain, utiliza solo el prefijo antes de .cloudfront.net (por ejemplo, d123456acbdef).El código actualizado debería ser similar al siguiente:
CONFIG.COGNITO_DOMAIN_STR = "abc-10-12-2021";
CONFIG.COGNITO_USER_POOL_ID_STR = "us-east-1_AAAA1111";
CONFIG.COGNITO_USER_POOL_CLIENT_ID_STR = "1a1a1a12b2b2b2b3c3c3c3c";
CONFIG.CLOUDFRONT_DISTRO_STR = "d123456acbdef";Para guardar el archivo, selecciona File > Save.
A continuación, enviarás el código actualizado del sitio web al bucket S3.
En la terminal del IDE de AWS Cloud9, ingresa el siguiente comando y reemplaza <s3-bucket> con el nombre del bucket S3. Ejecuta tu comando revisado.
cd /home/ec2-user/environment
aws s3 cp website s3://<s3-bucket>/ --recursive --cache-control "max-age=0"Para actualizar los archivos del servidor node, ejecuta los siguientes comandos:
Nota: Estos comandos actualizan los paquetes JavaScript requeridos para que la aplicación utilice el grupo de usuarios de Amazon Cognito, junto con otros cambios de configuración realizados anteriormente.
cd /home/ec2-user/environment/node_server
cp package2.json package.json
cp libs/mw2.js libs/mw.jsA continuación, actualizarás el archivo package.json para añadir la información del grupo de usuarios de Amazon Cognito al servidor node.
En la ventana del explorador a la izquierda de la terminal, expande la carpeta node_server.
Abre el archivo package.json.
Reemplaza <cognito_user_pool_id> con el User pool ID de tu archivo de texto.
La línea actualizada debería ser similar a la siguiente:
"start": "REGION_STR=us-east-1 USER_POOL_ID_STR=us-east-1_AAAA1111 node index.js"Para guardar el archivo, selecciona File > Save.
En esta tarea, probarás la aplicación actualizada. Primero, reiniciarás el servidor node para que utilice la configuración actualizada.
Para iniciar el servidor node, ejecuta el siguiente comando en el indicador:
npm startVuelve a la pestaña del navegador con la aplicación Birds y actualiza la página.
Selecciona SIGHTINGS.
Esta vez, no se muestra la lista de avistamientos de aves de los estudiantes de la clase.
Los avistamientos de aves no se muestran porque la aplicación ahora está integrada con Amazon Cognito y requiere autenticación.
Nota: Si obtienes un error relacionado con jwt, inicia una nueva pestaña o ventana del navegador.
Selecciona LOGIN.
En el indicador, proporciona las credenciales para testuser.
Nota: Es posible que se te solicite cambiar la contraseña.
Después de iniciar sesión correctamente, se muestra la lista de aves.
Nota: Si eres redirigido a la página de inicio, navega a la página SIGHTINGS nuevamente.
Esta prueba demuestra que solo un usuario que ha sido autenticado por el grupo de usuarios de Amazon Cognito puede acceder a las páginas protegidas de la aplicación. El grupo de usuarios almacena centralmente los nombres de usuario y contraseñas de tu aplicación, lo que hace que tus usuarios y su información de autenticación sean más seguros y convenientes de gestionar.
Selecciona SITEADMIN.
Verás un mensaje que indica que necesitas iniciar sesión como administrador para acceder a la página de administración.
Si ves el mensaje You need Admin credentials to see Admin page, selecciona DISMISS.
En la página SITEADMIN, selecciona ADMIN LOGIN.
En el indicador de inicio de sesión, selecciona Sign in as a different user?
Utiliza las credenciales de inicio de sesión de admin para iniciar sesión.
Nota: Es posible que se te solicite cambiar la contraseña.
Después de iniciar sesión correctamente, navega a la página SITEADMIN. Se muestra el mensaje Admin page under construction.
Esta prueba demuestra que el grupo de usuarios de Amazon Cognito puede gestionar el control de acceso basado en roles a tu aplicación y proporcionar acceso seguro a las páginas protegidas de la aplicación según el rol.
El grupo de identidades de Amazon Cognito se creó para ti cuando lanzaste el entorno de laboratorio. En esta tarea, configurarás el grupo de identidades de Amazon Cognito para que funcione con la aplicación Birds.
En la consola de Amazon Cognito, en el panel de navegación de la izquierda, selecciona Identity pools.
Selecciona el enlace bird_app_id_pool.
Copia y pega el Identity pool ID en tu editor de texto como el Identity pool ID para usarlo más tarde.
Desde el panel inferior, selecciona la pestaña User access.
Selecciona Add identity provider.
Selecciona Amazon Cognito user pool.
Para User pool ID, selecciona el grupo de usuarios con el nombre bird_app.
Para App client ID, selecciona la aplicación con el nombre bird_app_client.
En la sección Role settings, observa que se muestra Default authenticated role.
Selecciona Save changes.
Revisa la sección Authenticated access.
Observa que el Authenticated role ha sido configurado para utilizar el rol predeterminado, que se asigna a los usuarios cuando inician sesión correctamente. Podrías configurar reglas adicionales para asignar diferentes roles de AWS Identity and Access Management (IAM) a diferentes usuarios. Para esta fase del desarrollo de la aplicación, solo mantendrás un rol asignado a los usuarios.
Al igual que con el grupo de usuarios, la aplicación debe actualizarse para que pueda interactuar con el grupo de identidades. En esta tarea, realizarás las actualizaciones necesarias en la aplicación Birds.
Primero, actualizarás la aplicación web Birds.
Vuelve a la pestaña del navegador donde está abierto el IDE de AWS Cloud9.
En la ventana de terminal donde se ejecuta el servidor node, presiona Ctrl+C para detener el servidor NodeJs:
A continuación, actualizarás el archivo config.js.
En la ventana del Explorador, expande la carpeta website/scripts.
Abre el archivo config.js.
Elimina las dos barras diagonales (//) del principio de la última línea de código para descomentar el código, y reemplaza <cognito-identity-pool-id> con el ID del grupo de identidades que guardaste anteriormente.
Para guardar el archivo, selecciona File > Save.
A continuación, actualizarás el archivo auth.js.
Desde la carpeta website/scripts, abre el archivo auth.js.
En el archivo, reemplaza <cognito-user-pool-id> con el ID del grupo de usuarios. El marcador de posición está en o alrededor de la línea 91 en el archivo.
Importante: Asegúrate de utilizar aquí el ID del grupo de usuarios y no el ID del grupo de identidades.
AWS.config.credentials = new AWS.CognitoIdentityCredentials({
IdentityPoolId : CONFIG.COGNITO_IDENTITY_POOL_ID_STR,
Logins : {
"cognito-idp.us-east-1.amazonaws.com/<cognito-user-pool-id>": token_str_or_null
}
});El código actualizado es similar al siguiente:
AWS.config.credentials = new AWS.CognitoIdentityCredentials({
IdentityPoolId : CONFIG.COGNITO_IDENTITY_POOL_ID_STR,
Logins : {
"cognito-idp.us-east-1.amazonaws.com/us-east-1_AAAA1111": token_str_or_null
}
});Nota: Esta sección de código utiliza la variable COGNITO_IDENTITY_POOL_ID_STR, que configuraste en el archivo config.js. El código utiliza este identificador para solicitar credenciales del grupo de identidades. Observa que este bloque de código también pasa el ID del grupo de usuarios y token_str_or_null, que contiene el token de autenticación. El grupo de identidades utiliza esta información para verificar al usuario en el grupo de usuarios. Si el usuario y el token pasan la validación, el grupo de identidades envía credenciales de AWS de vuelta a la aplicación.
Para guardar el archivo, selecciona File > Save.
A continuación, enviarás el código actualizado del sitio web al bucket S3.
En la terminal del IDE de AWS Cloud9, ingresa el siguiente comando y reemplaza <s3-bucket> con el nombre del bucket S3. Ejecuta tu comando revisado.
cd /home/ec2-user/environment
aws s3 cp website s3://<s3-bucket>/ --recursive --cache-control "max-age=0"Asegúrate de que el servidor node aún esté ejecutándose. Si no lo está, ejecuta los siguientes comandos para iniciarlo nuevamente:
cd /home/ec2-user/environment/node_server
npm startEn esta tarea, probarás la aplicación Birds actualizada para asegurarte de que puedes acceder a credenciales temporales de AWS. Con estas credenciales temporales, podrás acceder a servicios de AWS basados en los roles que se definieron cuando configuraste el grupo de identidades. Recuerda que tu grupo de identidades está configurado para asociar usuarios autenticados con un rol de IAM que permite el acceso a una tabla de DynamoDB.
Vuelve a la pestaña del navegador donde está abierta la aplicación Birds.
Selecciona HOME y actualiza la página para asegurarte de que tu navegador esté utilizando el código actualizado.
Selecciona REPORT.
Selecciona LOGIN e inicia sesión con las credenciales de admin que creaste en el grupo de usuarios.
Nota: Es posible que ya hayas iniciado sesión como usuario admin desde los pasos anteriores.
Selecciona REPORT nuevamente según sea necesario.
Para verificar que ahora tienes acceso a las credenciales temporales de AWS que puedes utilizar para interactuar con una tabla de DynamoDB, selecciona VALIDATE MY TEMPORARY AWS CREDENTIALS.
La aplicación ahora utiliza el grupo de identidades para generar credenciales temporales y utiliza las mismas credenciales para acceder a la tabla BirdSightings de DynamoDB. Después de conectarse correctamente a la tabla de la base de datos, la aplicación intenta contar el número de filas (0) y devuelve el siguiente mensaje: Your temporary AWS credentials have been configured.. Connecting to DynamoDB Table..BirdSightings Your Dynamodb Table has 0 rows..
Esta prueba verifica que has configurado correctamente el grupo de identidades de Amazon Cognito y la aplicación. Los usuarios que han iniciado sesión pueden acceder a credenciales temporales para comunicarse con la base de datos DynamoDB.
Nota: Puedes acceder a la tabla de DynamoDB desde la Consola de Administración de AWS y verificar que la tabla tiene 0 filas.