Types de connexions

Référence des types disponibles dans l'assistant Nouvelle connexion (catégories Bases de données, Fichiers & stockage, APIs, Notifications, Intelligence artificielle). Rappel : les paramètres sont définis au projet, leurs valeurs par environnement ; voir Créer une connexion.

Bases de données

Ces connexions alimentent les bricks Source base de données, Écriture base de données et Exécuter SQL.

PostgreSQL

Paramètre	Requis	Description
host	Oui	Adresse du serveur
port	Non	Port (défaut : 5432)
database	Oui	Nom de la base
username	Oui	Utilisateur
password	Oui	Mot de passe (secret)
schema	Non	Schéma par défaut
ssl_mode	Non	Mode SSL (disable, require…)
connection_timeout	Non	Délai de connexion (s)

MySQL / MariaDB

Paramètre	Requis	Description
host	Oui	Adresse du serveur
port	Non	Port (défaut : 3306)
database	Oui	Nom de la base
username	Oui	Utilisateur
password	Oui	Mot de passe (secret)
charset	Non	Jeu de caractères
ssl_mode	Non	Mode SSL
connection_timeout	Non	Délai de connexion (s)

SQL Server

Paramètre	Requis	Description
host	Oui	Adresse du serveur
port	Non	Port (défaut : 1433)
database	Oui	Nom de la base
username	Oui	Utilisateur
password	Oui	Mot de passe (secret)
schema	Non	Schéma par défaut
encrypt	Non	Chiffrement du transport
trust_server_certificate	Non	Accepter un certificat auto-signé

Oracle

Paramètre	Requis	Description
host	Oui	Adresse du serveur
port	Non	Port (défaut : 1521)
connection_mode	Non	service_name ou sid
service_name / sid	Non	Identifiant de l'instance selon le mode
username	Oui	Utilisateur
password	Oui	Mot de passe (secret)

SQLite

Paramètre	Requis	Description
database_path	Oui	Chemin du fichier .db (côté runner)
timeout	Non	Délai d'attente du verrou

Snowflake

Paramètre	Requis	Description
account	Oui	Identifiant de compte Snowflake
username	Oui	Utilisateur
password	Oui	Mot de passe (secret)
database	Oui	Base
schema	Non	Schéma
warehouse	Non	Warehouse de calcul
role	Non	Rôle

BigQuery

Paramètre	Requis	Description
project_id	Oui	Projet GCP
dataset	Oui	Dataset
location	Non	Région
credentials_json	Non	Clé de service (JSON, secret)
credentials_path	Non	Chemin d'une clé de service côté runner

Redshift

Mêmes paramètres que PostgreSQL (host, port (défaut 5439), database, username, password, schema, ssl_mode).

Databricks SQL

Paramètre	Requis	Description
server_hostname	Oui	Hôte du workspace
http_path	Oui	Chemin HTTP du SQL warehouse
access_token	Oui	Token d'accès (secret)
catalog	Non	Catalogue
schema	Non	Schéma

Fichiers & stockage

Ces connexions alimentent les bricks Source fichier et Écriture fichier (le format, CSV, JSON, Excel, Parquet ou XML, se choisit dans la brick, pas dans la connexion).

Disque local

Paramètre	Requis	Description
base_path	Oui	Répertoire racine, côté runner

Amazon S3

Paramètre	Requis	Description
bucket	Oui	Nom du bucket
base_path	Oui	Préfixe racine
region	Non	Région AWS
aws_access_key_id	Non	Access Key
aws_secret_access_key	Non	Secret Key (secret)

Google Cloud Storage

Paramètre	Requis	Description
bucket	Oui	Nom du bucket
base_path	Oui	Préfixe racine
credentials_json	Non	Clé de service (JSON, secret)
credentials_path	Non	Chemin d'une clé de service côté runner

Azure Blob Storage

Paramètre	Requis	Description
azure_account_name	Oui	Nom du compte
azure_container_name	Oui	Nom du container
base_path	Oui	Préfixe racine
azure_account_key	Non	Clé de compte (secret)
azure_sas_token	Non	Token SAS (secret)
azure_connection_string	Non	Chaîne de connexion (secret)

SFTP / FTP

Paramètre	Requis	Description
protocol	Oui	sftp ou ftp
host	Oui	Adresse du serveur
port	Non	Port (défaut : 22 / 21)
username	Oui	Utilisateur
auth_type	Non	Mot de passe ou clé privée
password	Non	Mot de passe (secret)
private_key_content / private_key_path	Non	Clé privée SSH
private_key_passphrase	Non	Passphrase de la clé
base_path	Oui	Répertoire racine
passive_mode	Non	Mode passif (FTP)

APIs

REST

Utilisée par les bricks REST API (source / enrichissement) et Export API.

Paramètre	Requis	Description
base_url	Oui	URL de base
auth_type	Non	none, api_key, bearer, basic, oauth2
api_key, api_key_location, api_key_name	Non	Clé API et son emplacement (header / query)
bearer_token	Non	Token bearer (secret)
basic_username, basic_password	Non	Authentification basic
oauth2_token_url, oauth2_client_id, oauth2_client_secret, oauth2_scope	Non	Client credentials OAuth2
default_headers	Non	En-têtes par défaut
timeout, verify_ssl, max_retries, retry_delay	Non	Options réseau

Notifications

Utilisées par les bricks Alerte et Notification pour envoyer un message sur le canal choisi. Le canal est déduit automatiquement du type de connexion.

SMTP (Email)

Paramètre	Requis	Description
host	Oui	Serveur SMTP
port	Non	Port (défaut : 587)
username	Oui	Utilisateur
password	Oui	Mot de passe (secret)
from_address	Non	Adresse expéditeur
tls	Non	Activer STARTTLS

Slack

Paramètre	Requis	Description
auth_type	Oui	webhook ou bot_token
webhook_url	Non	URL Incoming Webhook Slack (https://hooks.slack.com/...)
bot_token	Non	Token de bot (secret)
default_channel	Non	Canal par défaut (mode bot)

Microsoft Teams

Les connecteurs Office 365 (MessageCard) étant retirés par Microsoft, la connexion Teams utilise un flux Power Automate qui reçoit le webhook et compose la carte.

Paramètre	Requis	Description
webhook_url	Oui	URL HTTP POST générée par le flux Power Automate
default_card_title	Non	Titre de carte par défaut

Fluhoms envoie une carte Teams prête (enveloppe message + attachments, format Adaptive Card) : c'est exactement ce qu'attend le modèle standard. Tu n'as donc aucun schéma ni action « Analyser JSON » à configurer.

Mise en place du flux (côté Teams) :

1. Dans Teams : canal → ··· → Flux de travail (Workflows / Power Automate).
2. Modèle « Publier dans un canal lorsqu'une requête de webhook est reçue » (Post to a channel when a webhook request is received).
3. Laisse le modèle tel quel : il attend une carte Adaptive, exactement ce que Fluhoms envoie. Rien d'autre à configurer.
4. Copie l'URL HTTP POST générée par le déclencheur et colle-la dans le champ webhook_url de la connexion.

Dépannage :

• N'ajoute pas d'action « Analyser JSON / Parse JSON » et ne définis pas de schéma : le modèle gère déjà le format. (Sinon erreurs "foreach attachments is Null" ou "Parse JSON ... must be valid JSON".)
• Colle l'URL complète générée par le déclencheur, y compris toute la partie après ? (notamment &sig=...) : c'est cette signature qui authentifie l'appel. Une URL tronquée provoque une erreur 401.
• Erreur 401 DirectApiAuthorizationRequired ("The OAuth authorization scheme is required") : le déclencheur exige OAuth. Recrée le flux avec le modèle Teams ci-dessus (qui autorise l'appel via la signature de l'URL), ou règle « Qui peut déclencher le flux » sur « N'importe qui ».

Discord

Paramètre	Requis	Description
webhook_url	Oui	URL de webhook Discord
username_override	Non	Nom d'affichage du bot
avatar_url	Non	Avatar du bot

Webhook générique

Paramètre	Requis	Description
url	Oui	Endpoint HTTP POST (n8n, Zapier, custom…)
auth_type	Oui	none, bearer, basic, header custom
auth_token, basic_username, basic_password, auth_header_name	Non	Selon le type d'authentification
headers	Non	En-têtes additionnels

PagerDuty

Paramètre	Requis	Description
routing_key	Oui	Clé de routage Events API (secret)
default_severity	Non	Sévérité par défaut
default_source	Non	Source par défaut

Intelligence artificielle

Utilisée par la brick Appel IA ; voir Brick Appel IA.

Mistral AI

Paramètre	Requis	Description
api_key	Oui	Clé API Mistral (secret), depuis console.mistral.ai
base_url	Oui	Racine de l'API — https://api.mistral.ai par défaut
default_model	Non	Modèle utilisé quand la brick n'en impose pas (mistral-large-latest)
timeout	Non	Délai max par appel, en secondes (120)
max_retries	Non	Reprises sur erreur réseau, quota (429) ou 5xx (3)
retry_delay	Non	Délai de base entre tentatives, doublé à chaque essai (2 s)
verify_ssl	Non	Vérification du certificat TLS (activée)

Le test de connexion liste les modèles du compte : il valide la clé sans consommer de tokens.

Bonnes pratiques

• Utilisez des comptes de service dédiés ;
• accordez les permissions minimales nécessaires ;
• activez SSL/TLS quand disponible ;
• renouvelez régulièrement les identifiants : les valeurs se changent par environnement, sans toucher aux pipelines.