Ce guide décrit toutes les étapes de configuration nécessaires pour commencer à utiliser Enterprise Knowledge Graph.
À propos de la console Google Cloud
Google Cloud console est une interface utilisateur Web permettant de provisionner, configurer, gérer et surveiller les systèmes utilisant des produits Google Cloud . Vous utilisez la console Google Cloud pour configurer et gérer les ressources Enterprise Knowledge Graph.
Créer un projet
Pour utiliser les services fournis par Google Cloud, vous devez créer un projet.
Un projet permet d'organiser toutes vos ressources Google Cloud . Un projet se compose des éléments suivants :
- Un ensemble de collaborateurs
- Des API activées (et autres ressources)
- Outils de surveillance
- Informations bancaires
- L'authentification et le contrôle des accès
Vous pouvez créer un projet ou en créer plusieurs. Vous pouvez utiliser vos projets pour organiser vos ressources Google Cloud dans une hiérarchie des ressources. Pour en savoir plus sur les projets, consultez la documentation de Resource Manager.
Dans la console Google Cloud , sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud .
Rôles requis pour sélectionner ou créer un projet
- Sélectionnez un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique. Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
-
Créer un projet : pour créer un projet, vous devez disposer du rôle Créateur de projet (
roles/resourcemanager.projectCreator), qui contient l'autorisationresourcemanager.projects.create. Découvrez comment attribuer des rôles.
Accéder au sélecteur de projet
Activer l'API
Vous devez activer l'API Enterprise Knowledge Graph pour votre projet. Pour en savoir plus sur l'activation des API, consultez la documentation de Service Usage.
Activez l'API Enterprise Knowledge Graph, si ce n'est pas déjà fait.
Rôles requis pour activer les API
Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation grâce au rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation grâce au rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.
Configurer l'authentification
Toute application cliente qui utilise l'API doit être authentifiée et se voir accorder l'accès aux ressources demandées. Cette section décrit des concepts d'authentification importants et vous indique la procédure à suivre pour la configurer. Pour en savoir plus, consultez la présentation de l'authentification.
À propos des comptes de service
Il existe plusieurs options d'authentification, mais nous vous recommandons d'utiliser les comptes de service pour l'authentification et le contrôle des accès. Un compte de service fournit des identifiants pour les applications, et non pour les utilisateurs finaux. Les comptes de service appartiennent à des projets. Vous pouvez créer plusieurs comptes de service par projet. Pour en savoir plus, consultez la page Comptes de service.
À propos des rôles
Lors de l'appel d'une API, Google Cloud exige que l'identitéde l'appelant (toute personne, entité ou processus applicable et leurs attributs définis) dispose des autorisations appropriées. Vous pouvez accorder des autorisations en attribuant des rôles à un compte de service. Pour en savoir plus, consultez la documentation sur Identity and Access Management (IAM).
Pour essayer l'API Enterprise Knowledge Graph, vous pouvez utiliser le rôle Projet > Propriétaire dans les étapes suivantes. Le rôle Projet > Propriétaire accorde au compte de service un accès complet aux ressources de votre projet. Si votre compte de service ne nécessite pas d'autorisations complètes, vous pouvez spécifier un rôle plus restrictif à l'aide de la consoleGoogle Cloud . Pour obtenir la liste des autorisations et des rôles pour Enterprise Knowledge Graph, consultez Autorisations Enterprise Knowledge Graph et Rôles Enterprise Knowledge Graph. Pour en savoir plus sur la gestion des autorisations à l'aide des rôles IAM, consultez Attribuer des rôles aux comptes de service.
À propos des clés de compte de service
Les comptes de service sont associés à une ou plusieurs paires de clés publiques ou privées. Lorsque vous créez une paire de clés, vous téléchargez la clé privée. Google Cloud CLI utilise votre clé privée pour générer des identifiants lors de l'appel de l'API.
Créer un compte de service et télécharger le fichier de clé privée
Créez un compte de service :
-
Assurez-vous de disposer du rôle IAM "Créateur de comptes de service" (
roles/iam.serviceAccountCreator) et du rôle IAM "Administrateur IAM du projet" (roles/resourcemanager.projectIamAdmin). Découvrez comment attribuer des rôles. -
Dans la console Google Cloud , accédez à la page Créer un compte de service.
Accéder à la page "Créer un compte de service" - Sélectionnez votre projet.
-
Dans le champ Nom du compte de service, saisissez un nom. La console Google Cloud remplit le champ ID du compte de service en fonction de ce nom.
Dans le champ Description du compte de service, saisissez une description. Exemple :
Service account for quickstart. - Cliquez sur Créer et continuer.
-
Attribuez le rôle Projet > Propriétaire au compte de service.
Pour accorder le rôle, trouvez la liste Sélectionner un rôle, puis sélectionnez Projet > Propriétaire.
- Cliquez sur Continuer.
-
Cliquez sur OK pour terminer la création du compte de service.
Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.
Créez une clé de compte de service :
- Dans la console Google Cloud , cliquez sur l'adresse e-mail du compte de service que vous avez créé.
- Cliquez sur Keys (Clés).
- Cliquez sur Ajouter une clé, puis sur Créer une clé.
- Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
- Cliquez sur Fermer.