Listeners
Définissez les points d'entrée du trafic sur votre gateway avec la configuration de protocole, port et hostname.
Vue d'Ensemble
Les listeners déterminent comment votre gateway accepte le trafic entrant. Chaque listener spécifie :
- Protocole - Le type de trafic à accepter (HTTPS, TLS, TCP)
- Port - Le port réseau à écouter
- Hostname - Le nom de domaine pour le listener
Ajouter un Listener
Étape par Étape
- Allez dans votre gateway
- Cliquez sur l'onglet Listeners
- Cliquez sur Ajouter un Listener
- Configurez :
| Champ | Description | Exemple |
|---|---|---|
| Nom | Identifiant unique pour le listener | api-listener |
| Protocole | Type de trafic | HTTPS, TLS ou TCP |
| Port | Port réseau | 443, 8443 |
| Hostname | Votre nom de domaine | api.example.com |
- Cliquez sur Enregistrer
Protocoles
HTTPS
Trafic HTTP sécurisé avec certificats TLS automatiques :
- Port : Généralement 443 ou 8443
- Certificat : Provisionné automatiquement via Let's Encrypt
- Cas d'utilisation : Applications web, APIs REST
Listener:
name: web-https
protocol: HTTPS
port: 443
hostname: app.example.com
TLS
Trafic chiffré TLS générique :
- Port : N'importe quel port (communément 443, 8443)
- Certificat : Provisionné automatiquement
- Cas d'utilisation : Protocoles non-HTTP sécurisés
Listener:
name: secure-grpc
protocol: TLS
port: 8443
hostname: grpc.example.com
TCP
Trafic TCP brut sans chiffrement :
- Port : N'importe quel port
- Pas de TLS : Le trafic n'est pas chiffré
- Cas d'utilisation : Services internes, protocoles personnalisés
Listener:
name: tcp-service
protocol: TCP
port: 9000
Les listeners TCP ne fournissent pas de chiffrement. Utilisez-les uniquement pour les services internes ou quand le chiffrement est géré au niveau applicatif.
Statut des Listeners
Statut DNS
Chaque listener avec un hostname affiche son statut de configuration DNS :
| Statut | Description |
|---|---|
| DNS Configuré | Le domaine pointe correctement vers l'IP de la gateway |
| DNS Non Configuré | Le domaine ne pointe pas vers l'IP de la gateway |
| DNS Inconnu | La vérification du statut n'est pas encore terminée |
Configurez le DNS en ajoutant un enregistrement A pointant votre domaine vers l'adresse IP de la gateway.
Statut du Certificat TLS
Pour les listeners HTTPS et TLS, le statut du certificat est affiché :
| Statut | Description |
|---|---|
| Certificat TLS Prêt | Le certificat est valide et actif |
| Certificat TLS Non Prêt | Le certificat est en cours de provisionnement ou a un problème |
| Certificat TLS Inconnu | La vérification du statut du certificat n'est pas encore terminée |
Les certificats sont automatiquement :
- Provisionnés quand le DNS est correctement configuré
- Renouvelés avant expiration
- Gérés via Let's Encrypt
Conditions
Les listeners affichent des conditions de statut détaillées :
| Sévérité | Signification |
|---|---|
| Info | Statut informatif |
| Warning | Problème potentiel nécessitant attention |
| Error | Problème empêchant le fonctionnement normal |
| Critical | Problème grave nécessitant une action immédiate |
Conditions courantes :
- Accepted - La configuration du listener est valide
- Programmed - Le listener est actif et route le trafic
- ResolvedRefs - Toutes les ressources référencées existent
Gestion des Listeners
Modifier un Listener
- Trouvez le listener dans la liste
- Cliquez sur Modifier
- Modifiez la configuration
- Cliquez sur Enregistrer
Changer le port d'un listener interrompra brièvement le trafic sur ce listener.
Supprimer un Listener
- Trouvez le listener dans la liste
- Cliquez sur Supprimer
- Confirmez la suppression
Supprimer un listener supprime toutes les routes associées et arrête immédiatement le trafic sur cette combinaison port/hostname.
Listeners Multiples
Une gateway peut avoir plusieurs listeners pour différents cas d'utilisation :
Même Domaine, Ports Différents
Listeners:
- name: https
protocol: HTTPS
port: 443
hostname: api.example.com
- name: grpc
protocol: TLS
port: 9090
hostname: api.example.com
Domaines Multiples
Listeners:
- name: app
protocol: HTTPS
port: 443
hostname: app.example.com
- name: api
protocol: HTTPS
port: 443
hostname: api.example.com
- name: admin
protocol: HTTPS
port: 443
hostname: admin.example.com
Protocoles Mixtes
Listeners:
- name: public-https
protocol: HTTPS
port: 443
hostname: app.example.com
- name: internal-tcp
protocol: TCP
port: 5432
Bonnes Pratiques
Utiliser HTTPS pour le Trafic Public
Utilisez toujours HTTPS pour les services exposés sur internet :
- Gestion automatique des certificats
- Requis par les navigateurs modernes
- Bénéfices SEO
- Confiance utilisateur
Nommer les Listeners de Façon Descriptive
Utilisez des noms clairs et descriptifs :
Bien: api-https, admin-portal, grpc-service
Mal: listener1, test, l1
Séparer les Préoccupations
Créez des listeners séparés pour différents usages :
public-https- Trafic clientapi-https- Trafic APIinternal-tcp- Services internes
Dépannage
DNS Non Configuré
- Vérifiez que l'enregistrement DNS existe
- Vérifiez les fautes de frappe dans le hostname
- Attendez la propagation DNS (jusqu'à 10 minutes)
- Utilisez
digpour vérifier :
dig app.example.com
Certificat Non Provisionné
- Assurez-vous que le DNS est correctement configuré
- Vérifiez les enregistrements CAA qui pourraient bloquer Let's Encrypt
- Vérifiez que le hostname correspond exactement au DNS
- Attendez 5-10 minutes après les changements DNS
Listener N'Accepte Pas le Trafic
- Vérifiez que le statut du listener indique "Accepted" et "Programmed"
- Vérifiez les warnings/erreurs de condition
- Assurez-vous que le port n'est pas bloqué par un firewall
- Vérifiez que des routes sont configurées pour ce listener