diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx index 9be6a9751..19ce0787a 100644 --- a/deploy/authentication-setup.mdx +++ b/deploy/authentication-setup.mdx @@ -18,6 +18,17 @@ You can configure full authentication for all pages or partial authentication wh Authentication is only available for sites hosted on a custom domain or Mintlify subdomain. For example, `docs.example.com` or `example.mintlify.site`. Authentication is **not supported** for sites with a [custom subpath](/deploy/docs-subpath). For example, `example.com/docs`. +## Choose an authentication method + +Use this comparison to pick the method that fits your use case. See [Feature availability](#feature-availability) for how each method interacts with other Mintlify features. + +| Method | Best for | Plan | Group-based access | API playground pre-fill | Personalization | +| :--- | :--- | :--- | :---: | :---: | :---: | +| Password | Simple shared access with no per-user tracking | Pro or Enterprise | No | No | No | +| Private authentication | Internal site for members of your Mintlify organization | All plans | No | No | No | +| OAuth 2.0 | Existing identity provider or SSO with per-user sessions | Enterprise | Yes | Yes | Yes | +| JWT | Custom auth backend or embedded content behind your own login | Enterprise | Yes | Yes | Yes | + ## Configure authentication diff --git a/deploy/export.mdx b/deploy/export.mdx index f9b828487..f8d8933ea 100644 --- a/deploy/export.mdx +++ b/deploy/export.mdx @@ -45,6 +45,14 @@ mint export --output customer-docs.zip --groups enterprise The export only includes pages listed in your navigation. [Hidden pages](/organize/hidden-pages) are not included in the archive. +### Security considerations + +The exported archive is a static, unauthenticated bundle. Anyone with the zip file can view every page it contains. + +- The `--groups` flag controls which group-restricted pages Mintlify includes in the archive at export time. It does not enforce authentication after export. +- Only share archives with recipients who are allowed to see the content they contain. +- Regenerate and redistribute the archive to publish new changes. Anyone running an older zip continues to see the older content. + ## What's in the zip The exported archive contains everything needed to view your docs offline: diff --git a/deploy/preview-deployments.mdx b/deploy/preview-deployments.mdx index 1d5c85854..d54ac2ac4 100644 --- a/deploy/preview-deployments.mdx +++ b/deploy/preview-deployments.mdx @@ -111,6 +111,8 @@ Preview deployments stay live as long as their source branch exists in your repo Preview URLs are unique per branch. If you delete a preview and later recreate one for the same branch, Mintlify may issue a new URL. +Mintlify generates preview URLs automatically. The subdomain and domain are not configurable, and custom domains only apply to your production deployment. + ## Troubleshooting preview deployments If your preview deployment fails, try these troubleshooting steps. diff --git a/es/api/introduction.mdx b/es/api/introduction.mdx index cc61989e3..f7339d44d 100644 --- a/es/api/introduction.mdx +++ b/es/api/introduction.mdx @@ -45,13 +45,12 @@ La REST (Representational State Transfer) API de Mintlify te permite interactuar ## URL base -Todos los endpoints de la API REST de Mintlify se sirven desde: +Todas las solicitudes a la API REST de Mintlify usan la siguiente URL base: ``` https://api.mintlify.com ``` -La página de referencia de cada endpoint indica la ruta completa y el método HTTP que se debe llamar.
## Autenticación diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx index 3ab82b45d..f8c427f42 100644 --- a/es/deploy/authentication-setup.mdx +++ b/es/deploy/authentication-setup.mdx @@ -18,6 +18,19 @@ Puedes configurar autenticación completa para todas las páginas o autenticaci La autenticación solo está disponible para sitios alojados en un dominio personalizado o subdominio de Mintlify. Por ejemplo, `docs.ejemplo.com` o `ejemplo.mintlify.site`. La autenticación **no es compatible** para sitios con una [subruta personalizada](/es/deploy/docs-subpath). Por ejemplo, `ejemplo.com/docs`. +
+ ## Elige un método de autenticación +
+ +Usa esta comparación para elegir el método que se adapte a tu caso de uso. Consulta [Disponibilidad de funciones](#feature-availability) para ver cómo interactúa cada método con otras funciones de Mintlify. + +| Método | Ideal para | Plan | Control de acceso basado en grupos | Autocompletado del área de pruebas de la API | Personalización | +| :--- | :--- | :--- | :---: | :---: | :---: | +| Contraseña | Acceso compartido sencillo sin seguimiento por usuario | Pro o Enterprise | — | — | — | +| Autenticación privada | Documentación interna para miembros de tu organización de Mintlify | Todos los planes | — | — | — | +| OAuth 2.0 | Proveedor de identidad existente o SSO con sesiones por usuario | Enterprise | ✓ | ✓ | ✓ | +| JWT | Backend de autenticación personalizado o documentación integrada detrás de tu propio inicio de sesión | Enterprise | ✓ | ✓ | ✓ | +
## Configurar la autenticación
diff --git a/es/deploy/export.mdx b/es/deploy/export.mdx index 03df3532d..86797e101 100644 --- a/es/deploy/export.mdx +++ b/es/deploy/export.mdx @@ -51,6 +51,16 @@ mint export --output customer-docs.zip --groups enterprise La exportación solo incluye las páginas listadas en tu navegación. Las [páginas ocultas](/es/organize/hidden-pages) no se incluyen en el archivo. +
+ ### Consideraciones de seguridad +
+ +El archivo exportado es un paquete estático y sin autenticación. Cualquier persona que tenga el archivo zip puede ver todas las páginas que contiene. + +- El flag `--groups` controla qué páginas restringidas por grupo incluye Mintlify en el archivo al momento de exportar. **No** aplica autenticación después de la exportación. +- Comparte los archivos únicamente con destinatarios autorizados a ver el contenido que contienen. +- Regenera y vuelve a distribuir el archivo para publicar nuevos cambios: los destinatarios que ejecuten un zip anterior seguirán viendo el contenido anterior. +
## Qué contiene el zip
diff --git a/es/deploy/preview-deployments.mdx b/es/deploy/preview-deployments.mdx index 866ac83cd..f045fca23 100644 --- a/es/deploy/preview-deployments.mdx +++ b/es/deploy/preview-deployments.mdx @@ -132,6 +132,8 @@ Las implementaciones de vista previa se mantienen activas mientras la rama de or Las URLs de vista previa son únicas por rama. Si eliminas una vista previa y más tarde vuelves a crear otra para la misma rama, Mintlify puede emitir una nueva URL. +Mintlify genera las URLs de vista previa automáticamente. El subdominio y el dominio no son configurables, y los dominios personalizados están reservados para tu implementación en producción. +
## Solución de problemas con las implementaciones de vista previa
diff --git a/fr/api/introduction.mdx b/fr/api/introduction.mdx index 25c5acbe5..dce160103 100644 --- a/fr/api/introduction.mdx +++ b/fr/api/introduction.mdx @@ -45,13 +45,12 @@ L'API REST (Representational State Transfer) de Mintlify vous permet d'interagir ## URL de base
-Tous les endpoints de l'API REST Mintlify sont accessibles depuis : +Toutes les requêtes vers l'API REST Mintlify utilisent l'URL de base suivante : ``` https://api.mintlify.com ``` -La page de référence de chaque endpoint indique le chemin complet et la méthode HTTP à appeler.
## Authentification diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx index 787b9e55d..ea6c1f87e 100644 --- a/fr/deploy/authentication-setup.mdx +++ b/fr/deploy/authentication-setup.mdx @@ -18,6 +18,19 @@ Vous pouvez configurer une authentification complète pour toutes les pages ou u L'authentification n'est disponible que pour les sites hébergés sur un domaine personnalisé ou un sous-domaine Mintlify. Par exemple, `docs.exemple.com` ou `exemple.mintlify.site`. L'authentification **n'est pas prise en charge** pour les sites avec un [sous-chemin personnalisé](/fr/deploy/docs-subpath). Par exemple, `exemple.com/docs`. +
+ ## Choisir une méthode d'authentification +
+ +Utilisez ce comparatif pour choisir la méthode adaptée à votre cas d'usage. Consultez [Disponibilité des fonctionnalités](#feature-availability) pour savoir comment chaque méthode interagit avec les autres fonctionnalités de Mintlify. + +| Méthode | Idéal pour | Offre | Accès basé sur les groupes | Pré-remplissage du bac à sable d'API | Personnalisation | +| :--- | :--- | :--- | :---: | :---: | :---: | +| Password | Accès partagé simple sans suivi par utilisateur | Pro ou Enterprise | — | — | — | +| Private authentication | Documentation interne pour les membres de votre organisation Mintlify | Toutes les offres | — | — | — | +| OAuth 2.0 | Fournisseur d'identité existant ou SSO avec sessions par utilisateur | Enterprise | ✓ | ✓ | ✓ | +| JWT | Backend d'authentification personnalisé ou documentation intégrée derrière votre propre connexion | Enterprise | ✓ | ✓ | ✓ | +
## Configurer l’authentification
diff --git a/fr/deploy/export.mdx b/fr/deploy/export.mdx index 62a47b826..fdf72d7c4 100644 --- a/fr/deploy/export.mdx +++ b/fr/deploy/export.mdx @@ -51,6 +51,16 @@ mint export --output customer-docs.zip --groups enterprise L'exportation inclut uniquement les pages listées dans votre navigation. Les [pages masquées](/fr/organize/hidden-pages) ne sont pas incluses dans l'archive. +
+ ### Considérations de sécurité +
+ +L'archive exportée est un bundle statique et non authentifié. Toute personne disposant du fichier zip peut consulter chaque page qu'il contient. + +- L'option `--groups` contrôle quelles pages à accès restreint par groupe Mintlify inclut dans l'archive au moment de l'exportation. Elle **n'applique pas** d'authentification après l'exportation. +- Ne partagez les archives qu'avec des destinataires autorisés à voir le contenu qu'elles contiennent. +- Régénérez et redistribuez l'archive pour publier de nouvelles modifications — les destinataires qui utilisent un zip plus ancien continueront à voir l'ancien contenu. +
## Contenu du zip
diff --git a/fr/deploy/preview-deployments.mdx b/fr/deploy/preview-deployments.mdx index 1e9ea987b..814b839dd 100644 --- a/fr/deploy/preview-deployments.mdx +++ b/fr/deploy/preview-deployments.mdx @@ -134,6 +134,8 @@ Les déploiements de prévisualisation restent disponibles tant que leur branche Les URL d'aperçu sont uniques par branche. Si vous supprimez un aperçu puis en recréez un pour la même branche, Mintlify peut émettre une nouvelle URL. +Mintlify génère automatiquement les URL d'aperçu. Le sous-domaine et le domaine ne sont pas configurables, et les domaines personnalisés sont réservés à votre déploiement en production. +
## Dépannage des déploiements de prévisualisation
diff --git a/zh/api/introduction.mdx b/zh/api/introduction.mdx index d71165ef1..cc1bd34b3 100644 --- a/zh/api/introduction.mdx +++ b/zh/api/introduction.mdx @@ -45,13 +45,12 @@ Mintlify 的 REST(Representational State Transfer)API 让你可以以编程 ## 基础 URL
-所有 Mintlify REST API 端点均由以下地址提供服务: +所有 Mintlify REST API 请求都使用以下基础 URL: ``` https://api.mintlify.com ``` -每个端点的参考页面都会列出要调用的完整路径和 HTTP 方法。
## 认证 diff --git a/zh/deploy/authentication-setup.mdx b/zh/deploy/authentication-setup.mdx index 0d3cfc69e..626bc5914 100644 --- a/zh/deploy/authentication-setup.mdx +++ b/zh/deploy/authentication-setup.mdx @@ -18,6 +18,19 @@ keywords: ['authentication', 'auth', 'OAuth', 'JWT', 'password', 'private'] 认证仅适用于托管在自定义域名或 Mintlify 子域名上的站点。例如,`docs.example.com` 或 `example.mintlify.site`。使用[自定义子路径](/zh/deploy/docs-subpath)的站点**不支持**认证。例如,`example.com/docs`。 +
+ ## 选择认证方式 +
+ +使用下方对比表来选择适合你使用场景的认证方式。请参见[功能可用性](#feature-availability) 了解每种方式如何与其他 Mintlify 功能协同工作。 + +| 方式 | 适用场景 | 方案 | 基于用户组的访问控制 | API 操作台预填 | 个性化 | +| :--- | :--- | :--- | :---: | :---: | :---: | +| Password | 简单的共享访问,无需按用户跟踪 | Pro 或 Enterprise | — | — | — | +| Private authentication | 面向 Mintlify 组织成员的内部文档 | 所有方案 | — | — | — | +| OAuth 2.0 | 已有身份提供方或 SSO,且需要按用户会话 | Enterprise | ✓ | ✓ | ✓ | +| JWT | 自定义认证后端或嵌入在自有登录后的文档 | Enterprise | ✓ | ✓ | ✓ | +
## 配置认证
diff --git a/zh/deploy/export.mdx b/zh/deploy/export.mdx index 84cc7ff35..0ab7b06ed 100644 --- a/zh/deploy/export.mdx +++ b/zh/deploy/export.mdx @@ -51,6 +51,16 @@ mint export --output customer-docs.zip --groups enterprise 导出仅包含导航中列出的页面。[隐藏页面](/zh/organize/hidden-pages) 不会包含在归档中。 +
+ ### 安全注意事项 +
+ +导出的归档是一个静态、无需认证的压缩包。任何持有该 zip 文件的人都可以查看其中包含的每个页面。 + +- `--groups` 标志用于控制在导出时 Mintlify 将哪些受用户组限制的页面包含到归档中。它**不会**在导出后强制执行认证。 +- 只与被允许查看归档内容的收件人分享归档文件。 +- 若要发布新的更改,请重新生成并重新分发归档—使用旧 zip 的收件人将继续看到旧的内容。 +
## zip 中的内容
diff --git a/zh/deploy/preview-deployments.mdx b/zh/deploy/preview-deployments.mdx index 41ccc6ed8..cb0363d54 100644 --- a/zh/deploy/preview-deployments.mdx +++ b/zh/deploy/preview-deployments.mdx @@ -134,6 +134,8 @@ keywords: ["preview URLs", "pull request previews", "branch previews", "staging 预览 URL 按 branch 唯一。如果你删除了某个预览,之后又为同一 branch 重新创建预览,Mintlify 可能会分配一个新的 URL。 +Mintlify 会自动生成预览 URL。子域名和域名不可配置,自定义域名仅保留用于你的生产部署。 +
## 预览部署故障排查