Catalogue de connecteurs d'applications
Vingt modèles d'intégration SAML 2.0 et OIDC prêts à l'emploi pour les applications auto-hébergées les plus répandues. Le catalogue est intégré dans l'assistant d'enregistrement d'applications — sélectionnez un connecteur, renseignez le domaine de déploiement, vérifiez les points de terminaison SAML pré-remplis et enregistrez.
Vue d'ensemble
Le catalogue de connecteurs supprime la nécessité de configurer manuellement les métadonnées des fournisseurs de services pour les applications courantes. Chaque entrée du catalogue est un modèle paramétré — il suffit de renseigner le domaine de votre déploiement, et Hawiyati génère la configuration SAML ou OIDC correcte et l'enregistre dans le registre SP en une seule opération.
Les modèles sont chargés depuis des fichiers YAML intégrés à hawiyati-admin au démarrage. Ils sont stockés dans la table hawiyati_config.connector_templates et exposés via l'assistant d'enregistrement d'applications de la console d'administration et l'API REST /api/v1/catalog.
Le catalogue est intégré directement dans l'assistant d'enregistrement d'applications. Lorsque vous cliquez sur Enregistrer une application dans la page Applications, vous choisissez entre parcourir le catalogue (les modèles pré-remplissent tous les points de terminaison) ou configurer une intégration SAML 2.0 ou OIDC personnalisée depuis zéro. Les deux chemins produisent une entrée standard dans le registre SP.
Aucun compte cloud ni portail fournisseur n'est requis. Déployez Grafana, GitLab, Vault et les autres outils sur votre propre infrastructure, puis pointez le connecteur vers le domaine de votre instance.
Connecteurs disponibles
Le catalogue comprend 20 connecteurs répartis en six catégories.
Supervision
| Connecteur | Protocole | Remarques |
|---|---|---|
| Grafana | SAML 2.0 | Plateforme de tableaux de bord et d'alertes. SSO SAML via le proxy d'authentification intégré. |
| Kibana | SAML 2.0 | Visualisation Elasticsearch. Nécessite le plugin de sécurité Elastic. |
| Prometheus | OIDC | Serveur de métriques. Modèle proxy OIDC via sidecar oauth2-proxy. |
DevOps
| Connecteur | Protocole | Remarques |
|---|---|---|
| GitLab CE/EE | SAML 2.0 | Hébergement Git et CI/CD. Connexion SAML sous Administration > Paramètres > SSO. |
| Jenkins | SAML 2.0 | Serveur d'automatisation de builds. Nécessite le plugin SAML. |
| SonarQube | SAML 2.0 | Plateforme de qualité de code. SAML configuré dans sonar.properties. |
| Nexus Repository | SAML 2.0 | Dépôt d'artefacts. SAML IDP-initiated supporté depuis la v3.38. |
| Gitea | OIDC | Hébergement Git léger. Application OAuth OIDC sous Administration du site. |
Productivité et collaboration
| Connecteur | Protocole | Remarques |
|---|---|---|
| Nextcloud | SAML 2.0 | Partage de fichiers et groupware. SAML via l'application SSO & SAML. |
| Mattermost | SAML 2.0 | Messagerie d'équipe. SAML sous Console système > Authentification. |
| Rocket.Chat | SAML 2.0 | Messagerie open source. SAML sous Administration > SAML. |
| Seafile | SAML 2.0 | Collaboration documentaire. SAML nécessite des modifications dans seahub_settings.py. |
| Jitsi Meet | SAML 2.0 | Visioconférence. SAML via le pont Prosody LDAP/SAML. |
Infrastructure
| Connecteur | Protocole | Remarques |
|---|---|---|
| Rancher | SAML 2.0 | Interface de gestion Kubernetes. SAML sous Utilisateurs et authentification > Fournisseur d'authentification. |
| Kubernetes Dashboard | OIDC | Interface web K8s. Proxy OIDC ou indicateurs OIDC du kube-apiserver. |
| Portainer | OIDC | Gestion de conteneurs. OAuth/OIDC sous Paramètres > Authentification. |
Sécurité et secrets
| Connecteur | Protocole | Remarques |
|---|---|---|
| HashiCorp Vault | OIDC | Gestion des secrets. Méthode d'authentification OIDC avec vault auth enable oidc. |
Métier et documentation
| Connecteur | Protocole | Remarques |
|---|---|---|
| Odoo | SAML 2.0 | Plateforme ERP. SAML via le module social-auth-saml. |
| Redmine | SAML 2.0 | Gestion de projet. SAML via le plugin omniauth-saml. |
| Zammad | SAML 2.0 | Helpdesk. SAML sous Administration > Sécurité > Applications tierces. |
| BookStack | SAML 2.0 | Plateforme wiki. SAML sous Paramètres > Authentification. |
Enregistrer une application depuis le catalogue
Le catalogue est accessible via l'assistant d'enregistrement d'applications dans la console d'administration. Il n'existe pas de page « Catalogue d'apps » distincte dans la barre latérale — les modèles du catalogue constituent un chemin au sein du même assistant utilisé pour les enregistrements SAML et OIDC personnalisés.
Déroulement de l'assistant
- Ouvrir l'assistant. Naviguez vers Identité et accès > Applications et cliquez sur Enregistrer une application. L'assistant s'ouvre à l'étape Choix.
- Parcourir le catalogue d'applications. Cliquez sur la carte Parcourir le catalogue d'apps. L'assistant avance à l'étape Sélectionner une application, affichant tous les connecteurs sous forme de tuiles filtrables par nom et catégorie.
- Sélectionner le connecteur. Cliquez sur la tuile de l'application souhaitée (ex. : Grafana, Odoo). Une coche verte marque la sélection et le bouton Suivant s'active.
- Général — nom et domaine. Saisissez le nom d'affichage de l'application et votre domaine de déploiement (hôte uniquement, sans schéma ni barre oblique finale). L'assistant affiche un aperçu de l'identifiant d'entité qui sera généré à partir de votre domaine.
- Connexion — vérifier les points de terminaison SP. L'identifiant d'entité, l'URL ACS, l'URL SLO, le format NameID et les options de signature sont pré-remplis depuis le modèle avec votre domaine substitué. Modifiez les champs qui diffèrent de votre déploiement.
- Déclarations d'attributs. Les attributs utilisateur à inclure dans les assertions SAML sont pré-remplis depuis le modèle. Ajoutez, supprimez ou modifiez les correspondances selon vos besoins.
- Accès et politique. Affectez optionnellement une politique d'authentification, limitez les méthodes d'authentification acceptées, activez le provisionnement JIT et exigez une vérification KYC pour cette application.
- Révision et enregistrement. Vérifiez tous les paramètres. Cliquez sur Enregistrer l'application. Hawiyati crée l'entrée dans le registre SP et affiche le panneau Instructions de configuration avec l'URL des métadonnées IdP et l'URL SSO à coller dans la configuration SAML de l'application.
Saisissez uniquement l'hôte et le port optionnel — par exemple grafana.example.org ou gitlab.example.org:8443. N'incluez pas https:// ni de barre oblique finale. Le modèle de connecteur préfixe automatiquement le schéma et construit l'URL complète du point de terminaison.
Le panneau Instructions de configuration affiche l'URL des métadonnées IdP de Hawiyati (https://<hôte-idp>/saml/metadata). Collez cette URL dans la configuration du fournisseur d'identité SAML de votre application. Les applications qui prennent en charge l'import automatique de métadonnées (Grafana, GitLab, Nextcloud) téléchargeront automatiquement le certificat et l'URL SSO.
Paramètres du modèle
Chaque modèle de connecteur utilise deux paramètres standard. Certains connecteurs en ajoutent un troisième.
| Paramètre | Obligatoire | Description |
|---|---|---|
domain | Oui | Hôte (et port optionnel) où l'application est déployée. Exemple : grafana.example.org. |
displayName | Oui | Nom lisible affiché dans le registre SP et le sélecteur de connexion. Par défaut : nom du connecteur. |
instanceId | OIDC uniquement | Suffixe ajouté à l'identifiant client OIDC généré. Permet la coexistence de plusieurs instances d'une même application. Par défaut : slug du connecteur. |
API REST
Le catalogue est également accessible par programme via l'API d'administration. Tous les endpoints nécessitent une session administrateur authentifiée.
| Méthode | Chemin | Description |
|---|---|---|
GET | /api/v1/catalog | Lister tous les modèles de connecteurs. |
GET | /api/v1/catalog/{slug} | Obtenir un modèle de connecteur par slug. |
POST | /api/v1/catalog/{slug}/enable | Activer un connecteur. Corps : {"domain":"…","displayName":"…"}. Retourne 201 Created en cas de succès. |
Ajouter des connecteurs personnalisés
Le catalogue est extensible. Pour ajouter un connecteur pour une application non présente dans la liste intégrée :
- Créez un fichier YAML dans
hawiyati-admin/src/main/resources/connectors/en suivant le schéma d'un fichier de connecteur existant. Utilisez{{domain}}et{{displayName}}comme espaces réservés. - Redémarrez
hawiyati-admin. Le runnerConnectorCatalogSeederdétecte le nouveau fichier au démarrage et l'insère en base de données si le slug n'existe pas déjà. - Le connecteur apparaît immédiatement dans le catalogue de la console d'administration et dans l'API REST.