Aller au contenu principal

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​

  1. Allez dans votre gateway
  2. Cliquez sur l'onglet Listeners
  3. Cliquez sur Ajouter un Listener
  4. Configurez :
ChampDescriptionExemple
NomIdentifiant unique pour le listenerapi-listener
ProtocoleType de traficHTTPS, TLS ou TCP
PortPort réseau443, 8443
HostnameVotre nom de domaineapi.example.com
  1. 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
Protocole TCP

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 :

StatutDescription
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 InconnuLa 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é :

StatutDescription
Certificat TLS PrêtLe certificat est valide et actif
Certificat TLS Non PrêtLe certificat est en cours de provisionnement ou a un problème
Certificat TLS InconnuLa 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
InfoStatut informatif
WarningProblème potentiel nécessitant attention
ErrorProblème empêchant le fonctionnement normal
CriticalProblè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​

  1. Trouvez le listener dans la liste
  2. Cliquez sur Modifier
  3. Modifiez la configuration
  4. Cliquez sur Enregistrer
Changements de Port

Changer le port d'un listener interrompra brièvement le trafic sur ce listener.

Supprimer un Listener​

  1. Trouvez le listener dans la liste
  2. Cliquez sur Supprimer
  3. Confirmez la suppression
attention

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 client
  • api-https - Trafic API
  • internal-tcp - Services internes

Dépannage​

DNS Non Configuré​

  1. Vérifiez que l'enregistrement DNS existe
  2. Vérifiez les fautes de frappe dans le hostname
  3. Attendez la propagation DNS (jusqu'à 10 minutes)
  4. Utilisez dig pour vérifier :
dig app.example.com

Certificat Non Provisionné​

  1. Assurez-vous que le DNS est correctement configuré
  2. Vérifiez les enregistrements CAA qui pourraient bloquer Let's Encrypt
  3. Vérifiez que le hostname correspond exactement au DNS
  4. Attendez 5-10 minutes après les changements DNS

Listener N'Accepte Pas le Trafic​

  1. Vérifiez que le statut du listener indique "Accepted" et "Programmed"
  2. Vérifiez les warnings/erreurs de condition
  3. Assurez-vous que le port n'est pas bloqué par un firewall
  4. Vérifiez que des routes sont configurées pour ce listener

Sujets Connexes​