+
+
+En los detalles de la advertencia de verificación de git, encontrarás el enlace para actualizar tu plan. También puedes actualizar tu plan en el [panel de control](https://dashboard.mintlify.com) para permitir que editores ilimitados actualicen tus documentos. Una vez que actualices tu plan, activa una actualización manual o haz push de otro cambio para implementar tus actualizaciones.
+
+Aprende más sobre nuestros precios [aquí](https://mintlify.com/pricing).
diff --git a/es/advanced/dashboard/roles.mdx b/es/advanced/dashboard/roles.mdx
new file mode 100644
index 00000000..f6e4ac4b
--- /dev/null
+++ b/es/advanced/dashboard/roles.mdx
@@ -0,0 +1,22 @@
+---
+- title: Roles
+- description: Controla el acceso a tu panel con roles.
+---
+
+Mintlify proporciona dos niveles de acceso al panel: Editor y Admin.
+
+Lo siguiente describe las acciones que están limitadas al rol de Admin:
+
+| | Editor | Admin |
+| ---------------------------------- | :----: | :---: |
+| Actualizar roles de usuario | ❌ | ✅ |
+| Eliminar usuarios | ❌ | ✅ |
+| Invitar usuarios admin | ❌ | ✅ |
+| Gestionar y actualizar facturación | ❌ | ✅ |
+| Actualizar dominio personalizado | ❌ | ✅ |
+| Actualizar fuente Git | ❌ | ✅ |
+| Eliminar organización | ❌ | ✅ |
+
+Otras acciones en el panel están disponibles para ambos roles.
+
+Puedes invitar a tantos administradores como quieras, pero recomendamos limitar el acceso de administrador a los usuarios que lo necesiten.
diff --git a/es/advanced/dashboard/sso.mdx b/es/advanced/dashboard/sso.mdx
new file mode 100644
index 00000000..8583adee
--- /dev/null
+++ b/es/advanced/dashboard/sso.mdx
@@ -0,0 +1,105 @@
+---
+- title: Inicio de Sesión Único (SSO)
+- description: Personalice cómo su equipo puede iniciar sesión en su panel de administración
+---
+
+
+
+
+
+
+
+Si tienes problemas para configurar un subdirectorio personalizado,[contacta a nuestro equipo de soporte](mailto:sales@mintlify.com) y te guiaremos a través del proceso de actualización de tu alojamiento con nosotros.
+
+### Editar Script del Worker
+
+Haz clic en`Edit Code` y agrega el siguiente script en el código del worker.
+
+
+ 
+
+
+
+
+ 
+
+
+### Habilitando el menú contextual
+
+Agregue el `contextual` campo a su `docs.json` y especifique qué opciones desea incluir en su menú.
+
+```json
+{
+ "contextual": {
+ "options": [
+ "copy",
+ "view",
+ "chatgpt",
+ "claude"
+ ]
+ }
+}
+```
+
+## /llms.txt
+
+El [/llms.txt file](https://llmstxt.org) es un estándar de la industria que ayuda a los LLMs de propósito general a indexar de manera más eficiente, similar a cómo un mapa del sitio ayuda a los motores de búsqueda.
+
+Cada sitio de documentación aloja automáticamente un archivo `/llms.txt` en la raíz que enumera todas las páginas disponibles en su documentación. Las herramientas de IA pueden usar este archivo para comprender la estructura de su documentación y encontrar contenido relevante para las solicitudes de los usuarios.
+
+
+
+
+## Clave de API de administrador
+
+La clave de API de administrador se usa para la mayoría de la API. Se utiliza para activar actualizaciones a través del [endpoint de Actualización](/es/api-reference/update/trigger).
+
+## Clave de API del Asistente
+
+La API del Asistente te permite incorporar la experiencia del asistente de IA basada en tus documentos y continuamente actualizada en cualquier aplicación de tu elección.
+
+Las respuestas incluyen citas para que puedas dirigir a tus usuarios a los lugares correctos donde necesitan obtener ayuda.
+
+
+
+
+## Leyendas
+
+Puedes agregar contexto adicional a una imagen usando la prop opcional `caption`.
+
+
+ 
+
+
+## Props
+
+
+
+ ```
+
+ ```jsx Frame with Captions
+
+
+
+ ```
+
+
+
+ ## Registro de cambios
+
+ Puede agregar cualquier cosa aquí, como una captura de pantalla, un fragmento de código o una lista de cambios.
+
+ #### Características
+
+ * Diseño responsivo
+ * Sección fija para cada registro de cambios
+
+
+
+
+## Introduction
+
+El editor web es una interfaz visual para crear, editar y revisar documentación directamente en tu navegador.
+
+El editor web ofrece una experiencia **What-You-See-Is-What-You-Get (WYSIWYG)** mientras mantiene la sincronización con tu repositorio Git, lo que te permite ver actualizaciones en tiempo real y colaborar con tu equipo en los cambios de la documentación.
+
+### Editor web vs. CLI
+
+El editor web te permite escribir y editar tu documentación en tu navegador sin necesidad de herramientas de desarrollo locales o usar la línea de comandos. Deberías usar el editor web si quieres mantener tu documentación en un solo lugar con una sola herramienta.
+
+La CLI es una herramienta de línea de comandos que te permite crear y gestionar tu documentación localmente usando el IDE de tu elección. Deberías usar la CLI si quieres integrar la documentación en tu flujo de trabajo de desarrollo existente.
+
+Tanto el editor web como la CLI están completamente integrados con tu repositorio Git, por lo que puedes usarlos indistintamente y diferentes miembros de tu equipo pueden usar cualquiera de las herramientas según sus preferencias.
+
+## Modos del Editor
+
+El editor web ofrece dos modos para adaptarse a diferentes preferencias y necesidades de edición.
+
+Puedes cambiar entre los modos naturales en cualquier momento usando el interruptor en la esquina superior derecha de la barra de herramientas del editor.
+
+
+ 
+
+ 
+
+
+### Modo Visual
+
+El modo visual proporciona una experiencia WYSIWYG donde los cambios que haces en el editor son los cambios que se publicarán en tu sitio de documentación. Este modo es ideal cuando quieres ver cómo se verán tus cambios en tiempo real.
+
+
+ 
+
+ 
+
+
+#### Menú de Componentes
+
+Puedes agregar bloques de contenido y otros componentes a tu documentación en el modo visual usando el menú desplegable de componentes.
+
+1. Presiona la tecla `/` para abrir el menú de componentes.
+2. Selecciona un componente del menú.
+
+
+ 
+
+ 
+
+
+### Modo Markdown
+
+El modo Markdown proporciona acceso directo al código MDX subyacente de tu documentación. Este modo es preferible cuando necesitas un control preciso sobre las propiedades de los componentes o cuando prefieres escribir en sintaxis Markdown/MDX.
+
+
+ 
+
+ 
+
+
+## Realizando Cambios
+
+1. **Navegar por archivos**: Usa el explorador de archivos de la barra lateral para navegar por tu documentación.
+2. **Abrir un archivo**: Haz clic en el archivo que quieres editar para abrirlo en el editor.
+3. **Realizar cambios**: Edita el contenido usando el modo visual o Markdown. Los cambios se guardan automáticamente como borradores.
+4. **Vista previa de cambios**: Ve cómo se verán tus cambios en el modo visual.
+
+## Publicación
+
+
+
+ 
+
+
+## Branches
+
+Las ramas te permiten trabajar en cambios de documentación sin actualizar la versión principal hasta que estés listo para que tus cambios se publiquen.
+
+
+
+ 
+
+
+### Revisando Pull Requests
+
+Puedes revisar pull requests en tu plataforma Git (GitHub, GitLab).
+
+Después de crear una pull request, puedes ver una implementación de vista previa de los cambios.
+
+Después de que un revisor apruebe una pull request, puedes fusionar la pull request en tu rama principal y los cambios se implementarán en tu sitio de documentación en vivo.
+
+## Sincronización Git
+
+El editor web se integra con tu repositorio Git, asegurando que todos los cambios estén correctamente versionados y rastreados.
+
+### Cómo funciona la sincronización Git
+
+* **Autenticación**: El editor web se conecta a tu repositorio Git a través de nuestra [GitHub App](/es/settings/github) o [GitLab integration](/es/settings/gitlab).
+
+* **Obtención automática**: Cuando abres el editor, automáticamente obtiene el contenido más reciente de la rama principal de tu repositorio.
+
+* **Seguimiento de cambios**: A medida que realizas ediciones, el editor web rastrea los cambios y puede confirmarlos en tu repositorio.
+
+* **Ramificación**: Puedes hacer cambios directamente en tu rama principal o en una rama separada, dependiendo de tus preferencias de flujo de trabajo.
+
+* **Pull requests**: Para flujos de trabajo colaborativos, puedes crear pull requests desde el editor web.
+
+## Terminología Git
+
+Entender los siguientes términos puede ayudarte a trabajar más eficazmente con el editor web y el flujo de trabajo Git.
+
+
+
+ 
+
+ 
+
+## Imagen
+
+Las imágenes son la forma más común de agregar contenido visual a tu documentación.
+
+### Conceptos básicos
+
+La[markdown syntax](https://www.markdownguide.org/basic-syntax/#images)te permite agregar imágenes usando el siguiente código
+
+```md
+
+```
+
+
+```
+
+### Deshabilitar el zoom de imagen
+
+Para deshabilitar el zoom predeterminado al hacer clic en las imágenes, agrega la propiedad noZoom a las incrustaciones de imágenes.
+
+```html
+
+```
+
+### Enlazar imágenes
+
+Para enlazar una imagen, por ejemplo, para crear un botón en tus documentos, envuelve la imagen en un enlace con la`noZoom`propiedad. Las imágenes en`a`etiquetas tendrán automáticamente un cursor de puntero.
+
+```html
+
+
+
+```
+
+### Modo oscuro
+
+Para usar imágenes separadas para el modo claro y oscuro, utiliza Tailwind CSS para ocultar y mostrar imágenes.
+
+```html
+
+
+```
+
+### Relacionado
+
+Para más información, recomendamos las siguientes secciones:
+
++ +
+ 
+ {title}
+ + {description} + + + ) +} + +
+
diff --git a/es/installation.mdx b/es/installation.mdx
new file mode 100644
index 00000000..2f64e1bf
--- /dev/null
+++ b/es/installation.mdx
@@ -0,0 +1,141 @@
+---
+- title: Instalación
+- description: Instala el CLI para previsualizar y desarrollar tu documentación localmente
+- icon: terminal
+---
+
+
+ 
+
+ 
+
+
+
+
+
+
+
++ Documentation +
+ ++ Conoce la próxima generación de documentación. Nativa de IA, hermosa de forma predeterminada y construida para desarrolladores. +
+ +
+
+ 
+
+
+
++ +
+ 
+
+
+### Seleccionar clientes MCP
+
+Después de la autenticación, elegirás qué clientes MCP habilitar para tu servidor:
+
+
+ 
+
+
+Una vez configurado, tu servidor MCP está listo para usar con el comando proporcionado en la terminal.
+
+## Configurando tu servidor MCP
+
+Ahora veamos cómo configurar tu servidor MCP.
+
+### Funcionalidad predeterminada
+
+Todos los servidores MCP incluyen la herramienta`search`por defecto, permitiendo a los usuarios consultar información en toda tu documentación.
+
+### Agregando funciones de API
+
+Si tienes una especificación OpenAPI, puedes exponer endpoints específicos como herramientas MCP usando la extensión`x-mcp`a nivel de archivo o endpoint.
+
+#### Configuración a nivel de archivo
+
+Habilita MCP para todos los endpoints en un archivo de especificación:
+
+```json
+{
+ "openapi": "3.1.0",
+ "x-mcp": {
+ "enabled": true
+ },
+ // Other OpenAPI content
+}
+```
+
+#### Configuración a nivel de endpoint
+
+Habilita MCP solo para endpoints específicos:
+
+```json
+{
+ "paths": {
+ "/api/v1/users": {
+ "x-mcp": {
+ "enabled": true
+ },
+ // Endpoint configuration
+ }
+ }
+}
+```
+
+### Manejo de autenticación
+
+Si tu especificación OpenAPI define autenticación usando securitySchemes, estos métodos de autenticación se aplicarán automáticamente a tu servidor MCP.
+
+### Monitoreando tu servidor MCP
+
+Después de publicar tus cambios, puedes ver todas las herramientas MCP disponibles en la sección**Available Tools**en la página del servidor MCP en tu panel de control.
+
+
+ 
+
+ 
+
+
+## Distribución
+
+### Instalación del usuario
+
+Tus usuarios pueden instalar y usar tu servidor MCP con:
+
+```bash
+npx mint-mcp add 
+
+
+
+Pages es un array donde cada entrada debe ser una referencia a la ruta de un [page file](pages).
+
+```json
+{
+ "navigation": {
+ "pages": [
+ "overview",
+ "quickstart",
+ "advanced/components",
+ "advanced/integrations"
+ ]
+ }
+}
+```
+
+***
+
+## Groups
+
+Los grupos te permiten agrupar tus páginas. Los grupos también pueden anidarse entre sí.
+
+
+
+
+
+```json
+{
+ "navigation": {
+ "groups": [
+ {
+ "group": "Getting Started",
+ "pages": [
+ "quickstart",
+ {
+ "group": "Editing",
+ "pages": [
+ "installation",
+ "editor",
+ {
+ "group": "Nested group",
+ "pages": [
+ "navigation",
+ "code"
+ ]
+ }
+ ]
+ }
+ ]
+ },
+ {
+ "group": "Writing Content",
+ "pages": ["writing-content/page", "writing-content/text"]
+ }
+ ]
+ }
+}
+```
+
+## Tabs
+
+Las pestañas ayudan a distinguir entre diferentes temas o secciones de tu documentación.
+
+
+
+
+
+```json
+"navigation": {
+ "tabs": [
+ {
+ "tab": "API References",
+ "pages": [
+ "api-reference/get",
+ "api-reference/post",
+ "api-reference/delete"
+ ]
+ },
+ {
+ "tab": "SDKs",
+ "pages": [
+ "sdk/fetch",
+ "sdk/create",
+ "sdk/delete",
+ ]
+ },
+ {
+ "tab": "Blog",
+ "href": "https://external-link.com/blog"
+ }
+ ]
+}
+```
+
+***
+
+## Anchors
+
+Los anclajes son otra forma de seccionar tu contenido. Aparecen en la parte superior de tu navegación lateral.
+
+
+
+
+
+La configuración es muy similar a las pestañas.
+
+Aunque no es obligatorio, recomendamos encarecidamente que también establezcas un `icon` campo icon.
+
+```json
+"navigation": {
+ "anchors": [
+ {
+ "anchor": "Documentation",
+ "icon": "book-open",
+ "pages": [
+ "quickstart",
+ "development",
+ "navigation"
+ ]
+ },
+ {
+ "anchor": "API References",
+ "icon": "sqaure-terminal",
+ "pages": [
+ "api-reference/get",
+ "api-reference/post",
+ "api-reference/delete"
+ ]
+ },
+ {
+ "anchor": "Blog",
+ "href": "https://external-link.com/blog"
+ }
+ ]
+}
+```
+
+***
+
+Los anclajes que contienen estrictamente enlaces externos se pueden lograr usando el `global` keyword:
+
+```json
+"navigation": {
+ "global": {
+ "anchors": [
+ {
+ "anchor": "Community",
+ "icon": "house",
+ "href": "https://slack.com"
+ },
+ {
+ "anchor": "Blog",
+ "icon": "pencil",
+ "href": "https://mintlify.com/blog"
+ }
+ ]
+ },
+ "tabs": [...]
+}
+```
+
+## Dropdowns
+
+Los menús desplegables aparecen en el mismo lugar que los anclajes, pero se consolidan en un solo desplegable.
+
+
+
+
+
+Aunque no es obligatorio, también recomendamos que establezcas un icono para cada elemento del menú desplegable.
+
+```json
+"navigation": {
+ "dropdowns": [
+ {
+ "dropdown": "Documentation",
+ "icon": "book-open",
+ "pages": [
+ "quickstart",
+ "development",
+ "navigation"
+ ]
+ }
+ {
+ "dropdown": "API References",
+ "icon": "sqaure-terminal",
+ "pages": [
+ "api-reference/get",
+ "api-reference/post",
+ "api-reference/delete"
+ ]
+ }
+ {
+ "dropdown": "Blog",
+ "href": "https://external-link.com/blog"
+ }
+ ]
+}
+```
+
+***
+
+## Versions
+
+Las versiones se pueden aprovechar para dividir tu navegación en diferentes versiones.
+
+
+
+
+
+```json
+{
+ "navigation": {
+ "versions": [
+ {
+ "version": "1.0.0",
+ "groups": [
+ {
+ "group": "Getting Started",
+ "pages": ["v1/overview", "v1/quickstart", "v1/development"]
+ }
+ ]
+ },
+ {
+ "version": "2.0.0",
+ "groups": [
+ {
+ "group": "Getting Started",
+ "pages": ["v2/overview", "v2/quickstart", "v2/development"]
+ }
+ ]
+ }
+ ]
+ }
+}
+```
+
+***
+
+## Languages
+
+Los idiomas se pueden aprovechar para dividir tu navegación en diferentes idiomas.
+
+
+
+
+
+Actualmente admitimos los siguientes idiomas:
+
+
+
+ 
+
+
+Esta URL está disponible instantáneamente y se actualizará cada vez que realice cambios en su documentación. Es perfecta para pruebas y para compartir con su equipo durante el desarrollo.
+
+### Instale la aplicación de GitHub
+
+Mintlify proporciona una aplicación de GitHub que automatiza el proceso de implementación cuando envía cambios a su repositorio.
+
+Puede instalar la aplicación de GitHub siguiendo las instrucciones de la lista de verificación de incorporación o desde su panel de control.
+
+1. Navegue a **Configuración** en su panel de control de Mintlify.
+2. Seleccione **Aplicación de GitHub** en la barra lateral.
+3. Seleccione **Instalar aplicación de GitHub**. Esto abrirá una nueva pestaña en la página de instalación de la aplicación de GitHub.
+4. Seleccione la organización o cuenta de usuario donde desea instalar la aplicación. Luego seleccione los repositorios que desea conectar.
+
+
+ 
+
+ 
+
+
+
+
+ 
+
+
+### Subir los cambios
+
+Cuando estés listo para publicar tus cambios, simplemente súbelos a tu repositorio.
+
+Mintlify detectará automáticamente los cambios, construirá tu documentación y desplegará las actualizaciones en tu sitio. Puedes monitorear el estado del despliegue en el historial de commits de tu repositorio de GitHub o en el[dashboard](https://dashboard.mintlify.com).
+
+Una vez que el despliegue esté completo, tu última actualización estará disponible en`
+
+ 
+
+
+### Editar la documentación
+
+En el editor web, puedes navegar por tus archivos de documentación en la barra lateral. Vamos a actualizar la página de introducción.
+
+Encuentra y haz clic en`introduction.mdx`en el explorador de archivos.
+
+Luego, en el editor visual, actualiza el campo de título a "Hello World".
+
+
+ 
+
+ 
+
+
+
+
+ 
+
+
+Ingresa tu dominio (por ejemplo, docs.tuempresa.com) y sigue las instrucciones proporcionadas para configurar los ajustes DNS con tu proveedor de dominio.
+
+
+
+ );
+}
+```
+
+El componente`Counter`puede entonces ser utilizado en tus archivos MDX de esta manera:
+
+```jsx
+Current count: {count}
+ +
+
+
+ Los componentes de hook de React se renderizan del lado del cliente, lo que tiene varias implicaciones:
+
+ * **SEO**: Los motores de búsqueda podrían no indexar completamente el contenido dinámico
+ * **Carga Inicial**: Los visitantes pueden experimentar un destello de contenido en carga antes de que los componentes se rendericen
+ * **Accesibilidad**: Asegúrate de que los cambios de contenido dinámico sean anunciados a los lectores de pantalla
+
+
+
+ * **Optimiza los Arrays de Dependencias**: Incluye solo las dependencias necesarias en tus arrays de dependencias de`useEffect`useEffect
+ * **Memoriza Cálculos Complejos**: Usa`useMemo`useMemo`useCallback`useCallback para operaciones costosas
+ * **Reducir Re-renderizados**: Divide los componentes grandes en otros más pequeños para evitar re-renderizados en cascada
+ * **Carga Perezosa**: Considera la carga perezosa de componentes complejos para mejorar el tiempo de carga inicial de la página
+
+
diff --git a/es/reusable-snippets.mdx b/es/reusable-snippets.mdx
new file mode 100644
index 00000000..0675c7c8
--- /dev/null
+++ b/es/reusable-snippets.mdx
@@ -0,0 +1,89 @@
+---
+- title: Fragmentos Reutilizables
+- description: Fragmentos personalizados reutilizables para mantener el contenido
+ sincronizado
+- icon: recycle
+---
+
+Uno de los principios fundamentales del desarrollo de software es DRY (Don't Repeat Yourself, No Te Repitas), que también se aplica a la documentación. Si te encuentras repitiendo el mismo contenido en múltiples lugares, deberías crear un fragmento personalizado para mantener tu contenido sincronizado.
+
+## Creando un fragmento personalizado
+
+**Precondición**: Debes crear tu archivo de fragmento en el directorio`snippets` para que la importación funcione.
+
+Cualquier página en el directorio`snippets` será tratada como un fragmento y no se renderizará como una página independiente. Si deseas crear una página independiente a partir del fragmento, importa el fragmento en otro archivo y llámalo como un componente.
+
+### Exportación por defecto
+
+1. Agrega contenido a tu archivo de fragmento que deseas reutilizar. Opcionalmente, puedes agregar variables que se pueden llenar a través de props cuando importes el fragmento. En este ejemplo, nuestra variable es word.
+
+```typescript snippets/my-snippet.mdx
+Hello world! This is my content I want to reuse across pages.
+```
+
+2. Importa el fragmento en tu archivo de destino.
+
+```typescript destination-file.mdx
+---
+title: My title
+description: My Description
+---
+
+import MySnippet from '/snippets/path/to/my-snippet.mdx';
+
+## Header
+
+Lorem impsum dolor sit amet.
+
+
+ Uno de los siguientes: `mint`, `maple`, `palm`, `willow`, `linden`, `almond`.
+
+ El tema de diseño del proyecto. Consulta la página de [Themes](themes) para más información.
+
+
+
+ El nombre del proyecto, organización o producto
+
+
+
+ Los colores a utilizar en tu documentación. Como mínimo, debes definir el color primario. Por ejemplo:
+
+ ```json
+ {
+ "colors": {
+ "primary": "#ff0000"
+ }
+ }
+ ```
+
+
+
+ El color primario del tema
+
+ Debe ser un código hexadecimal que comience con `#`
+
+
+
+ El color claro del tema. Utilizado para el modo oscuro
+
+ Debe ser un código hexadecimal que comience con `#`
+
+
+
+ El color oscuro del tema. Utilizado para el modo claro
+
+ Debe ser un código hexadecimal que comience con `#`
+
+
+
+
+
+ Descripción opcional utilizada para SEO e indexación de LLM
+
+
+
+ El logotipo (tanto para modo claro como oscuro)
+
+
+
+ Ruta que apunta al archivo de logotipo claro para usar en modo oscuro, incluyendo la extensión del archivo. Ejemplo: `/logo.png`
+
+
+
+ Ruta que apunta al archivo de logotipo oscuro para usar en modo claro, incluyendo la extensión del archivo. Ejemplo: `/logo-dark.png`
+
+
+
+ La URL a la que redirigir al hacer clic en el logotipo. Si no se proporciona, el logotipo enlazará a la página de inicio. Ejemplo: `https://example.com`
+
+
+
+
+
+ La ruta a tu archivo de favicon en la carpeta de documentos, incluyendo la extensión del archivo. El archivo se redimensionará automáticamente a los tamaños apropiados de favicon.
+ Puede ser un solo archivo o un par para modo claro y oscuro. Ejemplo: `/favicon.png`
+
+
+
+ Ruta que apunta al archivo de favicon claro para usar en modo oscuro, incluyendo la extensión del archivo. Ejemplo: `/favicon.png`
+
+
+
+ Ruta que apunta al archivo de favicon oscuro para usar en modo claro, incluyendo la extensión del archivo. Ejemplo: `/favicon-dark.png`
+
+
+
+
+
+ Configuraciones de estilo
+
+
+
+ El estilo de las cejas del contenido. Por defecto es `section`.
+
+
+
+ El tema del bloque de código. Por defecto es `system`.
+
+
+
+
+
+ Configuración de la biblioteca de iconos
+
+
+
+ La biblioteca de iconos a utilizar. Por defecto es `fontawesome`.
+
+
+
+
+
+
+
+ La familia de fuentes, como "Open Sans", "Playfair Display"
+
+
+
+ El peso de la fuente, como 400, 700. Se admiten pesos de fuente precisos como 550 para fuentes variables.
+
+
+
+ La fuente de la fuente, como [https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2](https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2)
+
+
+
+ El formato de la fuente, puede ser uno de woff, woff2
+
+
+
+
+
+ La familia de fuentes, como "Open Sans", "Playfair Display"
+
+
+
+ El peso de la fuente, como 400, 700. Se admiten pesos de fuente precisos como 550 para fuentes variables.
+
+
+
+ La fuente de la fuente, como [https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2](https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2)
+
+
+
+ El formato de la fuente, puede ser uno de woff, woff2
+
+
+
+
+
+
+
+ La familia de fuentes, como "Open Sans", "Playfair Display"
+
+
+
+ El peso de la fuente, como 400, 700. Se admiten pesos de fuente precisos como 550 para fuentes variables.
+
+
+
+ La fuente de la fuente, como [https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2](https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2)
+
+
+
+ El formato de la fuente, puede ser uno de woff, woff2
+
+
+
+
+
+
+
+ Configuración del interruptor de modo claro / oscuro
+
+
+
+ El modo claro/oscuro predeterminado. Por defecto es `system`
+
+
+
+ Si se debe ocultar el interruptor de modo claro / oscuro. Por defecto es `true`.
+
+
+
+
+
+ Configuración del color de fondo y decoración
+
+
+
+
+
+
+
+
+ La decoración de fondo del tema
+
+
+
+ Los colores del fondo
+
+
+
+ El color en formato hexadecimal para usar en modo claro
+
+ Debe coincidir con el patrón: ^#(\[a-fA-F0-9]{6}|\[a-fA-F0-9]{3})\$
+
+
+
+ El color en formato hexadecimal para usar en modo oscuro
+
+ Debe coincidir con el patrón: ^#(\[a-fA-F0-9]{6}|\[a-fA-F0-9]{3})\$
+
+
+
+
+
+
+### Structure
+
+
+ Contenido y configuración de la barra de navegación
+
+
+
+ Los enlaces en la barra de navegación
+
+
+
+ Una ruta válida o enlace externo
+
+
+
+
+
+
+
+ La etiqueta para el botón primario. Esto solo se aplica cuando `type` está configurado como `button`.
+
+
+
+ Una ruta válida o enlace externo. Si `type` está configurado como `github`, esta será la URL al repositorio.
+
+
+
+
+
+
+
+ La estructura de navegación del contenido
+
+
+
+ Agregar enlaces externos que aparecerán en todas las secciones y páginas independientemente del anidamiento de navegación
+
+
+
+
+
+ El nombre del idioma en formato ISO 639-1
+
+
+
+ Si este idioma es el idioma predeterminado
+
+
+
+ Si la opción actual está oculta por defecto
+
+
+
+ Una ruta válida o enlace externo
+
+
+
+
+
+
+
+ El nombre de la versión
+
+ Longitud mínima: 1
+
+
+
+ Si esta versión es la versión predeterminada
+
+
+
+ Si la opción actual está oculta por defecto
+
+
+
+ Un enlace externo
+
+
+
+
+
+
+
+ El nombre de la pestaña
+
+ Longitud mínima: 1
+
+
+
+ El icono que se mostrará en la sección
+
+
+
+ Si la opción actual está oculta por defecto
+
+
+
+ Un enlace externo
+
+
+
+
+
+
+
+ El nombre del ancla
+
+ Longitud mínima: 1
+
+
+
+ El icono que se mostrará en la sección
+
+
+
+
+
+ El color en formato hexadecimal para usar en modo claro
+
+ Debe coincidir con el patrón: ^#(\[a-fA-F0-9]{6}|\[a-fA-F0-9]{3})\$
+
+
+
+ El color en formato hexadecimal para usar en modo oscuro
+
+ Debe coincidir con el patrón: ^#(\[a-fA-F0-9]{6}|\[a-fA-F0-9]{3})\$
+
+
+
+
+
+ Si la opción actual está oculta por defecto
+
+
+
+ Una ruta válida o enlace externo
+
+
+
+
+
+
+
+ El nombre del menú desplegable
+
+ Longitud mínima: 1
+
+
+
+ El icono que se mostrará en la sección
+
+
+
+ Si la opción actual está oculta por defecto
+
+
+
+ Un enlace externo
+
+
+
+
+
+
+
+ Organizando por [idiomas](navigation#localization)
+
+
+
+ Organizando por [versiones](navigation#versions)
+
+
+
+ Organizando por [pestañas](navigation#divisions#tabs)
+
+
+
+ Organizando por [anclas](navigation#divisions#anchors)
+
+
+
+ Organizando por [desplegables](navigation#divisions#dropdowns)
+
+
+
+ Organizando por [grupos](navigation#pages#pages)
+
+
+
+ Un array de [rutas de página o grupos](navigation#pages#groups)
+
+
+
+
+
+ Configuraciones del pie de página
+
+
+
+ Un objeto en el que cada clave es el nombre de una plataforma de redes sociales, y cada valor es la url de tu perfil. Por ejemplo:
+
+ ```json
+ {
+ "x": "https://x.com/mintlify"
+ }
+ ```
+
+ Nombres de propiedades válidos: `x`, `website`, `facebook`, `youtube`, `discord`, `slack`, `github`, `linkedin`, `instagram`, `hacker-news`, `medium`, `telegram`, `twitter`, `x-twitter`, `earth-americas`, `bluesky`, `threads`, `reddit`, `podcast`
+
+
+
+ Los enlaces que se mostrarán en el pie de página
+
+
+
+ El título del encabezado de la columna
+
+ Longitud mínima: 1
+
+
+
+ Los enlaces que se mostrarán en la columna
+
+
+
+ La etiqueta del enlace
+
+ Longitud mínima: 1
+
+
+
+ La url del enlace
+
+
+
+
+
+
+
+
+
+ Configuraciones del banner
+
+
+
+ El contenido del banner. Puede ser una cadena de texto o una cadena de markdown. Por ejemplo:
+
+ ```json
+ {
+ "content": "🚀 Banner is live! [Learn more](mintlify.com)"
+ }
+ ```
+
+
+
+ Si el banner se puede descartar. Por defecto es `false`.
+
+
+
+
+
+
+
+
+
+
+
+
+ Las opciones que se mostrarán en el menú contextual. La primera opción es la opción predeterminada.
+
+ * `copy`: Copiar la página actual como markdown al portapapeles
+ * `view`: Ver la página actual como markdown en una nueva pestaña
+ * `chatgpt`: Alimentar la página actual a ChatGPT
+ * `claude`: Alimentar la página actual a Claude
+
+ 
+
+
+ El menú contextual solo está disponible en despliegues de vista previa y producción.
+
+
+
+
+
+### Configuraciones de API
+
+
+ Configuración de referencia de API y ajustes del playground
+
+
+
+ Una cadena o un array de cadenas de urls absolutas o relativas que apuntan al archivo(s) OpenAPI
+
+
+
+ Longitud mínima: 1
+
+
+
+ sin barra inicial en el directorio
+
+
+
+
+
+ Una cadena o un array de cadenas de urls absolutas o relativas que apuntan al archivo(s) AsyncAPI
+
+
+
+ Longitud mínima: 1
+
+
+
+
+
+
+ Configuraciones para el playground de API
+
+
+
+ El modo de visualización del playground de API. Por defecto es `interactive`.
+
+
+
+ Si se deben pasar las solicitudes de API a través de un servidor proxy. Por defecto es `true`.
+
+
+
+
+
+ Configuraciones para los ejemplos de API autogenerados
+
+
+
+ Lenguajes de ejemplo para los fragmentos de API autogenerados
+
+
+
+ Si se deben mostrar parámetros opcionales en los ejemplos de api, por defecto es `all`
+
+
+
+
+
+ Configuraciones para páginas de API generadas a partir de archivos MDX
+
+
+
+ Configuración de autenticación para la API
+
+
+
+ Método de autenticación para la API
+
+
+
+ Nombre de autenticación para la API
+
+
+
+
+
+
+
+
+
+### SEO y Búsqueda
+
+
+ Configuraciones de indexación SEO
+
+
+
+ Etiquetas meta añadidas a cada página. Debe ser un par clave-valor válido. Opciones posibles [aquí](https://mintlify.com/docs/settings/seo#supported-meta-tags)
+
+
+
+ Especifica qué páginas deben ser indexadas por los motores de búsqueda. Establecer `navigable` indexa las páginas que están establecidas en la navegación, `all` indexa todas las páginas. Por defecto es `navigable`.
+
+
+
+
+
+ Configuración de visualización de búsqueda
+
+
+
+ El mensaje que se mostrará en el marcador de posición de la barra de búsqueda
+
+
+
+
+### Integraciones
+
+
+ Configuraciones para integraciones oficiales
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Longitud mínima: 6
+
+
+
+
+
+
+
+ Debe coincidir con el patrón: ^G
+
+
+
+
+
+
+
+ Debe coincidir con el patrón: ^G
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Longitud mínima: 6
+
+
+
+
+
+
+
+ Longitud mínima: 2
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Debe coincidir con el patrón: ^phc\_
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+### Errores
+
+
+
+
+
+
+ Si se debe redirigir a la página de inicio, si la página no se encuentra
+
+
+
+
+
+
+## Validación
+
+Se recomienda incluir la siguiente referencia de esquema en la parte superior de tu archivo docs.json para garantizar una validación adecuada durante la edición:
+
+```json
+{
+ "$schema": "https://mintlify.com/docs.json",
+ ...
+}
+```
diff --git a/es/settings/authentication-personalization/authentication-setup/choosing-a-handshake.mdx b/es/settings/authentication-personalization/authentication-setup/choosing-a-handshake.mdx
new file mode 100644
index 00000000..f030cde3
--- /dev/null
+++ b/es/settings/authentication-personalization/authentication-setup/choosing-a-handshake.mdx
@@ -0,0 +1,86 @@
+---
+- title: Elegir un Handshake
+- description: Cómo decidir qué método de Handshake es el adecuado para su documentación
+---
+
+
+ Esta es la documentación para los métodos de**Autenticación**Handshake. La personalización ofrece un[conjunto diferente de métodos Handshake](/es/settings/authentication-personalization/personalization-setup/choosing-a-handshake).
+
+
+Antes de que sus usuarios puedan acceder al contenido personalizado, deben ser autenticados. Mintlify admite cuatro métodos de Handshake de Autenticación:
+
+1. **Contraseña**: Configure un conjunto de contraseñas globales para su sitio de documentación.
+2. **JWT**: Utilice su propio flujo de inicio de sesión para autenticar a sus usuarios mediante un JWT en la URL.
+3. **OAuth 2.0**: Integre con su servidor OAuth para habilitar el inicio de sesión de usuarios a través del flujo estándar de Código de Autorización.
+4. **Panel de Control de Mintlify**: Permita que todos los usuarios de su panel de control accedan a su documentación, sin configuración requerida.
+
+## Requisitos previos
+
+
+
+ * Sus requisitos de seguridad permiten compartir contraseñas entre los lectores de la documentación.
+
+
+
+ * Tiene algún flujo de inicio de sesión existente.
+ * Puede agregar un paso final en este flujo de inicio de sesión que cree un JWT y redirija a la documentación.
+
+
+
+ * Tiene un servidor OAuth existente que admite el flujo de Código de Autorización.
+ * Puede crear un nuevo endpoint de API al que se pueda acceder con el token de acceso OAuth devuelto.
+
+
+
+ * Sus lectores de documentación también son sus editores de documentación.
+
+
+
+## Pros y Contras
+
+
+
+ Pros:
+
+ * Configuración super simple
+ * No se requiere configuración para agregar nuevos usuarios - solo comparta la contraseña
+
+ Cons:
+
+ * Difícil revocar el acceso a su documentación sin restablecer la contraseña
+ * Se pierden las características de personalización, ya que no hay forma de diferenciar a los usuarios con la misma contraseña
+
+
+
+ Pros:
+
+ * Riesgo reducido de abuso del endpoint de API
+ * Configuración CORS cero
+ * Sin restricciones en las URL de API
+
+ Cons:
+
+ * Debe poder conectarse a su flujo de inicio de sesión existente
+
+
+
+ Pros:
+
+ * Estándar de seguridad elevado
+
+ Cons:
+
+ * Requiere trabajo significativo si se configura el servidor OAuth por primera vez
+ * Puede ser excesivo para algunas aplicaciones
+
+
+
+ Pros:
+
+ * Configuración cero
+
+ Cons:
+
+ * Requiere que todos los lectores de documentación tengan una cuenta en su panel de control de Mintlify
+
+
diff --git a/es/settings/authentication-personalization/authentication-setup/jwt.mdx b/es/settings/authentication-personalization/authentication-setup/jwt.mdx
new file mode 100644
index 00000000..e1377bc6
--- /dev/null
+++ b/es/settings/authentication-personalization/authentication-setup/jwt.mdx
@@ -0,0 +1,115 @@
+---
+- title: JWT Handshake
+- description: Usa un flujo de inicio de sesión personalizado para autenticar usuarios
+---
+
+
+ Esta es la documentación para el apretón de manos de autenticación **Authentication** JWT. Los pasos para configurar el apretón de manos de [JWT **Personalization** Handshake](/es/settings/authentication-personalization/personalization-setup/jwt) son ligeramente diferentes.
+
+
+Si no tienes un panel de control, o si quieres mantener tu panel y documentos completamente separados, puedes usar tu propio flujo de inicio de sesión para autenticar usuarios a través de un JWT en la URL.
+
+## Implementación
+
+
+
+ Ve a tu [dashboard settings](https://dashboard.mintlify.com/products/authentication) y genera una clave privada. Almacena esta clave en un lugar seguro donde pueda ser accedida por tu backend.
+
+
+
+ Crea un flujo de inicio de sesión que haga lo siguiente:
+
+ * Autenticar al usuario
+ * Crear un JWT que contenga la información del usuario autenticado en el formato [User](../sending-data)
+ * Firmar el JWT con la clave secreta, usando el algoritmo EdDSA
+ * Crear una URL de redirección de vuelta a la ruta `/login/jwt-callback` de tus documentos, incluyendo el JWT como el hash
+
+
+
+ Vuelve a tu [dashboard settings](https://dashboard.mintlify.com/products/authentication) y agrega la URL de inicio de sesión a tus ajustes de autenticación.
+
+
+
+## Ejemplo
+
+Quiero configurar la autenticación para mis documentos alojados en `docs.foo.com`. Quiero que mis documentos estén completamente separados de mi panel de control (o no tengo un panel de control en absoluto).
+
+Para configurar la autenticación con Mintlify, voy a mi panel de Mintlify y genero un secreto JWT. Creo una URL web `https://foo.com/docs-login` que inicia un flujo de inicio de sesión para mis usuarios. Al final de este flujo de inicio de sesión, una vez que he verificado la identidad del usuario, creo un JWT que contiene los datos personalizados del usuario según la especificación de Mintlify. Uso una biblioteca JWT para firmar este JWT con mi secreto de Mintlify, creo una URL de redirección de la forma `https://docs.foo.com/login/jwt-callback#{SIGNED_JWT}`, y redirijo al usuario.
+
+Luego voy a la configuración del panel y ingreso `https://foo.com/docs-login` en el campo URL de inicio de sesión.
+
+Así es como podría verse el código:
+
+
+ ```ts TypeScript
+ import * as jose from 'jose';
+ import { Request, Response } from 'express';
+
+ const TWO_WEEKS_IN_MS = 1000 * 60 * 60 * 24 * 7 * 2;
+
+ const signingKey = await jose.importPKCS8(process.env.MINTLIFY_PRIVATE_KEY, 'EdDSA');
+
+ export async function handleRequest(req: Request, res: Response) {
+ const user = {
+ expiresAt: Math.floor((Date.now() + TWO_WEEKS_IN_MS) / 1000), // 2 week session expiration
+ groups: res.locals.user.groups,
+ content: {
+ firstName: res.locals.user.firstName,
+ lastName: res.locals.user.lastName,
+ },
+ };
+
+ const jwt = await new jose.SignJWT(user)
+ .setProtectedHeader({ alg: 'EdDSA' })
+ .setExpirationTime('10 s') // 10 second JWT expiration
+ .sign(signingKey);
+
+ return res.redirect(`https://docs.foo.com/login/jwt-callback#${jwt}`);
+ }
+ ```
+
+ ```python Python
+ import jwt # pyjwt
+ import os
+
+ from datetime import datetime, timedelta
+ from fastapi.responses import RedirectResponse
+
+ private_key = os.getenv(MINTLIFY_JWT_PEM_SECRET_NAME, '')
+
+ @router.get('/auth')
+ async def return_mintlify_auth_status(current_user):
+ jwt_token = jwt.encode(
+ payload={
+ 'exp': int((datetime.now() + timedelta(seconds=10)).timestamp()), # 10 second JWT expiration
+ 'expiresAt': int((datetime.now() + timedelta(weeks=2)).timestamp()), # 1 week session expiration
+ 'groups': ['admin'] if current_user.is_admin else [],
+ 'content': {
+ 'firstName': current_user.first_name,
+ 'lastName': current_user.last_name,
+ },
+ },
+ key=private_key,
+ algorithm='EdDSA'
+ )
+
+ return RedirectResponse(url=f'https://docs.foo.com/login/jwt-callback#{jwt_token}', status_code=302)
+ ```
+
+
+## Redirigiendo usuarios no autenticados
+
+Cuando un usuario no autenticado intenta acceder a una página específica, Mintlify preserva su destino previsto a través de un flujo de redirección:
+
+1. El usuario intenta visitar una página determinada (por ejemplo, `/quickstart`)
+
+2. Mintlify los redirige a tu URL de inicio de sesión y agrega el destino original (relativo) como un parámetro de consulta `redirect`
+
+Example:
+
+* Solicitud original: [`https://docs.foo.com/quickstart`](https://docs.foo.com/quickstart)
+
+* Redirección al inicio de sesión: [`https://foo.com/docs-login?redirect=%2Fquickstart`](https://foo.com/docs-login?redirect=%2Fquickstart)
+
+Después de una autenticación exitosa, puedes incluir este mismo parámetro `redirect` en tu URL de devolución de llamada JWT para enviar a los usuarios a su destino previsto:
+`https://docs.foo.com/login/jwt-callback?redirect=%2Fquickstart#{SIGNED_JWT}`
diff --git a/es/settings/authentication-personalization/authentication-setup/mintlify.mdx b/es/settings/authentication-personalization/authentication-setup/mintlify.mdx
new file mode 100644
index 00000000..bf520a94
--- /dev/null
+++ b/es/settings/authentication-personalization/authentication-setup/mintlify.mdx
@@ -0,0 +1,39 @@
+---
+- title: Mintlify Auth Handshake
+- description: Usa Mintlify para autenticar usuarios
+---
+
+
+ El Mintlify Auth Handshake está disponible solo para Autenticación, *no*
+ Personalización.
+
+
+Puedes usar Mintlify para autenticar y gestionar el acceso a tu documentación. Cualquiera que pueda acceder a tu panel de control automáticamente podrá ver tu documentación.
+
+Este método de handshake también habilita despliegues de vista previa privados, de modo que solo los usuarios autenticados de Mintlify podrán acceder a tus despliegues de vista previa.
+
+
+ La autenticación está disponible solo bajo petición. Por favor{" "}
+ contacta con ventas para obtener acceso. Después de que hayamos habilitado el acceso, puedes seguir las instrucciones de implementación.
+
+
+### Ejemplo
+
+Quiero configurar la autenticación para mis documentos alojados en `docs.foo.com`. Quiero que mis documentos sean internos, y las personas que verán mis documentos son las mismas que contribuyen a mis documentos.
+
+Para configurar la autenticación con Mintlify, puedo ir a mi [panel de configuración](https://dashboard.mintlify.com/products/authentication)
+y habilitar la Autenticación con el Mintlify Auth Handshake.
+
+Luego puedo asegurarme de que cualquiera que deba poder leer los documentos haya sido añadido como usuario en mi [panel de configuración](https://dashboard.mintlify.com/settings/organization/members).
+
+## Implementación
+
+
+
+ Ve a tu [panel de configuración de Mintlify](https://dashboard.mintlify.com/products/authentication) y selecciona el Mintlify Auth Handshake.
+
+
+
+ Asegúrate de que cualquier usuario que deba poder ver tu documentación haya sido añadido como usuario en tu [panel de configuración de Mintlify](https://dashboard.mintlify.com/settings/organization/members).
+
+
diff --git a/es/settings/authentication-personalization/authentication-setup/oauth.mdx b/es/settings/authentication-personalization/authentication-setup/oauth.mdx
new file mode 100644
index 00000000..6959ebe3
--- /dev/null
+++ b/es/settings/authentication-personalization/authentication-setup/oauth.mdx
@@ -0,0 +1,53 @@
+---
+- title: Protocolo OAuth 2.0
+- description: Integra con tu servidor OAuth para habilitar el inicio de sesión
+ del usuario a través del flujo de Código de Autorización
+---
+
+
+ Esta es la documentación para el Protocolo de Autenticación **Authentication** OAuth. Los pasos para configurar el Protocolo de [OAuth **Personalization**](/es/settings/authentication-personalization/personalization-setup/oauth) son ligeramente diferentes.
+
+
+Si tiene un servidor OAuth existente, puede integrarlo con Mintlify para una experiencia de inicio de sesión sin problemas.
+
+## Implementación
+
+
+
+ Vaya a su [configuración de autenticación de Mintlify](https://dashboard.mintlify.com/products/authentication), seleccione la opción OAuth y complete los campos requeridos:
+
+ * **URL de Autorización**: La URL base para la solicitud de autorización, a la que agregaremos los parámetros de consulta apropiados.
+ * **ID del Cliente**: Un ID para el cliente OAuth 2.0 que se utilizará.
+ * **Ámbitos**: Un array de ámbitos que se solicitarán.
+ * **URL del Token**: La URL base para la solicitud de intercambio de token.
+ * **URL de la API de Información** (opcional): El punto final que se utilizará para recuperar la información del usuario. Si se omite, el flujo OAuth solo se utilizará para verificar la identidad, y la información del usuario estará vacía.
+
+
+
+ Copie la URL de Redirección listada en la [configuración de autenticación de Mintlify](https://dashboard.mintlify.com/products/authentication) y agréguela como una URL de redirección autorizada para su servidor OAuth.
+
+
+
+ Si desea aprovechar las funciones de personalización de la autenticación, necesitará crear un punto final para recuperar información sobre sus usuarios.
+ Cree un punto final de API que pueda ser accedido con un token de acceso OAuth y responda con una carga útil JSON siguiendo el formato [User](../sending-data).
+
+ Vuelva a su [configuración de autenticación de Mintlify](https://dashboard.mintlify.com/products/authentication) y agregue la URL de la API de Información
+ a su configuración de OAuth.
+
+
+
+## Ejemplo
+
+Tengo un servidor OAuth existente que admite el flujo de Código de Autorización. Quiero configurar la autenticación para mis documentos alojados en `foo.com/docs`.
+
+Para configurar la autenticación con Mintlify, creo un punto final `api.foo.com/docs/user-info` que requiere un token de acceso OAuth con el ámbito `docs-user-info` y responde con los datos personalizados del usuario según la especificación de Mintlify.
+
+Luego voy al panel de configuración, navego a la configuración de Autenticación, selecciono OAuth e ingreso los valores relevantes para el flujo OAuth y el punto final de la API de información:
+
+* **URL de autorización**: `https://auth.foo.com/authorization`
+* **ID de cliente**: `ydybo4SD8PR73vzWWd6S0ObH`
+* **Ámbitos**: `['docs-user-info']`
+* **URL del token**: `https://auth.foo.com/exchange`
+* **URL de la API de información**: `https://api.foo.com/docs/user-info`
+
+Finalmente, copio la URL de redirección mostrada en la configuración del panel y la agrego como una URL de redirección autorizada en la configuración de mi cliente OAuth.
diff --git a/es/settings/authentication-personalization/authentication-setup/password.mdx b/es/settings/authentication-personalization/authentication-setup/password.mdx
new file mode 100644
index 00000000..1ac26001
--- /dev/null
+++ b/es/settings/authentication-personalization/authentication-setup/password.mdx
@@ -0,0 +1,40 @@
+---
+- title: Intercambio de Contraseñas
+- description: Usa un conjunto de contraseñas compartidas para autenticar usuarios
+---
+
+
+ Esta es la documentación para el Handshake de Contraseña de **Autenticación**. El Handshake de Contraseña no está disponible para Personalización.
+
+
+Si no tienes requisitos de seguridad estrictos, o no quieres gestionar una base de datos de lectores de documentación, puedes usar un conjunto de contraseñas compartidas para proteger tus documentos.
+
+
+ La autenticación está disponible solo bajo petición. Por favor{" "}
+ contacta con nuestro equipo de ventas para obtener acceso. Después de que hayamos habilitado el acceso, puedes seguir las instrucciones de implementación.
+
+
+## Implementación
+
+
+
+ Ve a tu [dashboard
+ ajustes](https://dashboard.mintlify.com/products/authentication) y crea
+ una contraseña.
+
+
+
+ Comparte de forma segura la contraseña con los lectores de tu documentación. ¡Eso es todo!
+
+
+
+## Ejemplo
+
+Quiero configurar la autenticación para mis documentos alojados en `docs.foo.com`. No quiero
+tener que hacer un seguimiento de quién puede y no puede acceder a los documentos. Mi caso de uso principal para
+la autenticación es evitar que los competidores husmeen - compartir la contraseña es lo suficientemente
+seguro para mi equipo.
+
+Para configurar la autenticación con Mintlify, voy a mi dashboard de Mintlify y agrego al
+menos una contraseña. Luego comparto esa contraseña, junto con la URL de los documentos privados,
+con los clientes potenciales.
diff --git a/es/settings/authentication-personalization/authentication-vs-personalization.mdx b/es/settings/authentication-personalization/authentication-vs-personalization.mdx
new file mode 100644
index 00000000..5e92da90
--- /dev/null
+++ b/es/settings/authentication-personalization/authentication-vs-personalization.mdx
@@ -0,0 +1,27 @@
+---
+- title: Autenticación vs Personalización
+- description: Cómo determinar qué producto es mejor para ti
+- icon: arrow-right-left
+---
+
+Mintlify ofrece tanto Autenticación como Personalización. En su mayor parte, la Autenticación es simplemente Personalización + privacidad. Sin embargo, hay algunas diferencias clave que es importante tener en cuenta, de más importante a menos importante:
+
+### Garantías de Seguridad
+
+La Autenticación es una solución de documentación privada completamente desarrollada. Cada aspecto de tus documentos, incluyendo el contenido de las páginas, imágenes, resultados de búsqueda y características del asistente de IA, son completamente inaccesibles para usuarios no autenticados.
+
+La Personalización, por otro lado, no ofrece garantías de seguridad para el contenido de tu documentación. Todo el contenido de las páginas, imágenes, resultados de búsqueda y características del asistente de IA pueden ser accedidos por el público. Incluso si estás usando la función de páginas ocultas de Personalización, un atacante motivado aún podría acceder al contenido de una página oculta.
+
+### Métodos de Handshake
+
+Debido a la diferencia en los requisitos de seguridad para Autenticación y Personalización, diferentes métodos de handshake están disponibles para cada uno. Ambos métodos ofrecen un Handshake JWT y OAuth, aunque los pasos de configuración son ligeramente diferentes.
+
+La Autenticación ofrece dos métodos de Handshake adicionales:
+
+* **Handshake de Contraseña**, que protege tu sitio web con una única contraseña global configurable.
+
+* **Mintlify Auth Handshake**, que permitirá a los usuarios ver tu documentación solo si tienen acceso a tu panel de control.
+
+La Personalización ofrece un método de Handshake adicional:
+
+* **Handshake de Sesión Compartida**, un método super simple que solo requiere configurar un único endpoint que devuelve datos para usuarios ya autenticados.
diff --git a/es/settings/authentication-personalization/authentication.mdx b/es/settings/authentication-personalization/authentication.mdx
new file mode 100644
index 00000000..155bc050
--- /dev/null
+++ b/es/settings/authentication-personalization/authentication.mdx
@@ -0,0 +1,28 @@
+---
+- title: Autenticación
+- description: Garantiza la privacidad de tus documentos autenticando a los usuarios
+- icon: file-lock
+---
+
+
+ Los métodos de autenticación están disponibles en los planes [Growth y Enterprise](https://mintlify.com/pricing?ref=authentication). Por favor{" "}
+ contacta a ventas para más información.
+
+
+La autenticación ofrece privacidad completa para todo el contenido de tu documentación al requerir que los usuarios se autentiquen antes de ver cualquier contenido, como:
+
+* Contenido de la página de documentación
+* Imágenes utilizadas en las páginas de documentación
+* Resultados de búsqueda
+* Interacciones con el asistente de IA
+
+Puedes autenticar usuarios a través de métodos de handshake como:
+
+* [Contraseña](./authentication-setup/password)
+* [JWT](./authentication-setup/jwt)
+* [OAuth](./authentication-setup/oauth)
+* [Panel de control de Mintlify](./authentication-setup/mintlify)
+
+La autenticación es similar a nuestra oferta de [Personalización](./personalization), pero con privacidad garantizada. Además de asegurar el contenido de tu documentación, todas las características que están disponibles a través de la Personalización también están disponibles a través de la Autenticación.
+
+Consulta nuestra documentación para obtener más información sobre [elegir entre Autenticación y Personalización](./authentication-vs-personalization).
diff --git a/es/settings/authentication-personalization/partial-authentication.mdx b/es/settings/authentication-personalization/partial-authentication.mdx
new file mode 100644
index 00000000..9450ef03
--- /dev/null
+++ b/es/settings/authentication-personalization/partial-authentication.mdx
@@ -0,0 +1,25 @@
+---
+- title: Autenticación Parcial
+- description: Autenticar usuarios para ver solo ciertas páginas
+- icon: file-lock-2
+---
+
+La Autenticación Parcial permite autenticar a los usuarios para ver solo ciertas páginas.
+
+Puedes autenticar a los usuarios a través de métodos de handshake como:
+
+* [Contraseña](./authentication-setup/password)
+* [JWT](./authentication-setup/jwt)
+* [OAuth](./authentication-setup/oauth)
+* [Mintlify dashboard](./authentication-setup/mintlify)
+
+La Autenticación Parcial comparte todas las mismas características que la [Authentication](./authentication), pero con la capacidad de permitir que los usuarios no autenticados vean ciertas páginas.
+
+Por defecto, todas las páginas están protegidas. Puedes especificar qué páginas deben ser accesibles públicamente añadiendo la `public` propiedad al frontmatter de la página.
+
+```mdx
+---
+title: "My Page"
+public: true
+---
+```
diff --git a/es/settings/authentication-personalization/personalization-setup/choosing-a-handshake.mdx b/es/settings/authentication-personalization/personalization-setup/choosing-a-handshake.mdx
new file mode 100644
index 00000000..f427f926
--- /dev/null
+++ b/es/settings/authentication-personalization/personalization-setup/choosing-a-handshake.mdx
@@ -0,0 +1,86 @@
+---
+- title: Eligiendo un Handshake
+- description: Cómo decidir qué método de Handshake es adecuado para tus docs
+---
+
+
+ Esta es la documentación para los métodos de **Personalization** Handshake. La autenticación ofrece un [conjunto diferente de métodos Handshake](/es/settings/authentication-personalization/authentication-setup/choosing-a-handshake).
+
+
+Antes de que sus usuarios puedan acceder al contenido personalizado, deben estar autenticados. Mintlify admite tres métodos de Personalization Handshake:
+
+1. **Shared Session**: Utilice el mismo token de sesión utilizado por su panel para autenticar usuarios.
+2. **JWT**: Use su propio flujo de inicio de sesión para enviar información del usuario a sus documentos a través de un JWT en la URL.
+3. **OAuth 2.0**: Intégrese con su servidor OAuth para habilitar el inicio de sesión del usuario a través del flujo PKCE.
+
+## Requisitos previos
+
+
+
+ * Tiene un panel u otro portal de usuario alojado en su dominio.
+ * Las credenciales de sesión de sus usuarios se almacenan como cookies.
+ * Puede crear un nuevo punto final de API en el mismo origen o un subdominio de su panel.
+ * Si su panel está en `foo.com`, la **API URL** debe comenzar con `foo.com` o `*.foo.com`
+ * Si su panel está en `dash.foo.com`, la **API URL** debe comenzar con `dash.foo.com` o `*.dash.foo.com`
+ * Sus documentos están alojados en el mismo dominio que su panel.
+ * Si su panel está en `foo.com`, sus **docs**debe ser alojado en`foo.com`o`*.foo.com`
+ * Si tu panel de control está en`*.foo.com`, tus**docs**deben ser alojados en`foo.com`o`*.foo.com`
+
+
+
+ * Tienes algún flujo de inicio de sesión existente.
+ * Puedes agregar un paso final en este flujo de inicio de sesión que cree un JWT y redirija a los docs.
+
+
+
+ * Tienes un servidor OAuth existente que soporta el flujo PKCE.
+ * Puedes crear un nuevo endpoint de API que pueda ser accedido por el token de acceso OAuth devuelto.
+
+
+
+## Pros y Contras
+
+
+
+ Pros:
+
+ * Los usuarios que han iniciado sesión en tu panel de control automáticamente inician sesión en tus docs
+ * Las sesiones de tus usuarios son persistentes, lo que significa que puedes actualizar datos sin requerir inicio de sesión adicional
+ * Configuración mínima requerida
+
+ Cons:
+
+ * Tus docs harán una solicitud a tu backend, lo cual puede ser indeseable
+ * Debes tener un panel de control que use autenticación de sesión
+ * Generalmente se requiere configuración CORS
+
+
+
+ Pros:
+
+ * Riesgo reducido de abuso del endpoint de API
+ * Cero configuración CORS
+ * Sin restricciones en las URLs de API
+
+ Cons:
+
+ * Debe ser capaz de conectarse a tu flujo de inicio de sesión existente
+ * Las sesiones del panel de control y la autenticación de docs están completamente desacopladas, por lo que los usuarios necesitarán iniciar sesión en tu panel de control y en tus docs por separado
+ * Cada vez que quieras actualizar los datos del usuario, tus usuarios deben volver a iniciar sesión en tus docs
+ * Si los datos de tus usuarios cambian con frecuencia, debes requerir que tus usuarios inicien sesión frecuentemente o arriesgarte a tener datos obsoletos en los docs
+ * Si los datos de tus usuarios rara vez cambian, esto no debería ser un problema
+
+
+
+ Pros:
+
+ * Estándar de seguridad elevado
+ * Sin restricciones en las URLs de API
+
+ Cons:
+
+ * Requiere trabajo significativo si se configura el servidor OAuth por primera vez
+ * Las sesiones del panel de control y la autenticación de docs están completamente desacopladas, por lo que los usuarios necesitarán iniciar sesión en tu panel de control y en tus docs por separado
+ * Puede ser excesivo para algunas aplicaciones
+
+
diff --git a/es/settings/authentication-personalization/personalization-setup/jwt.mdx b/es/settings/authentication-personalization/personalization-setup/jwt.mdx
new file mode 100644
index 00000000..3a4a0a47
--- /dev/null
+++ b/es/settings/authentication-personalization/personalization-setup/jwt.mdx
@@ -0,0 +1,85 @@
+---
+- title: JWT Handshake
+- description: Utiliza un flujo de inicio de sesión personalizado para autenticar usuarios
+---
+
+
+ Esta es la documentación para el **Personalización** Handshake. Los pasos para configurar el [JWT **Authentication** Handshake](/es/settings/authentication-personalization/authentication-setup/jwt) son ligeramente diferentes.
+
+
+Si no tienes un panel de control, o si quieres mantener tu panel de control y documentación completamente separados, puedes usar tu propio flujo de inicio de sesión para enviar información del usuario a tu documentación a través de un JWT en la URL.
+
+## Implementación
+
+
+
+ Ve a tu [dashboard settings](https://dashboard.mintlify.com/products/authentication) y genera una clave privada. Almacena esta clave en un lugar seguro donde pueda ser accedida por tu backend.
+
+
+
+ Crea un flujo de inicio de sesión que haga lo siguiente:
+
+ * Autenticar al usuario
+ * Crear un JWT que contenga la información del usuario autenticado en el formato [User](../sending-data)
+ * Firmar el JWT con la clave secreta, utilizando el algoritmo ES256
+ * Crear una URL de redirección de vuelta a tu documentación, incluyendo el JWT como el hash
+
+
+
+ Vuelve a tu [dashboard settings](https://dashboard.mintlify.com/products/authentication) y añade la URL de inicio de sesión a tus ajustes de Personalización.
+
+
+
+## Ejemplo
+
+Quiero configurar la autenticación para mi documentación alojada en `docs.foo.com`. Quiero que mi documentación
+esté completamente separada de mi panel de control (o no tengo un panel de control en absoluto).
+
+Para configurar la autenticación con Mintlify, voy a mi panel de control de Mintlify y genero un
+secreto JWT. Creo una URL web `https://foo.com/docs-login` que inicia un flujo de inicio de sesión
+para mis usuarios. Al final de este flujo de inicio de sesión, una vez que he verificado la identidad del usuario,
+creo un JWT que contiene los datos personalizados del usuario según la especificación de Mintlify.
+Uso una biblioteca JWT para firmar este JWT con mi secreto de Mintlify, creo una URL de redirección de la
+forma `https://docs.foo.com#{SIGNED_JWT}`, y redirijo al usuario.
+
+Luego voy a la configuración del panel de control e ingreso `https://foo.com/docs-login` en el
+campo URL de inicio de sesión.
+
+Así es como podría verse el código:
+
+```ts
+import * as jose from 'jose';
+import { Request, Response } from 'express';
+
+const TWO_WEEKS_IN_MS = 1000 * 60 * 60 * 24 * 7 * 2;
+
+const signingKey = await jose.importPKCS8(process.env.MINTLIFY_PRIVATE_KEY, 'ES256');
+
+export async function handleRequest(req: Request, res: Response) {
+ const user = {
+ expiresAt: Math.floor((Date.now() + TWO_WEEKS_IN_MS) / 1000),
+ groups: res.locals.user.groups,
+ content: {
+ firstName: res.locals.user.firstName,
+ lastName: res.locals.user.lastName,
+ },
+ };
+
+ const jwt = await new jose.SignJWT(user)
+ .setProtectedHeader({ alg: 'ES256' })
+ .setExpirationTime('10 s')
+ .sign(signingKey);
+
+ return res.redirect(`https://docs.foo.com#${jwt}`);
+}
+
+```
+
+## Preservando Anclas
+
+Después del inicio de sesión, si deseas redirigir a un ancla específica en la página, puedes usar el siguiente formato para crear la URL de redirección: `https://docs.foo.com/page#jwt={SIGNED_JWT}&anchor={ANCHOR}`.
+
+Example:
+
+* Original: `https://docs.foo.com/quickstart#step-one`
+* Redirect: `https://docs.foo.com/quickstart#jwt={SIGNED_JWT}&anchor=step-one`
diff --git a/es/settings/authentication-personalization/personalization-setup/oauth.mdx b/es/settings/authentication-personalization/personalization-setup/oauth.mdx
new file mode 100644
index 00000000..be5fd80b
--- /dev/null
+++ b/es/settings/authentication-personalization/personalization-setup/oauth.mdx
@@ -0,0 +1,49 @@
+---
+- title: OAuth 2.0 Handshake
+- description: Integra con tu servidor OAuth para habilitar el inicio de sesión de
+ usuarios a través del flujo PKCE
+---
+
+
+ Esta es la documentación para el**Personalization** Handshake de OAuth. Los pasos para configurar el[OAuth**Authentication** Handshake](/es/settings/authentication-personalization/authentication-setup/oauth) son ligeramente diferentes.
+
+
+Si tienes un servidor OAuth existente que soporta el flujo PKCE, puedes integrarlo con Mintlify para una experiencia de inicio de sesión sin problemas.
+
+## Implementación
+
+
+
+ Crea un endpoint de API que pueda ser accedido con un token de acceso OAuth, y responda con una carga útil JSON siguiendo el formato[User](../sending-data). Toma nota del alcance o alcances requeridos para acceder a este endpoint.
+
+
+
+ Ve a tu[dashboard settings](https://dashboard.mintlify.com/products/authentication), selecciona la opción OAuth, y completa los campos requeridos:
+
+ * **Authorization URL**: La URL base para la solicitud de autorización, a la cual agregaremos los parámetros de consulta apropiados.
+ * **Client ID**: Un ID para el cliente OAuth 2.0 que se utilizará.
+ * **Scopes**: Un array de alcances que serán solicitados.
+ * **Token URL**: La URL base para la solicitud de intercambio de token.
+ * **Info API URL**: El endpoint que se utilizará para recuperar la información del usuario.
+
+
+
+ Copia la Redirect URL listada en el[dashboard settings](https://dashboard.mintlify.com/products/authentication) y agrégala como una URL de redirección autorizada para tu servidor OAuth.
+
+
+
+## Ejemplo
+
+Tengo un servidor OAuth existente que soporta el flujo PKCE. Quiero configurar la autenticación para mis documentos alojados en`foo.com/docs`.
+
+Para configurar la autenticación con Mintlify, creo un endpoint`api.foo.com/docs/user-info` que requiere un token de acceso OAuth con el alcance`docs-user-info`, y responde con los datos personalizados del usuario según la especificación de Mintlify.
+
+Luego voy a la configuración del panel, navego a los ajustes de Personalización, selecciono OAuth, e ingreso los valores relevantes para el flujo OAuth y el endpoint de la API de Información:
+
+* **Authorization URL**:`https://auth.foo.com/authorization`
+* **Client ID**:`ydybo4SD8PR73vzWWd6S0ObH`
+* **Scopes**:`['docs-user-info']`
+* **Token URL**:`https://auth.foo.com/exchange`
+* **Info API URL**:`https://api.foo.com/docs/user-info`
+
+Finalmente, copio la Redirect URL mostrada en la configuración del panel y la agrego como una URL de redirección autorizada en la configuración de mi cliente OAuth.
diff --git a/es/settings/authentication-personalization/personalization-setup/shared-session.mdx b/es/settings/authentication-personalization/personalization-setup/shared-session.mdx
new file mode 100644
index 00000000..e90353ae
--- /dev/null
+++ b/es/settings/authentication-personalization/personalization-setup/shared-session.mdx
@@ -0,0 +1,57 @@
+---
+- title: Handshake de Sesión Compartida
+- description: Comparte sin problemas las sesiones de usuario entre tu dashboard y tus docs
+---
+
+
+ Esta es la documentación para el Handshake de Sesión Compartida**Personalization**. El Handshake de Sesión Compartida no está disponible para Autenticación.
+
+
+Este método utiliza la información de autenticación de sesión ya almacenada en el navegador de tu usuario para crear una experiencia de documentación sin problemas.
+
+## Implementación
+
+
+
+ Crea un endpoint de API que utilice la autenticación de sesión para identificar usuarios, y responda con una carga útil JSON siguiendo el formato[User](../sending-data).
+
+ Si el dominio de la API no*coincide exactamente*con el dominio de los docs:
+
+ * Añade el dominio de los docs al encabezado`Access-Control-Allow-Origin`de tu API (no debe ser`*`)
+ * Asegúrate de que el encabezado`Access-Control-Allow-Credentials`de tu API sea`true`
+
+
+ Estas opciones CORS solo necesitan ser habilitadas en el*único endpoint*responsable de devolver la información del usuario. No recomendamos habilitar estas opciones en todos los endpoints del dashboard.
+
+
+
+
+ Ve a tus[ajustes del dashboard](https://dashboard.mintlify.com/products/authentication)y añade la URL de la API y tu URL de Inicio de Sesión a tus ajustes de Personalización.
+
+
+
+## Ejemplos
+
+### Dashboard en subdominio, docs en subdominio
+
+Tengo un dashboard en`dash.foo.com`, que utiliza autenticación de sesión basada en cookies. Mis rutas de API del dashboard están alojadas en`dash.foo.com/api`. Quiero configurar la autenticación para mis docs alojados en`docs.foo.com`.
+
+Para configurar la autenticación con Mintlify, creo otro endpoint del dashboard`dash.foo.com/api/docs/user-info`que identifica al usuario usando autenticación de sesión, y responde con sus datos personalizados según la especificación de Mintlify. Luego añado`https://docs.foo.com`a la lista de permitidos`Access-Control-Allow-Origin`Access-Control-Allow-Origin**solo para esta ruta**, y aseguro que mi configuración`Access-Control-Allow-Credentials`Access-Control-Allow-Credentials`true` **solo para esta ruta**.
+
+Luego voy a los ajustes del dashboard e introduzco`https://dash.foo.com/api/docs/user-info`para el campo URL de la API.
+
+### Dashboard en subdominio, docs en raíz
+
+Tengo un dashboard en`dash.foo.com`, que utiliza autenticación de sesión basada en cookies. Mis rutas de API del dashboard están alojadas en`dash.foo.com/api`. Quiero configurar la autenticación para mis docs alojados en`foo.com/docs`.
+
+Para configurar la autenticación con Mintlify, creo otro endpoint del dashboard`dash.foo.com/api/docs/user-info`que identifica al usuario usando autenticación de sesión, y responde con sus datos personalizados según la especificación de Mintlify. Luego añado`https://foo.com`a la lista de permitidos`Access-Control-Allow-Origin`Access-Control-Allow-Origin**solo para esta ruta**, y aseguro que mi configuración`Access-Control-Allow-Credentials`Access-Control-Allow-Credentials`true` **solo para esta ruta**.
+
+Luego voy a los ajustes del dashboard e introduzco`https://dash.foo.com/api/docs/user-info`para el campo URL de la API.
+
+### Dashboard en raíz, docs en raíz
+
+Tengo un dashboard en`foo.com/dashboard`, que utiliza autenticación de sesión basada en cookies. Mis rutas de API del dashboard están alojadas en`foo.com/api`. Quiero configurar la autenticación para mis docs alojados en`foo.com/docs`.
+
+Para configurar la autenticación con Mintlify, creo otro endpoint del dashboard`foo.com/api/docs/user-info`que identifica al usuario usando autenticación de sesión, y responde con sus datos personalizados según la especificación de Mintlify.
+
+Luego voy a los ajustes del dashboard e introduzco`https://foo.com/api/docs/user-info`para el campo URL de la API.
diff --git a/es/settings/authentication-personalization/personalization.mdx b/es/settings/authentication-personalization/personalization.mdx
new file mode 100644
index 00000000..987296ba
--- /dev/null
+++ b/es/settings/authentication-personalization/personalization.mdx
@@ -0,0 +1,80 @@
+---
+- title: Personalización
+- description: Una lista de características desbloqueadas con Personalización
+- icon: user-pen
+---
+
+La personalización se refiere a un conjunto de características que te permiten personalizar tu experiencia de documentación basándote en cierta información sobre el usuario. Hay tres características principales de la Personalización:
+
+* **Personalizar el contenido MDX** con la información del usuario, como su nombre, plan o título.
+
+* **Prellenar claves de API** en el Área de juego de API para un uso simplificado.
+
+* **Mostrar selectivamente páginas** en la navegación basándose en los grupos del usuario.
+
+## Cómo usar
+
+### Personalización del contenido MDX
+
+Al escribir contenido, puedes usar la variable `user` para acceder a la información que has enviado a tus documentos. Aquí tienes un ejemplo simple:
+
+Hola, {user.name ?? 'reader'}!
+
+```jsx
+Hello, {user.name ?? 'reader'}!
+```
+
+Esta característica se vuelve aún más poderosa cuando se combina con datos personalizados sobre el usuario. Aquí tienes un ejemplo del mundo real que nos permite dar instrucciones específicas sobre cómo acceder a la función de Personalización basándonos en el plan existente del cliente:
+
+La personalización es una característica empresarial. {
+ user.org === undefined
+ ? <>To access this feature, first create an account at the Mintlify dashboard.
+ : user.org.plan !== 'enterprise'
+ ? <>You are currently on the ${user.org.plan ?? 'free'} plan. To speak to our team about upgrading, contact our sales team.
+ : <>To request this feature for your enterprise org, contact our team.
+}
+
+```jsx
+Personalization is an enterprise feature. {
+ user.org === undefined
+ ? <>To access this feature, first create an account at the Mintlify dashboard.
+ : user.org.plan !== 'enterprise'
+ ? <>You are currently on the ${user.org.plan ?? 'free'} plan. To speak to our team about upgrading, contact our sales team.
+ : <>To request this feature for your enterprise org, contact our team.
+}
+```
+
+
+ La información en `user` solo está disponible después de que un usuario haya iniciado sesión. Para usuarios no conectados, el valor de `user` será `{}`. Para evitar que la página falle para usuarios no conectados, siempre usa encadenamiento opcional en tus campos `user`, por ejemplo `{user.org?.plan}`
+
+
+### Prellenado de claves de API
+
+Si devuelves entradas del Área de juego de API en la información del usuario, se prellenarán automáticamente en el Área de juego de API. Asegúrate de que el nombre del campo en la información del usuario coincida exactamente con el nombre en el Área de juego de API.
+
+### Mostrar/Ocultar páginas
+
+Por defecto, cada página es visible para todos los usuarios. Si quieres restringir qué páginas son visibles para tus usuarios, puedes agregar un `groups`campo en los metadatos de tu página.
+Cuando se determina qué páginas mostrar al usuario, Mintlify verificará a qué grupos pertenece el usuario.
+Si el usuario no está en ninguno de los grupos listados en los metadatos de la página, la página no se mostrará.
+
+```md
+---
+title: "Managing Your Users"
+description: "Adding and removing users from your organization"
+groups: ["admin"]
+---
+```
+
+Aquí hay una tabla que muestra si una página se muestra para diferentes combinaciones de `groups` en los metadatos del Usuario y la página:
+
+| | `groups` no en Usuario | `groups: []` en Usuario | `groups: ['admin']` en Usuario |
+| :------------------------------- | :--------------------: | :---------------------: | :----------------------------: |
+| `groups` no en metadatos | ✅ | ✅ | ✅ |
+| `groups: []` en metadatos | ❌ | ❌ | ❌ |
+| `groups: ['admin']` en metadatos | ❌ | ❌ | ✅ |
+
+
+ Ten en cuenta que un array vacío en los metadatos de la página se interpreta como "Ningún grupo
+ debe ver esta página."
+
diff --git a/es/settings/authentication-personalization/sending-data.mdx b/es/settings/authentication-personalization/sending-data.mdx
new file mode 100644
index 00000000..bfe64131
--- /dev/null
+++ b/es/settings/authentication-personalization/sending-data.mdx
@@ -0,0 +1,41 @@
+---
+- title: Envío de datos
+- description: La forma de los datos de usuario que puedes usar para personalizar
+ tu documentación
+- icon: send
+---
+
+Dependiendo de tu método de Handshake, tu API responderá con un objeto JSON sin procesar o un JWT firmado. La forma de los datos es la misma para ambos:
+
+```tsx
+type User = {
+ expiresAt?: number;
+ groups?: string[];
+ content?: Record;
+ apiPlaygroundInputs?: {
+ header?: Record;
+ query?: Record;
+ cookie?: Record;
+ server?: Record;
+ };
+};
+```
+
+
+ El momento en el que esta información debe expirar, en **segundos desde la época**. Si el usuario carga la página y el tiempo actual es posterior a este valor, los datos almacenados se eliminarán.
+ Para Handshakes JWT: Esto *no* es lo mismo que la reclamación `exp` del JWT. La reclamación `exp` determina cuándo un JWT ya no debe considerarse válido, y debe establecerse lo más bajo posible. En este caso, probablemente se pueda establecer en 10 segundos o menos. El campo `expiresAt` determina cuándo los datos recuperados deben considerarse obsoletos, y puede ser desde un día hasta varias semanas.
+
+
+
+ Una lista de grupos a los que pertenece el usuario. Esto determinará qué páginas se deben mostrar a este usuario. Si alguno de estos grupos está listado en el campo `groups` de los metadatos de una página, esa página se mostrará.
+
+
+
+ Un conjunto de valores a los que se puede acceder desde el contenido MDX usando la variable `user`. Por ejemplo, si has proporcionado `{ firstName: 'Ronan' }` como tu campo de contenido, puedes usar lo siguiente en tu MDX: `Good morning, {user.firstName}!`
+
+
+
+ Valores específicos del usuario que se rellenarán previamente en el área de juegos de la API si se proporcionan. Por ejemplo, si cada uno de mis clientes hace solicitudes en un subdominio específico, puedo enviar `{ server: { subdomain: 'foo' } }` como mi campo `apiPlaygroundInputs`, y este valor se rellenará previamente en cualquier página de API con este valor `subdomain`.
+
+ Los campos`header`, `query`, y `cookie` solo se rellenarán previamente si son parte de tu [esquema de seguridad](https://swagger.io/docs/specification/authentication/). Crear un parámetro de encabezado estándar llamado `Authorization` no es suficiente para habilitar esta función. Para saber si un campo se rellenará previamente, navega a tu documentación existente y verifica si el campo está en la sección `Authorization` o `Server`.
+
diff --git a/es/settings/broken-links.mdx b/es/settings/broken-links.mdx
new file mode 100644
index 00000000..4eff59b8
--- /dev/null
+++ b/es/settings/broken-links.mdx
@@ -0,0 +1,43 @@
+---
+- title: Redirecciones y Enlaces Rotos
+- description: Herramientas para ayudar a prevenir enlaces inválidos
+- icon: link-2
+---
+
+Cuando cambias la ruta de un archivo en tu carpeta de documentos, también cambiará la ruta de la URL a esa página. Esto puede suceder al reestructurar tus documentos o cambiar el título de la barra lateral.
+
+## Enlaces rotos
+
+Detecta enlaces rotos con nuestra CLI. Simplemente [instala la CLI](/es/installation) y ejecuta el comando:
+
+```bash
+mint broken-links
+```
+
+La CLI identificará cualquier enlace relativo en tus documentos que no exista.
+
+## Redirecciones
+
+Configura redirecciones 301 añadiendo el campo `redirects` en tu archivo `docs.json`.
+
+```json
+"redirects": [
+ {
+ "source": "/source/path",
+ "destination": "/destination/path"
+ }
+]
+```
+
+Esto redirigirá permanentemente `/source/path` a `/destination/path` para que no pierdas el SEO previo de la página original.
+
+Para hacer coincidir una ruta comodín, usa `*` después de un parámetro. En este ejemplo, `/beta/:slug*` coincidirá con `/beta/introduction` y lo redirige a `/v2/introduction`.
+
+```json
+"redirects": [
+ {
+ "source": "/beta/:slug*",
+ "destination": "/v2/:slug*"
+ }
+]
+```
diff --git a/es/settings/ci.mdx b/es/settings/ci.mdx
new file mode 100644
index 00000000..121c4578
--- /dev/null
+++ b/es/settings/ci.mdx
@@ -0,0 +1,117 @@
+---
+- title: Comprobaciones de CI
+- description: Agregue comprobaciones de enlaces rotos, linting y gramática al
+ proceso de actualización
+- icon: circle-check
+---
+
+
+ Esta función solo está disponible para clientes con [planes de pago](https://mintlify.com/pricing?ref=docs-ci) y para GitHub. El soporte para otras plataformas estará disponible pronto. Por favor{" "}
+ contacte a ventas para más información.
+
+
+Utilice comprobaciones de CI para revisar sus documentos en busca de errores y recibir advertencias antes de implementar.
+
+## Instalación
+
+Para comenzar, necesitará haber seguido los pasos en la página de [GitHub](/es/settings/github).
+
+Para las aplicaciones de GitHub, puede elegir dar permisos solo a un repositorio individual.
+Recomendamos encarecidamente que lo haga, ya que solo necesitamos acceso al repositorio donde
+se alojan sus documentos.
+
+## Configuración
+
+Puede configurar las comprobaciones de CI habilitadas para una implementación en el panel de Mintlify navegando a la pestaña 'Add-Ons'. Allí puede habilitar o deshabilitar las comprobaciones que desea ejecutar.
+
+Al habilitar las comprobaciones, puede elegir ejecutarlas a nivel `Warning` o `Blocking`.
+
+
+ Una comprobación de nivel `Blocking` proporcionará un estado de fallo si no se pasa o se sugieren cambios.
+ + Una comprobación de nivel `Warning` nunca proporcionará un estado de fallo, incluso si hay un error o sugerencias. +
+
+## ¿Cuándo se ejecutan?
+
+Las comprobaciones de CI están configuradas para ejecutarse en commits a su rama de implementación configurada, o en pull requests contra esa rama.
+
+## Comprobaciones de CI disponibles
+
+### Enlaces rotos
+
+De manera similar a cómo funciona el [comprobador de enlaces de CLI](/es/settings/broken-links#broken-links) en su máquina local, verificaremos automáticamente sus documentos en busca de enlaces rotos.
+Para ver los resultados de esta comprobación, puede visitar la página de resultados de comprobación de GitHub para un commit específico.
+
+### Vale
+
+[Vale](https://vale.sh/) es un linter de prosa de código abierto basado en reglas que admite una variedad de tipos de documentos, incluidos Markdown y MDX.
+
+Mintlify admite la ejecución automática de Vale en una comprobación de CI y muestra los resultados como un estado de comprobación.
+
+#### Configuración
+
+Si tiene un archivo `.vale.ini` en la raíz del directorio de contenido para su implementación, usaremos automáticamente ese archivo de configuración.
+También usaremos automáticamente cualquier archivo de configuración en su `stylesPath` especificado.
+
+¿No tiene una configuración de Vale o no está seguro de por dónde empezar? No se preocupe, Mintlify tiene una configuración predeterminada que se utilizará automáticamente si no se proporciona una.
+
+
+ Tenga en cuenta que por razones de seguridad, no podemos admitir ninguna ruta absoluta `stylesPath`, o `stylesPath` que incluyan valores `..`. Utilice rutas relativas e incluya el `stylesPath` en su repositorio.
+
+
+#### Paquetes
+
+Vale admite una variedad de [paquetes](https://vale.sh/docs/keys/packages), que se pueden usar para verificar errores de ortografía y estilo.
+Cualquier paquete que incluya en su repositorio bajo el `stylesPath` correcto se instalará y utilizará automáticamente en su configuración de Vale.
+
+Para paquetes no incluidos en su repositorio, puede especificar cualquier paquete del [registro de paquetes de Vale](https://vale.sh/explorer), y se descargarán y utilizarán automáticamente en su configuración de Vale.
+
+
+ Tenga en cuenta que por razones de seguridad, no podemos admitir la descarga automática de paquetes que no sean del [registro de paquetes de Vale](https://vale.sh/explorer).
+
+
+#### Vale con MDX
+
+Vale no admite MDX de forma nativa, pero el autor de Vale ha proporcionado una [extensión personalizada](https://github.com/errata-ai/MDX) para admitirlo.
+
+Si prefiere no usar esta extensión, recomendamos las siguientes líneas en su `.vale.ini` file:
+
+```ini
+[formats]
+mdx = md
+
+[*.mdx]
+CommentDelimiters = {/*, */}
+
+TokenIgnores = (?sm)((?:import|export) .+?$), \
+(?)(?!`), \
+(<[A-Z]\w+>.+?<\/[A-Z]\w+>)
+
+BlockIgnores = (?sm)^(<\w+\n .*\s\/>)$, \
+(?sm)^({.+.*})
+```
+
+Para usar los comentarios en el documento de Vale, use comentarios de estilo MDX `{/* ... */}`.
+Si usa la configuración `CommentDelimiters = {/*, */}` [setting](https://vale.sh/docs/keys/commentdelimiters) en su configuración, Vale interpretará automáticamente estos comentarios mientras realiza el linting.
+Esto significa que puede usar fácilmente las funciones incorporadas de Vale, como omitir líneas o secciones.
+
+```mdx
+{/* vale off */}
+
+This text will be ignored by Vale
+
+{/* vale on */}
+```
+
+Si elige no usar `CommentDelimiters`, pero aún elige usar los comentarios de Vale, debe envolver cualquier comentario de Vale en comentarios MDX `{/* ... */}`. Por ejemplo:
+
+```mdx
+{/* */}
+
+This text will be ignored by Vale
+
+{/* */}
+```
+
+Tenga en cuenta que estas etiquetas de comentarios no son compatibles dentro de los componentes de Mintlify, pero se pueden usar en cualquier lugar en el nivel base de un documento.
diff --git a/es/settings/custom-domain.mdx b/es/settings/custom-domain.mdx
new file mode 100644
index 00000000..131e2c83
--- /dev/null
+++ b/es/settings/custom-domain.mdx
@@ -0,0 +1,45 @@
+---
+- title: Dominio Personalizado
+- description: Aloje su documentación en el dominio personalizado de su sitio web
+- icon: globe
+---
+
+Para configurar su documentación en un dominio personalizado, deberá establecer el dominio personalizado deseado en su configuración de Mintlify y configurar los ajustes de DNS en su proveedor de dominio.
+
+
+ ¿Busca configurar un subdirectorio personalizado como mintlify.com/docs? Encuentre instrucciones[aquí](/es/advanced/subpath/cloudflare).
+
+
+## Configuración del Panel
+
+1. Diríjase al[panel](https://dashboard.mintlify.com)
+2. Haga clic en "Configuración".
+3. Haga clic en "Dominio Personalizado".
+4. Ingrese su dominio personalizado deseado. Por ejemplo,`docs.mintlify.com`.
+
+
+ 
+
+ 
+
+
+## Verificación con Vercel
+
+Si Vercel resulta ser su proveedor de dominio, tendrá que agregar un registro de verificación`TXT`. Esta información se mostrará en su panel después de enviar su dominio personalizado, así como se le enviará por correo electrónico.
+
+## Configurando su DNS
+
+1. Proceda a la configuración de DNS de su dominio en el sitio web de su proveedor de dominio.
+2. Cree una nueva entrada DNS, ingresando los siguientes valores:
+
+```
+CNAME | docs | cname.vercel-dns.com.
+```
+
+
+ 
+
+
+Si está utilizando Cloudflare como su proveedor de DNS, necesitará tener habilitada la opción de seguridad "full strict" para la configuración de https.
+
+Por favor[contacte a soporte](mailto:sales@mintlify.com)si no ve el dominio personalizado configurado después de la configuración anterior.
diff --git a/es/settings/custom-scripts.mdx b/es/settings/custom-scripts.mdx
new file mode 100644
index 00000000..d51e8874
--- /dev/null
+++ b/es/settings/custom-scripts.mdx
@@ -0,0 +1,62 @@
+---
+- title: Scripts Personalizados
+- description: Personalice completamente su documentación con CSS y JS personalizados
+- icon: code
+---
+
+Agregue CSS y JS personalizados a su documentación para personalizar completamente el aspecto y la sensación.
+
+## CSS Personalizado
+
+Agregue cualquier número de archivos CSS a su repositorio y los nombres de clase definidos se aplicarán y estarán disponibles en todos sus archivos MDX.
+
+### Agregando style.css
+
+Por ejemplo, puede agregar el siguiente archivo`style.css`para personalizar el estilo de la barra de navegación y el pie de página.
+
+```css
+#navbar {
+ background: "#fffff2";
+ padding: 1rem;
+}
+
+footer {
+ margin-top: 2rem;
+}
+```
+
+### Usando Identificadores
+
+Mintlify tiene un conjunto de identificadores comunes para ayudarlo a etiquetar elementos importantes de la interfaz de usuario. Algunos, pero no todos, se enumeran en lo siguiente:
+
+`#topbar-cta-button` `#navbar` `#sidebar` `#content-area` `#table-of-contents`
+
+
+ Use la inspección de elementos para encontrar referencias a los elementos que desea personalizar.
+
+
+
+ Las referencias y el estilo de los elementos comunes están sujetos a cambios a medida que evoluciona la plataforma. Utilice la personalización con precaución.
+
+
+## JS Personalizado
+
+El JS personalizado le permite agregar código ejecutable personalizado globalmente. Es equivalente a agregar una etiqueta`
+
+ )
+}
+```
+
+El componente anterior puede entonces ser utilizado en tus archivos MDX de esta manera:
+
+```jsx
+
+
+
+
+
+
+
+
+
+ {colors.map((color, idx) => (
+
+ copyToClipboard(color)}
+ />
+ ))}
+
+
+
+
+ + Base color: hsl({hue}, {saturation}%, {lightness}%) +
+
+
+ + + Una comprobación de nivel `Warning` nunca proporcionará un estado de fallo, incluso si hay un error o sugerencias. +
+
+
+
+
+## Verificación con Vercel
+
+Si Vercel resulta ser su proveedor de dominio, tendrá que agregar un registro de verificación`TXT`. Esta información se mostrará en su panel después de enviar su dominio personalizado, así como se le enviará por correo electrónico.
+
+## Configurando su DNS
+
+1. Proceda a la configuración de DNS de su dominio en el sitio web de su proveedor de dominio.
+2. Cree una nueva entrada DNS, ingresando los siguientes valores:
+
+```
+CNAME | docs | cname.vercel-dns.com.
+```
+
+
+
+
+
+Si está utilizando Cloudflare como su proveedor de DNS, necesitará tener habilitada la opción de seguridad "full strict" para la configuración de https.
+
+Por favor[contacte a soporte](mailto:sales@mintlify.com)si no ve el dominio personalizado configurado después de la configuración anterior.
diff --git a/es/settings/custom-scripts.mdx b/es/settings/custom-scripts.mdx
new file mode 100644
index 00000000..d51e8874
--- /dev/null
+++ b/es/settings/custom-scripts.mdx
@@ -0,0 +1,62 @@
+---
+- title: Scripts Personalizados
+- description: Personalice completamente su documentación con CSS y JS personalizados
+- icon: code
+---
+
+Agregue CSS y JS personalizados a su documentación para personalizar completamente el aspecto y la sensación.
+
+## CSS Personalizado
+
+Agregue cualquier número de archivos CSS a su repositorio y los nombres de clase definidos se aplicarán y estarán disponibles en todos sus archivos MDX.
+
+### Agregando style.css
+
+Por ejemplo, puede agregar el siguiente archivo`style.css`para personalizar el estilo de la barra de navegación y el pie de página.
+
+```css
+#navbar {
+ background: "#fffff2";
+ padding: 1rem;
+}
+
+footer {
+ margin-top: 2rem;
+}
+```
+
+### Usando Identificadores
+
+Mintlify tiene un conjunto de identificadores comunes para ayudarlo a etiquetar elementos importantes de la interfaz de usuario. Algunos, pero no todos, se enumeran en lo siguiente:
+
+`#topbar-cta-button` `#navbar` `#sidebar` `#content-area` `#table-of-contents`
+
+