mintlify · mintlify-development · May 28, 2025
diff --git a/docs.json b/docs.json
diff --git a/es/advanced/dashboard/permissions.mdx b/es/advanced/dashboard/permissions.mdx
@@ -0,0 +1,16 @@
+---
+- title: Permisos de Editor
+- description: Permite que más miembros de tu equipo actualicen tus documentos
+---
+
+El miembro del equipo que creó tus documentos iniciales tendrá acceso de actualización a tus documentos, siempre y cuando haga push al repositorio de documentación con la misma cuenta de GitHub que se usó al registrarse en Mintlify.
+
+Si otro editor intenta actualizar los documentos mientras está en el plan gratuito, verás una advertencia en la verificación de tu commit de git.
+
+<Frame>
+  <img className="rounded-md" src="/images/editor-gate.png" />
+</Frame>
+
+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
@@ -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
@@ -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
+---
+
+<Info>
+  La funcionalidad SSO está disponible en nuestro[plan Enterprise](https://mintlify.com/pricing?ref=sso). Por favor{" "}
+  <a href="mailto:[email protected]">contacta con ventas</a>para más información.
+</Info>
+
+Usa inicio de sesión único en tu dashboard a través de SAML y OIDC. Si usas Okta o Google Workspace, tenemos documentación específica para configurar SSO, pero si usas otro proveedor, ¡por favor contáctanos!
+
+## Okta
+
+<Tabs>
+  <Tab title="SAML">
+    <Steps>
+      <Step title="Crea una aplicación">
+        Bajo`Applications`, haga clic para crear una nueva integración de aplicación usando SAML 2.0.
+      </Step>
+
+      <Step title="Configurar integración">
+        Ingrese lo siguiente:
+
+        * URL de inicio de sesión único (proporcionada por Mintlify)
+        * URI de audiencia (proporcionada por Mintlify)
+        * Formato de ID de nombre:`EmailAddress`
+        * Declaraciones de atributos:
+          | Nombre      | Formato de nombre | Valor            |
+          | ----------- | ----------------- | ---------------- |
+          | `firstName` | Basic             | `user.firstName` |
+          | `lastName`  | Basic             | `user.lastName`  |
+      </Step>
+
+      <Step title="Envíenos su información de IdP">
+        Una vez que la aplicación esté configurada, navegue a la pestaña de inicio de sesión y envíenos la URL de metadatos.
+        Habilitaremos la conexión desde nuestro lado usando esta información.
+      </Step>
+    </Steps>
+  </Tab>
+
+  <Tab title="OIDC">
+    <Steps>
+      <Step title="Crear una aplicación">
+        Bajo`Applications`, haga clic para crear una nueva integración de aplicación usando OIDC.
+        Debe elegir el tipo de aplicación`Web Application`.
+      </Step>
+
+      <Step title="Configurar integración">
+        Seleccione el tipo de concesión de código de autorización e ingrese la URI de redirección proporcionada por Mintlify.
+      </Step>
+
+      <Step title="Envíenos su información de IdP">
+        Una vez que la aplicación esté configurada, navegue a la pestaña General y localice el ID de cliente y el secreto del cliente.
+        Por favor, proporciónenos estos de manera segura, junto con la URL de su instancia de Okta (por ejemplo,`<your-tenant-name>.okta.com`). Puede enviar estos a través de un servicio como 1Password o SendSafely.
+      </Step>
+    </Steps>
+  </Tab>
+</Tabs>
+
+## Google Workspace
+
+<Tabs>
+  <Tab title="SAML">
+    <Steps>
+      <Step title="Crear una aplicación">
+        Bajo`Web and mobile apps`, seleccione`Add custom SAML app`del menú desplegable`Add app`.
+
+        <Frame>
+          ![](/images/gsuite-add-custom-saml-app.png)
+        </Frame>
+      </Step>
+
+      <Step title="Envíenos su información de IdP">
+        Copie la URL de SSO proporcionada, el ID de entidad y el certificado x509 y envíelos al equipo de Mintlify.
+
+        <Frame>
+          ![](/images/gsuite-saml-metadata.png)
+        </Frame>
+      </Step>
+
+      <Step title="Configurar integración">
+        En la página de detalles del proveedor de servicios, ingrese lo siguiente:
+
+        * URL de ACS (proporcionada por Mintlify)
+        * ID de entidad (proporcionado por Mintlify)
+        * Formato de ID de nombre:`EMAIL`
+        * ID de nombre:`Basic Information > Primary email`
+
+        <Frame>
+          ![](/images/gsuite-sp-details.png)
+        </Frame>
+
+        En la siguiente página, ingrese las siguientes declaraciones de atributos:
+
+        | Atributo del Directorio de Google | Atributo de la aplicación |
+        | --------------------------------- | ------------------------- |
+        | `First name`                      | `firstName`               |
+        | `Last name`                       | `lastName`                |
+
+        Una vez que este paso esté completo y los usuarios estén asignados a la aplicación, informe a nuestro equipo y habilitaremos el SSO para su cuenta.
+      </Step>
+    </Steps>
+  </Tab>
+</Tabs>
diff --git a/es/advanced/subpath/cloudflare.mdx b/es/advanced/subpath/cloudflare.mdx
@@ -0,0 +1,72 @@
+---
+- title: Cloudflare
+- description: Aloja documentación en una subruta /docs usando Cloudflare Workers
+---
+
+## Crear Worker de Cloudflare
+
+Navega a la`Workers & Pages > Create application > Create worker`. Se te presentará la siguiente pantalla donde puedes crear un nuevo worker de Cloudflare.
+
+<Frame>
+  <img alt="Create a Cloudflare worker" src="/images/cloudflare/worker.png" />
+</Frame>
+
+<Warning>
+  Ten en cuenta: Si tu proveedor de DNS es Cloudflare, no debes usar el proxy para el registro CNAME
+</Warning>
+
+### Agregar dominio personalizado
+
+Una vez que se ha creado el worker, haz clic en`Configure worker`. Navega al worker`Settings > Triggers`. Haz clic en`Add Custom Domain` para agregar tu dominio deseado a la lista - recomendamos que agregues tanto la versión con como sin`www.`antepuesto al dominio.
+
+<Frame>
+  <img alt="Cloudflare worker custom domain" src="/images/cloudflare/custom-domain.png" />
+</Frame>
+
+Si tienes problemas para configurar un subdirectorio personalizado,[contacta a nuestro equipo de soporte](mailto:[email protected]) 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.
+
+<Frame>
+  <img alt="Cloudflare edit code" src="/images/cloudflare/edit-code.png" />
+</Frame>
+
+<Tip>
+  Edita`DOCS_URL` reemplazando`[SUBDOMAIN]` con tu subdominio único y`CUSTOM_URL` con la URL base de tu sitio web.
+</Tip>
+
+```javascript
+addEventListener("fetch", (event) => {
+  event.respondWith(handleRequest(event.request));
+});
+
+async function handleRequest(request) {
+  try {
+    const urlObject = new URL(request.url);
+    // If the request is to the docs subdirectory
+    if (/^\/docs/.test(urlObject.pathname)) {
+      // Then Proxy to Mintlify
+      const DOCS_URL = "[SUBDOMAIN].mintlify.dev";
+      const CUSTOM_URL = "[YOUR_DOMAIN]";
+
+      let url = new URL(request.url);
+      url.hostname = DOCS_URL;
+
+      let proxyRequest = new Request(url, request);
+
+      proxyRequest.headers.set("Host", DOCS_URL);
+      proxyRequest.headers.set("X-Forwarded-Host", CUSTOM_URL);
+      proxyRequest.headers.set("X-Forwarded-Proto", "https");
+
+      return await fetch(proxyRequest);
+    }
+  } catch (error) {
+    // if no action found, play the regular request
+    return await fetch(request);
+  }
+}
+```
+
+Haz clic en`Deploy` y espera a que los cambios se propaguen (puede tomar hasta unas pocas horas).
diff --git a/es/advanced/subpath/route53-cloudfront.mdx b/es/advanced/subpath/route53-cloudfront.mdx
@@ -0,0 +1,137 @@
+---
+- title: AWS Route 53 y Cloudfront
+- sidebarTitle: AWS
+- description: Aloja la documentación en un subdirectorio /docs usando servicios de AWS
+---
+
+## Crear Distribución de Cloudfront
+
+Navega a [Cloudfront](https://aws.amazon.com/cloudfront) dentro de la consola de AWS y haz clic en `Create distribution`
+
+<Frame>
+  ![Cloudfront Create Distribution](/images/cloudfront/create-distribution.png)
+</Frame>
+
+Para el dominio de Origen, ingresa `[SUBDOMAIN].mintlify.dev` donde `[SUBDOMAIN]` es el subdominio único del proyecto. Haz clic en `Use: [SUBDOMAIN].mintlify.dev`
+
+<Frame>![Cloudfront Origin name](/images/cloudfront/origin-name.png)</Frame>
+
+Para **Cache key and origin requests**, selecciona `Caching Optimized`.
+
+<Frame>
+  ![Cloudfront Caching policy](/images/cloudfront/caching-policy.png)
+</Frame>
+
+Y para **Web Application Firewall (WAF)**, habilita las protecciones de seguridad
+
+<Frame>
+  ![Cloudfront Caching
+  policy](/images/cloudfront/enable-security-protections.png)
+</Frame>
+
+El resto de las configuraciones deben ser las predeterminadas. Haz clic en `Create distribution`.
+
+## Añadir Origen Predeterminado
+
+Después de crear la distribución, navega a la pestaña `Origins`.
+
+<Frame>![Cloudfront Origins](/images/cloudfront/origins.png)</Frame>
+
+Queremos encontrar una URL de staging que refleje dónde está el dominio principal (example.com). Esto varía mucho dependiendo de cómo esté alojada tu página de inicio.
+
+<Info>
+  Por ejemplo, si tu página de inicio está alojada en Webflow, puedes usar la URL de staging de Webflow. Se vería como `.webflow.io`.
+
+  Si usas Vercel, puedes usar el dominio `.vercel.app` disponible para cada proyecto.
+</Info>
+
+<Note>
+  Si no estás seguro de cómo obtener una URL de staging para tu página de inicio, [contact
+  support](mailto:[email protected]) y estaremos encantados de ayudarte
+</Note>
+
+Una vez que tengas la URL de staging, la nuestra por ejemplo es [mintlify-landing-page.vercel.app](https://mintlify-landing-page.vercel.app), crea un nuevo Origen y añádelo como el **Origin domain**.
+
+<Frame>
+  ![Cloudfront Default Origins](/images/cloudfront/default-origin.png)
+</Frame>
+
+En este punto, deberías tener dos Orígenes - uno con `[SUBDOMAIN].mintlify.app` y otro con la URL de staging.
+
+## Configurar Comportamientos
+
+Los Comportamientos en Cloudfront permiten controlar la lógica de subrutas. A alto nivel, buscamos crear la siguiente lógica.
+
+* **Si un usuario llega a /docs**, ir a `[SUBDOMAIN].mintlify.dev`
+* **Si un usuario llega a cualquier otra página**, ir a la página de inicio actual
+
+Vamos a crear tres comportamientos haciendo clic en el botón `Create behavior`.
+
+### `/docs/*`
+
+El primer comportamiento debe tener un **Path pattern** de `/docs/*` con **Origin and origin groups** apuntando al `.mintlify.dev` URL (en nuestro caso `acme.mintlify.dev`)
+
+<Frame>![Cloudfront Behavior 1](/images/cloudfront/behavior-1.png)</Frame>
+
+Para **Cache policy**, selecciona `CachingOptimized` y crea el comportamiento.
+
+### `/docs`
+
+El segundo comportamiento debe ser igual al primero pero con un **Path pattern** de `/docs` y **Origin and origin groups** apuntando al mismo `.mintlify.dev` URL.
+
+<Frame>![Cloudfront Behavior 2](/images/cloudfront/behavior-2.png)</Frame>
+
+### `Default (*)`
+
+Por último, vamos a editar el comportamiento `Default (*)`.
+
+<Frame>
+  ![Cloudfront Behavior Default 1](/images/cloudfront/default-behavior-1.png)
+</Frame>
+
+Vamos a cambiar el **Origin and origin groups** del comportamiento predeterminado a la URL de staging (en nuestro caso `mintlify-landing-page.vercel.app`).
+
+<Frame>
+  ![Cloudfront Behavior Default 2](/images/cloudfront/default-behavior-2.png)
+</Frame>
+
+Haz clic en `Save changes`.
+
+## Preview Distribution
+
+Ahora puedes probar si tu distribución está configurada correctamente yendo a la pestaña `General` y visitando la URL del **Distribution domain name**.
+
+<Frame>
+  ![Cloudfront Preview
+  distribution](/images/cloudfront/preview-distribution.png)
+</Frame>
+
+Todas las páginas deberían dirigirse a tu página principal, pero si añades `/docs` a la URL, deberías ver que se dirige a la instancia de documentación de Mintlify.
+
+## Conectándolo con Route53
+
+Ahora, vamos a llevar la funcionalidad de la distribución de Cloudfront a tu dominio principal.
+
+<Note>
+  Para esta sección, también puedes consultar la guía oficial de AWS sobre [Configurar Amazon Route 53 para dirigir el tráfico a una distribución de CloudFront](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-cloudfront-distribution.html#routing-to-cloudfront-distribution-config)
+</Note>
+
+Navega a [Route53](https://aws.amazon.com/route53) dentro de la consola de AWS, y haz clic en el `Hosted zone` de tu dominio principal. Haz clic en `Create record`
+
+<Frame>
+  ![Route 53 create record](/images/cloudfront/route53-create-record.png)
+</Frame>
+
+Toggle `Alias` y luego **Route traffic to** la opción `Alias to CloudFront distribution`.
+
+<Frame>
+  ![Route 53 create record alias](/images/cloudfront/create-record-alias.png)
+</Frame>
+
+Haz clic en `Create records`.
+
+<Note>
+  Es posible que necesites eliminar el registro A existente si hay uno actualmente.
+</Note>
+
+¡Y voilà! Deberías poder tener tu documentación servida en `/docs` para tu dominio principal.
diff --git a/es/advanced/subpath/vercel.mdx b/es/advanced/subpath/vercel.mdx
@@ -0,0 +1,30 @@
+---
+- title: Vercel
+- description: Alojar documentación en una subruta /docs usando Vercel
+---
+
+## Configuración de vercel.json
+
+Para alojar su documentación en una subruta personalizada usando Vercel, necesita agregar la
+siguiente configuración a su `vercel.json` archivo.
+
+```json
+{
+  "rewrites": [
+    {
+      "source": "/docs",
+      "destination": "https://[subdomain].mintlify.dev/docs"
+    },
+    {
+      "source": "/docs/:match*",
+      "destination": "https://[subdomain].mintlify.dev/docs/:match*"
+    }
+  ]
+}
+```
+
+<Note>
+  Para más información, también puede consultar la guía oficial de Vercel sobre
+  reescrituras: [Project Configuration:
+  Rewrites](https://vercel.com/docs/projects/project-configuration#rewrites)
+</Note>