# Portails développeur personnalisés (/fr/deploy/custom-portal)

<!-- agent-signals: reading_time_min: 6 · est_tokens: 2948 · updated: 2026-07-30 -->

<Info>
  Les portails personnalisés nécessitent un [plan Enterprise](https://mintlify.com/pricing?ref=custom-portal) et un [déploiement auto-hébergé](/fr/deploy/self-host). Contactez votre équipe de compte pour en cadrer un.
</Info>

Pour certaines plateformes, la documentation n'est qu'une des surfaces d'un produit plus vaste — une place de marché d'API, un portail partenaire ou une expérience développeur intégrant la connexion, la gestion des identifiants et le support. Mintlify prend en charge ces cas d'usage en concevant, développant et maintenant une couche de présentation personnalisée qui remplace le front-end de votre portail existant, tandis que votre équipe rédige le contenu via l'éditeur Mintlify ou un workflow adossé à Git.

Le portail s'intègre à vos API, à votre passerelle et à vos systèmes en aval existants, qui restent détenus et exploités par votre équipe.

<div id="features">
  ## Fonctionnalités [#fonctionnalités]
</div>

| Fonctionnalité                       | Ce qui est livré                                                                                                                                                  | Assuré par                                          |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Couche de présentation personnalisée | Une application front-end complète dans votre design system, déployée à l'intérieur de votre environnement                                                        | Mintlify, aux côtés de la plateforme auto-hébergée  |
| Pages produits et catalogue          | Surfaces de place de marché, de découverte de produits et de documentation                                                                                        | Contenu maintenu sur Mintlify                       |
| Connexion                            | Sessions authentifiées sur l'ensemble du portail                                                                                                                  | Votre fournisseur d'identité                        |
| Applications et identifiants         | Enregistrement d'applications et gestion des identifiants                                                                                                         | Vos API backend                                     |
| Abonnements                          | Abonnements aux produits et aux plans                                                                                                                             | Vos API backend                                     |
| Profils et notifications             | Profils utilisateur et centres de notifications                                                                                                                   | Vos API backend                                     |
| Support                              | Création et suivi de tickets de support                                                                                                                           | Vos API backend                                     |
| Recherche                            | Recherche tenant compte de la connexion et limitée à ce à quoi l'utilisateur a accès                                                                              | Plateforme Mintlify                                 |
| Contenu personnalisé                 | Filtrage par droits et par groupes appliqué côté serveur au moment du rendu, afin que les utilisateurs ne voient que les produits et pages auxquels ils ont accès | Plateforme Mintlify et votre fournisseur d'identité |
| Versions récurrentes                 | Versions numérotées avec des guides de mise à niveau, selon le même modèle opérationnel que tout [déploiement auto-hébergé](/fr/deploy/self-host#updates)         | Mintlify                                            |

<div id="authoring-flow">
  ## Workflow de rédaction [#workflow-de-rédaction]
</div>

Le front-end personnalisé ne change pas la manière dont le contenu est rédigé. Entretenez le contenu avec l'éditeur ou un workflow local adossé à Git. Chaque modification passe par le processus de revue de votre dépôt avec une piste d'audit complète, et la publication déclenche des builds qui mettent à jour le portail automatiquement. Les changements de contenu ne nécessitent pas de déploiement du front-end.

<div id="architecture">
  ## Architecture [#architecture]
</div>

La couche de présentation personnalisée s'intègre à la plateforme Mintlify auto-hébergée pour le contenu, la recherche et la personnalisation ; à votre passerelle API pour les applications, les abonnements et le support ; et à votre fournisseur d'identité pour l'authentification.

```mermaid
flowchart TD
  U[Users] --> CDN[CDN and WAF]
  CDN --> PORTAL[Custom presentation layer]
  PORTAL --> PLAT[Mintlify platform<br/>content, search, personalization]
  PORTAL --> GW[Your API gateway]
  GW --> BE[Your backend services<br/>applications, subscriptions, support]
  PORTAL --> IDP[Your identity provider]
  W[Writers] --> ED[Editor and Git workflow]
  ED --> PLAT
```

La couche de présentation personnalisée et la plateforme Mintlify s'exécutent à l'intérieur de votre périmètre réseau, en utilisant votre cluster, vos magasins de données et votre stack d'observabilité, sans sortie vers des tiers. Vos systèmes de référence en aval restent inchangés ; le portail y accède via vos API existantes.

<div id="how-the-engagement-runs">
  ## Comment se déroule l'engagement [#comment-se-déroule-lengagement]
</div>

<Steps>
  <Step title="Cadrage et conception">
    Votre équipe de compte cartographie les surfaces du portail, votre design system et les API backend que le portail consomme, puis convient d'un contrat d'intégration avec votre équipe plateforme.
  </Step>

  <Step title="Les surfaces publiques d'abord">
    L'engagement implémente typiquement votre design system et les surfaces de contenu publiques en premier, afin que vous puissiez valider l'expérience par rapport à votre portail existant avant la bascule.
  </Step>

  <Step title="Surfaces authentifiées">
    La connexion, la gestion des identifiants, les abonnements et les autres expériences authentifiées suivent, intégrées à votre fournisseur d'identité et à vos API backend.
  </Step>

  <Step title="Recherche, personnalisation et IA">
    La recherche tenant compte de la connexion et la personnalisation côté serveur complètent l'expérience de base. Les fonctionnalités d'IA optionnelles restent désactivées jusqu'à ce que votre équipe de sécurité ou de gouvernance de l'IA les approuve.
  </Step>
</Steps>

Tout au long, votre équipe examine les versions dans des environnements hors production et contrôle chaque bascule.

<div id="next-steps">
  ## Étapes suivantes [#étapes-suivantes]
</div>

<Columns cols="2">
  <Card title="Parlez à votre équipe de compte" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M7.5 12H13.5M7.5 8H10.5&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M8.5 20C9.55038 20.8697 10.8145 21.4238 12.2635 21.5188C13.4052 21.5937 14.5971 21.5936 15.7365 21.5188C16.1288 21.4931 16.5565 21.4007 16.9248 21.251C17.3345 21.0845 17.5395 21.0012 17.6437 21.0138C17.7478 21.0264 17.8989 21.1364 18.2011 21.3563C18.7339 21.744 19.4051 22.0225 20.4005 21.9986C20.9038 21.9865 21.1555 21.9804 21.2681 21.7909C21.3808 21.6013 21.2405 21.3389 20.9598 20.8141C20.5706 20.0862 20.324 19.2529 20.6977 18.5852C21.3413 17.6315 21.8879 16.5021 21.9678 15.2823C22.0107 14.6269 22.0107 13.9481 21.9678 13.2927C21.9146 12.4799 21.7173 11.7073 21.4012 11&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M12.345 17.4868C15.9006 17.2526 18.7328 14.4069 18.9658 10.8344C19.0114 10.1353 19.0114 9.41131 18.9658 8.71219C18.7328 5.13969 15.9006 2.29401 12.345 2.05985C11.132 1.97997 9.86553 1.98013 8.65499 2.05985C5.09943 2.29401 2.26725 5.13969 2.0342 8.71219C1.9886 9.41131 1.9886 10.1353 2.0342 10.8344C2.11908 12.1356 2.69992 13.3403 3.38372 14.3576C3.78076 15.0697 3.51873 15.9586 3.10518 16.735C2.807 17.2948 2.65791 17.5747 2.77762 17.7769C2.89732 17.9791 3.16472 17.9856 3.69951 17.9985C4.75712 18.024 5.47028 17.7269 6.03638 17.3134C6.35744 17.0788 6.51798 16.9615 6.62862 16.9481C6.73926 16.9346 6.957 17.0234 7.39241 17.2011C7.78374 17.3608 8.23812 17.4593 8.65499 17.4868C9.86553 17.5665 11.132 17.5666 12.345 17.4868Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="https://www.mintlify.com/enterprise">
    Cadrez un engagement de portail personnalisé et planifiez votre lancement.
  </Card>

  <Card title="Auto-hébergement" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M19 4H5C4.06812 4 3.60218 4 3.23463 4.15224C2.74458 4.35523 2.35523 4.74458 2.15224 5.23463C2 5.60218 2 6.06812 2 7C2 7.93188 2 8.39782 2.15224 8.76537C2.35523 9.25542 2.74458 9.64477 3.23463 9.84776C3.60218 10 4.06812 10 5 10H19C19.9319 10 20.3978 10 20.7654 9.84776C21.2554 9.64477 21.6448 9.25542 21.8478 8.76537C22 8.39782 22 7.93188 22 7C22 6.06812 22 5.60218 21.8478 5.23463C21.6448 4.74458 21.2554 4.35523 20.7654 4.15224C20.3978 4 19.9319 4 19 4Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M19 14H5C4.06812 14 3.60218 14 3.23463 14.1522C2.74458 14.3552 2.35523 14.7446 2.15224 15.2346C2 15.6022 2 16.0681 2 17C2 17.9319 2 18.3978 2.15224 18.7654C2.35523 19.2554 2.74458 19.6448 3.23463 19.8478C3.60218 20 4.06812 20 5 20H19C19.9319 20 20.3978 20 20.7654 19.8478C21.2554 19.6448 21.6448 19.2554 21.8478 18.7654C22 18.3978 22 17.9319 22 17C22 16.0681 22 15.6022 21.8478 15.2346C21.6448 14.7446 21.2554 14.3552 20.7654 14.1522C20.3978 14 19.9319 14 19 14Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M6.125 7H6M6.25 7C6.25 7.13807 6.13807 7.25 6 7.25C5.86193 7.25 5.75 7.13807 5.75 7C5.75 6.86193 5.86193 6.75 6 6.75C6.13807 6.75 6.25 6.86193 6.25 7Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M10.125 7H10M10.25 7C10.25 7.13807 10.1381 7.25 10 7.25C9.86193 7.25 9.75 7.13807 9.75 7C9.75 6.86193 9.86193 6.75 10 6.75C10.1381 6.75 10.25 6.86193 10.25 7Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M6.125 17H6M6.25 17C6.25 17.1381 6.13807 17.25 6 17.25C5.86193 17.25 5.75 17.1381 5.75 17C5.75 16.8619 5.86193 16.75 6 16.75C6.13807 16.75 6.25 16.8619 6.25 17Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M10.125 17H10M10.25 17C10.25 17.1381 10.1381 17.25 10 17.25C9.86193 17.25 9.75 17.1381 9.75 17C9.75 16.8619 9.86193 16.75 10 16.75C10.1381 16.75 10.25 16.8619 10.25 17Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/fr/deploy/self-host">
    La base de déploiement sur laquelle s'exécute un portail personnalisé.
  </Card>
</Columns>
