Activer les clients non SNI et HTTP

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cet article explique comment activer les clients non SNI, les clients HTTP ou une combinaison des deux pour une utilisation avec Apigee hybrid.

Comment configurer un client non SNI

Cette section explique comment activer la compatibilité avec les clients non SNI (Server Name Indication) dans Apigee hybrid. Un client non SNI utilise le port 443. Il est nécessaire si vous souhaitez intégrer des instances d'exécution hybride avec Google Cloud Load Balancing ou pour les clients qui ne sont pas compatibles avec SNI.
  1. Créez une définition de ressource personnalisée (CRD) ApigeeRoute. Assurez-vous que enableNonSniClient est défini sur true :
    apiVersion: apigee.cloud.google.com/v1alpha1
    kind: ApigeeRoute
    metadata:
      name: route_name
      namespace: apigee
    spec:
      hostnames:
      - "*"
      ports:
      - number: 443
        protocol: HTTPS
        tls:
          credentialName: credential_name
          mode: SIMPLE
          #optional
          minProtocolVersion: TLS_AUTO
      selector:
        app: istio-ingressgateway
      enableNonSniClient: true
    

    Où :

    • route_name est le nom que vous donnez à la CRD.
    • credential_name est le nom d'un secret Kubernetes déployé sur le cluster contenant les identifiants TLS de votre hôte virtuel. Vous pouvez trouver le nom de l'identifiant à l'aide de la commande kubectl suivante :
      kubectl -n apigee get ApigeeRoutes -o=yaml | grep credentialName
    • hostnames doit être défini sur le caractère générique "*".
  2. Ouvrez le fichier de remplacement et apportez la modification décrite à l'étape suivante.
  3. Pour chaque groupe d'environnement, ajoutez le nom ApigeeRoute à la propriété additionalGateways. Exemple :
    virtualhosts:
      - name: default
        sslCertPath: ./certs/fullchain.pem
        sslKeyPath: ./certs/privkey.pem
        additionalGateways: ["route_name"]
  4. Enregistrez le fichier CRD. Par exemple : ApigeeRoute.yaml
  5. Appliquez l'objet CRD au cluster :
    kubectl apply -f ApigeeRoute.yaml -n apigee
  6. Appliquez la modification à virtualhosts :
    $APIGEECTL_HOME/apigeectl apply -f overrides.yaml --settings virtualhosts --env $ENVIRONMENT

Remarques sur l'utilisation

  • Que se passe-t-il si le cluster comporte plusieurs organisations ?

    Comme l'entrée est au niveau du cluster pour un port donné (443), et qu'il n'y a qu'une seule paire clé/cert pour la CRD ApigeeRoute, toutes les organisations doivent partager la même paire clé/cert.

  • Que se passe-t-il si le cluster comporte plusieurs groupes d'environnements ? Cela fonctionnera-t-il si les hôtes virtuels partagent la même paire clé/cert ?

    Tous les noms d'hôte de tous les groupes d'environnements doivent utiliser la même paire clé/cert.

  • Pourquoi créer une ApigeeRoute plutôt que Gateway ?

    Les ApigeeRoutes peuvent être validées par Apigee, ce qui n'est pas le cas de Gateway (le CRD d'Istio). Techniquement, même Gateway peut fonctionner, mais nous pouvons éviter des erreurs de configuration potentielles (via un webhook de validation).

Activer les clients HTTP

Cette section explique comment activer la compatibilité des clients HTTP dans Apigee hybrid.

  1. Créez une définition de ressource personnalisée (CRD) ApigeeRoute. Exemple :
    apiVersion: apigee.cloud.google.com/v1alpha1
    kind: ApigeeRoute
    metadata:
      name: route_name
      namespace: apigee
    spec:
      hostnames:
      - "*"
      ports:
      - number: 80
        protocol: HTTP
      selector:
        app: istio-ingressgateway
      enableNonSniClient: true

    Où :

    • route_name est le nom que vous donnez à la CRD.
    • hostnames doit être défini sur le caractère générique "*".
  2. Ouvrez le fichier de remplacement et apportez la modification décrite à l'étape suivante.
  3. Pour chaque groupe d'environnement, ajoutez le nom ApigeeRoute à la propriété additionalGateways. Exemple :
    virtualhosts:
      - name: default
        sslCertPath: ./certs/fullchain.pem
        sslKeyPath: ./certs/privkey.pem
        additionalGateways: ["route_name"]
  4. Enregistrez le fichier CRD. Par exemple : ApigeeRoute.yaml
  5. Appliquez l'objet CRD au cluster :
    kubectl apply -f ApigeeRoute.yaml -n apigee
  6. Appliquez la modification à virtualhosts :
    $APIGEECTL_HOME/apigeectl apply -f overrides.yaml --settings virtualhosts --env $ENVIRONMENT

Activer la compatibilité pour les clients non-SNI et HTTP

Cette section explique comment activer à la fois les clients non SNI (port 443) et HTTP (port 80) pour une utilisation avec Apigee hybrid.

  1. Créez une définition de ressource personnalisée (CRD) ApigeeRoute. Exemple :
    apiVersion: apigee.cloud.google.com/v1alpha1
    kind: ApigeeRoute
    metadata:
      name: route_name
      namespace: apigee
    spec:
      hostnames:
      - "*"
      ports:
      - number: 443
        protocol: HTTPS
        tls:
          credentialName: credential_name
          mode: SIMPLE
          #optional
          minProtocolVersion: TLS_AUTO
      - number: 80
        protocol: HTTP
      selector:
        app: istio-ingressgateway
      enableNonSniClient: true

    Où :

    • route_name est le nom que vous donnez à la CRD.
    • hostname doit être défini sur le caractère générique "*".
    • credential_name est le nom d'un secret Kubernetes déployé sur le cluster contenant les identifiants TLS de votre hôte virtuel. Vous pouvez trouver le nom de l'identifiant à l'aide de la commande kubectl suivante :
      kubectl -n apigee get ApigeeRoutes -o=yaml | grep credentialName
  2. Ouvrez le fichier de remplacement et apportez la modification décrite à l'étape suivante.
  3. Pour chaque groupe d'environnement, ajoutez le nom ApigeeRoute à la propriété additionalGateways. Exemple :
    virtualhosts:
      - name: default
        sslCertPath: ./certs/fullchain.pem
        sslKeyPath: ./certs/privkey.pem
        additionalGateways: ["route_name"]
  4. Enregistrez le fichier CRD. Par exemple : ApigeeRoute.yaml
  5. Appliquez l'objet CRD au cluster :
    kubectl apply -f ApigeeRoute.yaml -n apigee
  6. Appliquez la modification à virtualhosts :
    $APIGEECTL_HOME/apigeectl apply -f overrides.yaml --settings virtualhosts --env $ENVIRONMENT