Si vous possédez déjà un nom de domaine (par exemple, example.com) et que vous souhaitez l'utiliser comme nom de service Cloud Endpoints, vous devez prouver que vous êtes autorisé à utiliser le domaine. Si vous ne possédez pas votre propre nom de domaine, vous pouvez utiliser un domaine géré par Google. Dans ce cas, vous n'avez pas à en valider la propriété.
Cette page explique comment valider la propriété d'un nom de domaine que vous souhaitez utiliser pour l'API exécutée sur Google Cloud.
Exigences relatives au nom de service
En règle générale, vous configurez le nom du service Endpoints de manière à ce qu'il soit identique au nom de domaine. Endpoints doit répondre aux exigences suivantes concernant le nom du service :
- La longueur maximale du nom de domaine est de 253 caractères.
- Le nom de domaine doit commencer par une lettre minuscule.
-
Chaque section du nom de domaine, délimitée par des points, doit répondre aux exigences suivantes :
- Doit commencer par une lettre minuscule.
- Ne doit pas se terminer par un tiret.
- Les caractères restants peuvent être des lettres minuscules, des chiffres ou des tirets.
- La longueur ne doit pas dépasser 63 caractères.
Valider la propriété
Seul le compte d'utilisateur qui a validé la propriété du nom de domaine peut procéder au déploiement initial de la configuration Endpoints. Une fois ce premier déploiement réalisé, vous pouvez attribuer le rôle plus restrictif d'Éditeur pour la configuration de service à un utilisateur, un groupe ou un compte de service. Pour en savoir plus, consultez la page Accorder et révoquer l'accès à l'API.
Pour valider que vous êtes propriétaire du nom de domaine, procédez comme suit :
Accédez à la Search Console.
Cliquez sur Domain (Domaine).
Saisissez votre nom de domaine.
Cliquez sur Continuer.
Dans la liste déroulante Type d'enregistrement de la bannière Valider la propriété du domaine via un enregistrement DNS, utilisez si possible l'option Méthodes recommandées.
Connectez-vous à votre fournisseur de nom de domaine et terminez la procédure de validation en suivant les instructions. Le nom de domaine que vous avez fourni peut être éligible à AutoDNS.
Suivez les instructions fournies dans la Search Console jusqu'à ce que la validation de votre domaine soit terminée.
Déléguer aux développeurs
Une fois que vous avez été validé en tant que propriétaire de domaine dans la Search Console, vous pouvez éventuellement déléguer l'accès aux sous-domaines aux développeurs de l'organisation. Ils seront alors autorisés à créer des API Endpoints sans avoir à valider la propriété du domaine.
Pour plus d'informations sur la délégation, consultez la section Gérer les utilisateurs, les propriétaires et les autorisations.
Configurer le domaine pour SSL
Il peut être judicieux de configurer votre domaine pour SSL. Notez que certains types d'authentification nécessitent la technologie SSL.