Personnalisez votre domaine.

Vous consultez la documentation d'Apigee Edge.
Accédez à la documentation sur Apigee X. info

Lorsque vous créez un portail des développeurs, par défaut, vous fournissez un exemple de nom de domaine Apigee pour accéder à votre portail en ligne au format suivant :

https://orgname-portalname.apigee.io

Où orgname est le nom de l'organisation et portalname est défini à l'aide du nom du portail converti en minuscules, sans espaces ni tirets.

Avant de lancer un portail des développeurs, il est recommandé de fournir votre propre nom de domaine personnalisé. Voici par exemple une alternative couramment utilisée :

https://developers.example.com

Pour en savoir plus sur l'utilisation d'un domaine personnalisé avec un fournisseur d'identité SAML, consultez la section Utiliser un domaine personnalisé avec le fournisseur SAML.

Les sections suivantes expliquent comment personnaliser votre domaine.

Personnaliser votre nom de domaine (Apigee Edge)

Pour personnaliser votre nom de domaine dans les portails intégrés Apigee Edge, procédez comme suit:

1. Enregistrez votre nom de domaine
2. Configurez TLS.
3. Ajoutez un nom de domaine personnalisé à votre portail.
4. Configurez votre DNS.

Une fois que vous avez ajouté un domaine personnalisé, vous pouvez le modifier ou le désactiver. Pour obtenir de l'aide sur la résolution des problèmes, consultez Résoudre les problèmes liés à votre domaine personnalisé.

Étape 1 : Enregistrer votre nom de domaine

Si vous devez enregistrer un nouveau domaine, de nombreux sites populaires d'enregistrement de domaine sont disponibles, tels que Google Domains. Le choix du site d'enregistrement de domaine vous appartient.

Lorsque vous décidez du nom de domaine, gardez à l'esprit que les URL lisibles et conviviales sont des facteurs essentiels pour améliorer le référencement naturel, comme décrit dans la section Mettre en œuvre le référencement naturel (SEO).

Étape 2: Configurez TLS

Pour prendre en charge le protocole HTTPS, vous devez configurer TLS en créant des keystores et des alias contenant les certificats numériques nécessaires dans l'environnement du portail, comme décrit dans la procédure suivante.

Pour configurer TLS:

1. Achetez un certificat TLS auprès d'une autorité de certification réputée, telle que Google Trust Services. C'est vous qui choisissez l'autorité de certification que vous choisissez.
2. Connectez-vous à https://apigee.com/edge.
3. Sélectionnez votre organisation dans le menu de votre profil utilisateur.
4. Sélectionnez Admin > Environment > TLS Keystores (Administrateur > Environnement > Keystores TLS) pour afficher la page des keystores TLS.

5. Sélectionnez portal dans la liste déroulante "Environnement".

   

6. Créez un keystore et un alias, comme décrit dans la section Créer des keystores et des truststores à l'aide de l'UI Edge.

Étape 3: Ajouter un nom de domaine personnalisé à votre portail

Lorsque vous ajoutez un nom de domaine personnalisé à votre portail, le système crée les ressources suivantes pour vous (à l'aide de la même fonctionnalité que celle utilisée pour appliquer un nom de domaine personnalisé à un point de terminaison tel que api.example.com):

• Un hôte virtuel, en écoute sur le port 443, utilisant le nom de domaine personnalisé que vous spécifiez.

• Un proxy d'API utilisant l'URL du domaine personnalisé, avec son point de terminaison cible défini sur le domaine du portail par défaut. Le nom du proxy d'API correspond au nom de domaine personnalisé, les points étant remplacés par des traits de soulignement. Le proxy d'API est déployé dans l'environnement du portail.

Pour ajouter un nom de domaine personnalisé à votre portail:

1. Cliquez sur Publish > Portals (Publier > Portails), puis sélectionnez votre portail.
2. Sélectionnez Paramètres dans le menu déroulant de la barre de navigation supérieure ou sur la page de destination.
3. Cliquez sur l'onglet Domains (Domaines).
4. Sous Domaine personnalisé, remplissez les champs suivants.
   

   Champ	Description
   Keystore	Sélectionnez un keystore dans la liste déroulante. Remarque: La liste est renseignée à partir des keystores que vous avez créés dans l'environnement de portail à l'étape 2. Une fois que vous avez sélectionné un keystore, le champ Alias s'affiche.
   Alias	Sélectionnez un alias valide dans la liste déroulante. Remarque: La liste est renseignée à partir des alias que vous avez créés pour le keystore sélectionné. La liste n'inclut pas les magasins de clés avec des chaînes de certificats, des domaines Apigee ou des magasins de confiance non valides. Pour déterminer la date d'expiration d'un certificat de la liste: Affichez les icônes : Le certificat expire dans plus de 30 jours ou le domaine personnalisé sélectionné est peut-être déjà utilisé. Le certificat expire dans 30 jours. Le certificat a expiré. Pointez sur un alias pour afficher le nombre de jours restants pendant lesquels le certificat sera valide. Une fois l'alias sélectionné, le champ Domaine s'affiche.
   Domaine	Sélectionnez un domaine dans la liste déroulante. Si vous avez sélectionné un alias générique, saisissez le sous-domaine. Remarque:La liste des domaines est renseignée à l'aide des noms courants et alternatifs du certificat de premier niveau de la chaîne définie par l'alias sélectionné.

   Une fois tous les champs remplis, l'icône d'état du domaine personnalisé est mise à jour comme suit:

   État	Description
   	Le keystore, l'alias et le domaine personnalisé sont valides.
   	Le certificat expirera dans 30 jours.
   	Le keystore, l'alias et le domaine personnalisé ne sont pas valides.

   De plus, la configuration DNS est validée et l'icône d'état "Configurer le DNS" est mise à jour comme suit :

   État	Description
   	La configuration DNS est valide.
   	La configuration DNS n'est pas valide. Vous devez configurer votre DNS, comme décrit dans la section Configurer votre DNS.

5. Cliquez sur Activer (ou sur Enregistrer si vous modifiez la campagne).
   Vous pouvez activer votre domaine personnalisé, même si sa configuration DNS ou le domaine lui-même ne sont pas valides.

Étape 4: Configurer votre DNS

Vous devez ensuite ajouter un enregistrement de nom canonique (CNAME) au DNS de votre domaine pour qu'il pointe vers {org_name}-portal.apigee.net.

Pour confirmer la valeur CNAME:

1. Sélectionnez Publier > Portails et sélectionnez votre portail.
2. Sélectionnez Paramètres dans le menu déroulant de la barre de navigation supérieure ou sur la page de destination.
3. Cliquez sur l'onglet Domains (Domaines).
4. Affichez la valeur CNAME de votre organisation dans la section Configurer DNS, comme illustré dans la figure suivante :

Vous trouverez ci-dessous un exemple d'enregistrement CNAME que vous pouvez configurer pour le domaine personnalisé affiché ci-dessus (c'est-à-dire pour le domaine personnalisé developers.example.com de l'organisation myorg):

developers.example.com. CNAME myorg-portal.apigee.net.

Résoudre les problèmes liés à votre domaine personnalisé

Les sections suivantes fournissent des suggestions pour résoudre les problèmes liés à votre domaine personnalisé.

Résoudre les problèmes: vérifier la configuration DNS de votre domaine à l'aide de dig

Une fois que le DNS de votre domaine a été mis à jour pour inclure l'enregistrement CNAME, il faut un certain temps pour que les modifications soient propagées aux autres serveurs DNS du monde entier. Vous pouvez interroger le serveur DNS de votre domaine pour vérifier que l'enregistrement CNAME a été correctement configuré, même avant qu'il ne soit entièrement propagé vers d'autres serveurs DNS, à l'aide de dig.

Par exemple, la commande dig suivante interroge le serveur DNS de votre domaine. Dans le résultat de la commande, ANSWER SECTION contient l'entrée d'enregistrement CNAME.

$ dig @your.domain.dns developer.mycompany.com
; <<>> DiG 9.8.3-P1 <<>> @your.domain.dns developer.mycompany.com
; (1 server found)
;; global options:  cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 41356
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 0
;; WARNING: recursion requested but not available

;; QUESTION SECTION:
;developer.mycompany.com.       IN  A

;; ANSWER SECTION:
developer.mycompany.com.    29  IN  CNAME   myorg-portal.apigee.net.

;; Query time: 141 msec
;; SERVER: 192.168.1.254#53(192.168.1.254)
;; WHEN: Mon Mar 20 16:41:59 2017
;; MSG SIZE  rcvd: 136

Résoudre les problèmes: impossible d'identifier le proxy de l'hôte

Lorsque vous ajoutez un nom de domaine personnalisé à votre portail, un proxy d'API est généré par défaut qui utilise l'URL du domaine personnalisé, avec son point de terminaison cible défini sur le domaine du portail par défaut. Si vous modifiez ou supprimez le proxy API associé à un domaine personnalisé, vous invaliderez la configuration du domaine personnalisé et recevrez un message d'erreur Unable to identify proxy for host lorsque vous tenterez d'accéder à l'URL du domaine personnalisé. Exemple :

{"fault":{"faultstring":"Unable to identify proxy for host: developers.mycompany.com:443 and url: \/","detail":{"errorcode":"messaging.adaptors.http.flow.ApplicationNotFound"}}}

Pour restaurer la configuration du domaine personnalisé si le proxy d'API a été modifié ou supprimé:

1. Sélectionnez Publier > Portails et sélectionnez votre portail.
2. Sélectionnez Paramètres dans le menu déroulant de la barre de navigation supérieure ou sur la page de destination.
3. Cliquez sur l'onglet Domains (Domaines).
4. Cliquez sur Enregistrer pour restaurer le proxy d'API.

Mettre à jour votre certificat

Pour obtenir des informations générales sur la mise à jour des certificats TLS, consultez Mettre à jour un certificat TLS.

1. Suivez la procédure décrite dans Étape 2: Configurer TLS.
2. Suivez les étapes de l'étape 3: Ajouter un nom de domaine personnalisé à votre portail.