Questions fréquentes sur la configuration des hôtes virtuels

Vous consultez la documentation Apigee Edge.
Accédez à la documentation**Apigee X**. info

Les clients Edge Cloud peuvent désormais créer, modifier et supprimer des hôtes virtuels. Auparavant, ces actions devaient être effectuées par l'assistance Apigee Edge.

Qui peut configurer un hôte virtuel dans Edge Cloud ?

Seul un client Cloud disposant d'un compte payant peut créer, modifier et supprimer un hôte virtuel. L' utilisateur qui crée l'hôte virtuel doit disposer du rôle d'administrateur de l'organisation ou d' un rôle personnalisé disposant des autorisations nécessaires pour modifier un hôte virtuel. Les utilisateurs disposant d'autres rôles ne sont pas autorisés à créer des hôtes virtuels.

Le rôle personnalisé nécessite les autorisations GET, PUT et DELETE sur /environments/*/virtualhosts, ou sur l'une de ses ressources parentes. Pour en savoir plus, consultez la section Créer des rôles avec l'API.

Que faire si j'ai un hôte virtuel existant créé par Apigee ?

Les clients Edge Cloud existants disposent déjà d'hôtes virtuels créés par Apigee. Vous pouvez désormais modifier ces hôtes virtuels.

Toutefois, avant d'apporter des modifications, consultez les exigences relatives à la modification d'un hôte virtuel dans la section Configurer des hôtes virtuels pour le cloud. Par exemple, si votre hôte virtuel existant est configuré pour utiliser un port autre que le port 443, vous ne pouvez pas modifier le numéro de port ni le paramètre TLS. Cela signifie que vous ne pouvez pas modifier le paramètre TLS (activé ou désactivé), ou de désactivé à activé.

Quel port puis-je utiliser dans un hôte virtuel dans le cloud ?

Vous ne pouvez utiliser que le port 443 dans un hôte virtuel dans le cloud. Vous ne pouvez pas utiliser le port 80 ni aucun autre port.

Pourquoi ne puis-je pas utiliser le port 80 dans un hôte virtuel dans le cloud ?

Nous encourageons les clients Apigee à ne plus utiliser d'hôtes virtuels sur le port 80 pour le trafic d'exécution de l'API car ce port n'est pas sécurisé. De plus, comme nous ne sommes pas en mesure de valider la propriété des domaines, les hôtes virtuels sur le port 80 ne peuvent pas être autonomes pour le cloud. Les modifications apportées aux hôtes virtuels sur le port 80 sont considérées comme non standards. Par conséquent, l'assistance Apigee Edge se réserve le droit de refuser ces modifications.

Le protocole TLS est-il requis sur tous les nouveaux hôtes virtuels dans le cloud ?

Pour créer un hôte virtuel, vous devez activer le protocole TLS sur celui-ci. Cela signifie que vous devez d'abord créer un keystore avec le certificat et la clé TLS avant de créer l'hôte virtuel.

Vous devez disposer d'un certificat signé par une entité de confiance, telle que Symantec ou VeriSign. Vous ne pouvez pas utiliser de certificat autosigné ni de certificat feuille signé par une autorité de certification autosignée.

Consultez la section Configurer des hôtes virtuels pour le cloud pour en savoir plus.

Puis-je épingler le certificat d'essai sans frais Apigee ?

Pour des raisons de sécurité, les certificats d'essai sans frais Apigee expirent tous les trois mois. Au bout de ces trois mois, Apigee remplace le certificat qui expire par un nouveau. Par conséquent, Apigee ne recommande ni ne prend en charge l'épinglage du certificat d'essai sans frais.

Puis-je mettre à jour le certificat TLS utilisé par un hôte virtuel ?

Si vous disposez d'un hôte virtuel avec un certificat TLS qui expire, vous pouvez le mettre à jour pour qu'il utilise un autre keystore contenant un certificat valide.

Qu'est-ce qu'une référence ?

Une référence est une variable contenant le nom du keystore. Pour modifier le keystore utilisé par un hôte virtuel, vous devez mettre à jour la variable de référence, et non l'hôte virtuel lui-même.

Les anciens hôtes virtuels sur Apigee Edge ne sont peut-être pas configurés pour utiliser des références. Dans ce cas, vous devez demander à l'assistance Apigee Edge de mettre à jour l' hôte virtuel pour qu'il utilise une référence. Ne mettez pas à jour vous-même un hôte virtuel pour qu'il utilise une référence.

Comment savoir si mon hôte virtuel utilise une référence ?

Pour afficher des informations sur un hôte virtuel spécifique, utilisez l'API Get Virtual Host :

curl -X GET -H "accept:application/xml" \
  https://api.enterprise.apigee.com/v1/o/{org_name}/e/{env_name}/virtualhosts/{vhost_name} \
  -u orgAdminEmail:pWord

où vhost_name est le nom de l'hôte virtuel. Par exemple, vous pouvez spécifier le vhost_name comme "secure" pour afficher la configuration de l'hôte virtuel sécurisé par défaut :

<VirtualHost name="secure">
    <HostAliases>
        <HostAlias>orgname-prod.apigee.net</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>443</Port>
    <Properties/>
    <SSLInfo>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <Enabled>true</Enabled>
        <KeyAlias>freetrial</KeyAlias>
        <KeyStore>ref://freetrial</KeyStore>
        <IgnoreValidationErrors>false</IgnoreValidationErrors>
    </SSLInfo>
</VirtualHost>

Notez que dans cet exemple, la valeur de l'élément <KeyStore> dans la réponse commence par ref://. Ce préfixe indique que le keystore utilise une référence.

Si la valeur de l'élément <KeyStore> est un littéral de chaîne, cela signifie qu'il n'utilise pas de référence. Exemple :

<KeyStore>mykeystore</KeyStore>

Ne mettez pas à jour vous-même un hôte virtuel pour qu'il utilise une référence. Vous devez demander à l'assistance Apigee Edge de mettre à jour l'hôte virtuel pour qu'il utilise une référence. Une fois qu'Apigee a mis à jour l'hôte virtuel pour qu'il utilise une référence, vous pouvez modifier le keystore en mettant à jour la variable de référence.

Consultez la section Configurer des hôtes virtuels pour le cloud pour en savoir plus.

Comment créer un hôte virtuel ?

Pour créer l'hôte virtuel, procédez comme suit :

  1. Créez une entrée DNS et un enregistrement CNAME pour votre domaine public qui pointe vers [org]-[environment].apigee.net. Pour en savoir plus, consultez la section "À propos des alias d'hôte et des noms DNS" dans À propos des hôtes virtuels.
  2. Créez et configurez un keystore en suivant la procédure décrite dans Créer des keystores et des truststores à l'aide de l'interface utilisateur Edge.
  3. Importez votre certificat et votre clé dans le keystore.
  4. Créez une référence au keystore comme décrit dans Configurer des hôtes virtuels pour le cloud.
  5. Créez l'hôte virtuel à l'aide de l'API Create a Virtual Host, comme décrit dans la section Configuring virtual hosts for the Cloud. Veillez à spécifier la référence de keystore correcte.
  6. Si vous disposez de proxys d'API existants, ajoutez l'hôte virtuel à l'élément <HTTPConnection> dans le ProxyEndpoint. L'hôte virtuel est ajouté automatiquement à tous les nouveaux proxys d'API. Consultez Configurer un proxy d'API pour qu'il utilise un hôte virtuel.

Puis-je demander à Apigee de bloquer les ports TCP 80, 443 ou 15999 sur Apigee Edge Cloud ?

Étant donné que nos clients configurent des hôtes virtuels sur le port TCP 443 et parfois sur le port TCP 80 (bien que l'utilisation du port 80 ne soit pas recommandée), nous ne pouvons pas bloquer ces ports, car cela entraînerait l'échec de tout le trafic d'exécution de l'API.

Le port TCP 15999 est utilisé en interne dans le cloud pour déterminer si les routeurs sont en bon état ou non et ne doit donc pas non plus être bloqué, car cela pourrait avoir un impact imprévu sur l'exécution de l'API.