H· Hawiyati Documentation
Intégration applicative

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.

Les 20 connecteurs sont conçus pour des applications auto-hébergées.

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

ConnecteurProtocoleRemarques
GrafanaSAML 2.0Plateforme de tableaux de bord et d'alertes. SSO SAML via le proxy d'authentification intégré.
KibanaSAML 2.0Visualisation Elasticsearch. Nécessite le plugin de sécurité Elastic.
PrometheusOIDCServeur de métriques. Modèle proxy OIDC via sidecar oauth2-proxy.

DevOps

ConnecteurProtocoleRemarques
GitLab CE/EESAML 2.0Hébergement Git et CI/CD. Connexion SAML sous Administration > Paramètres > SSO.
JenkinsSAML 2.0Serveur d'automatisation de builds. Nécessite le plugin SAML.
SonarQubeSAML 2.0Plateforme de qualité de code. SAML configuré dans sonar.properties.
Nexus RepositorySAML 2.0Dépôt d'artefacts. SAML IDP-initiated supporté depuis la v3.38.
GiteaOIDCHébergement Git léger. Application OAuth OIDC sous Administration du site.

Productivité et collaboration

ConnecteurProtocoleRemarques
NextcloudSAML 2.0Partage de fichiers et groupware. SAML via l'application SSO & SAML.
MattermostSAML 2.0Messagerie d'équipe. SAML sous Console système > Authentification.
Rocket.ChatSAML 2.0Messagerie open source. SAML sous Administration > SAML.
SeafileSAML 2.0Collaboration documentaire. SAML nécessite des modifications dans seahub_settings.py.
Jitsi MeetSAML 2.0Visioconférence. SAML via le pont Prosody LDAP/SAML.

Infrastructure

ConnecteurProtocoleRemarques
RancherSAML 2.0Interface de gestion Kubernetes. SAML sous Utilisateurs et authentification > Fournisseur d'authentification.
Kubernetes DashboardOIDCInterface web K8s. Proxy OIDC ou indicateurs OIDC du kube-apiserver.
PortainerOIDCGestion de conteneurs. OAuth/OIDC sous Paramètres > Authentification.

Sécurité et secrets

ConnecteurProtocoleRemarques
HashiCorp VaultOIDCGestion des secrets. Méthode d'authentification OIDC avec vault auth enable oidc.

Métier et documentation

ConnecteurProtocoleRemarques
OdooSAML 2.0Plateforme ERP. SAML via le module social-auth-saml.
RedmineSAML 2.0Gestion de projet. SAML via le plugin omniauth-saml.
ZammadSAML 2.0Helpdesk. SAML sous Administration > Sécurité > Applications tierces.
BookStackSAML 2.0Plateforme 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

  1. Ouvrir l'assistant. Naviguez vers Identité et accès > Applications et cliquez sur Enregistrer une application. L'assistant s'ouvre à l'étape Choix.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
Format du domaine

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.

Après l'enregistrement — configurer l'application

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ètreObligatoireDescription
domainOuiHôte (et port optionnel) où l'application est déployée. Exemple : grafana.example.org.
displayNameOuiNom lisible affiché dans le registre SP et le sélecteur de connexion. Par défaut : nom du connecteur.
instanceIdOIDC uniquementSuffixe 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éthodeCheminDescription
GET/api/v1/catalogLister tous les modèles de connecteurs.
GET/api/v1/catalog/{slug}Obtenir un modèle de connecteur par slug.
POST/api/v1/catalog/{slug}/enableActiver 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 :

  1. 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.
  2. Redémarrez hawiyati-admin. Le runner ConnectorCatalogSeeder détecte le nouveau fichier au démarrage et l'insère en base de données si le slug n'existe pas déjà.
  3. Le connecteur apparaît immédiatement dans le catalogue de la console d'administration et dans l'API REST.