Premiers pas

La configuration d'un projet Cloud de Confiance by S3NS et de l'authentification vous permet d'appeler les API Cloud de Confiance à partir de vos applications. Dans ce document, vous allez découvrir les API Cloud de Confiance en créant un projet, en découvrant et en activant des services dans la bibliothèque d'API, en associant un compte de facturation, en configurant des identifiants et en explorant les bibliothèques clientes.

Créer un projet Cloud de Confiance

Pour utiliser les API Cloud de Confiance , vous devez disposer d'un compte utilisateur (un compteS3NS ou un compte provenant d'un fournisseur d'identité externe) et d'un projetCloud de Confiance . Un projet équivaut à un compte de développeur. Il sert de conteneur de ressources pour vos ressources Cloud de Confiance . Il fournit également une limite d'isolation pour votre utilisation des services Cloud de Confiance by S3NS . Vous pouvez ainsi gérer les limites de quota et la facturation de manière indépendante au niveau du projet. La télémétrie et les tableaux de bord sur l'utilisation sont également regroupés par projet. Si vous ne disposez pas encore d'un projet, vous pouvez en créer un à l'aide de la consoleCloud de Confiance .

Un projet peut posséder un large éventail de ressources, y compris des clés API, des clients OAuth, des comptes de service, des VM Compute Engine, des buckets Cloud Storage et des ensembles de données BigQuery. Lorsqu'une application appelle une API Cloud de Confiance , le projet qui possède les identifiants de l'application est appelé projet client, et le projet qui possède la ressource cible est appelé projet de ressource. Certaines requêtes d'API peuvent concerner plusieurs ressources. Dans ce cas, plusieurs projets de ressources peuvent être impliqués dans la requête.

Si vous souhaitez arrêter d'utiliser Cloud de Confiance pour une raison quelconque, vous pouvez utiliser la consoleCloud de Confiance pour supprimer votre projet. Votre projet et toutes les ressources qu'il contient seront supprimés après la durée de conservation. Notez que les différents types de données ont des durées de conservation différentes.

Découvrir les API

Avant d'utiliser une API Cloud de Confiance , vous devez parcourir la bibliothèque d'API de la console Cloud de Confiance pour découvrir les APICloud de Confiance disponibles et celles qui répondent le mieux aux besoins de votre entreprise.

Activation des API…

Certaines API Cloud de Confiance sont activées par défaut. Pour utiliser une API Cloud de Confiancequi n'est pas activée par défaut, vous devez l'activer pour votre projet. Selon les services et les projets impliqués dans votre application, y compris le projet client et les projets de ressources, vous devrez peut-être activer une API pour plusieurs projets. Lorsque vous activez une API qui dépend d'autres API, celles-ci sont également activées en même temps.

Pour activer une API, vous devez accepter les conditions d'utilisation et la responsabilité de la facturation de cette API. Vous devez disposer de l'autorisation serviceusage.services.enable sur le projet pour activer les API. Pour en savoir plus, consultez la section Contrôle des accès de Service Usage.

Pour activer une API pour un projet à l'aide de la console, procédez comme suit :

  1. Accédez à la bibliothèque d'API de la consoleCloud de Confiance .
  2. Dans la liste des projets, sélectionnez celui que vous souhaitez utiliser.
  3. Dans la bibliothèque d'API, sélectionnez l'API que vous souhaitez activer. Si vous avez besoin d'aide pour trouver l'API, utilisez le champ de recherche et les filtres.
  4. Sur la page de l'API, cliquez sur ACTIVER.

Sur cette même page, vous pouvez désactiver une API pour votre projet si vous ne l'utilisez plus afin d'éviter une utilisation abusive et des frais de facturation accidentels. Vous pouvez également activer et désactiver les APIs Cloud à l'aide de la gcloud CLI et de l'API Service Usage :

gcloud services enable pubsub.googleapis.com
gcloud services disable pubsub.googleapis.com

Activation de la facturation

Certaines API Cloud facturent des frais d'utilisation. Vous devez activer la facturation pour votre projet avant de commencer à utiliser ces API dans votre projet. L'utilisation d'une API dans un projet est facturée sur le compte de facturation associé au projet.

S'authentifier auprès des API

La façon dont vous vous authentifiez auprès d'une API dépend de votre environnement de développement et des méthodes d'authentification compatibles avec l'API.

La configuration des identifiants par défaut de l'application pour une utilisation dans différents environnements est l'approche la plus courante et recommandée pour la plupart des applications. Si l'API est compatible avec les clés API, vous pouvez également les utiliser. Si votre application doit accéder aux ressources Cloud appartenant à vos utilisateurs finaux, créez un ID client OAuth 2.0 et utilisez les bibliothèques d'authentification.

Pour obtenir des informations générales sur l'authentification, consultez Authentification chez Google.

Créer des applications

Si vous créez une application à l'aide des APIs Cloud, nous vous recommandons d'utiliser les Cloud de Confiance bibliothèques clientes, le cas échéant. Les bibliothèques clientes peuvent gérer les fonctionnalités d'API courantes pour votre commodité, telles que l'authentification, la gestion des exceptions, les nouvelles tentatives et la validation de la charge utile. Vous devez transmettre les identifiants de votre application aux bibliothèques clientes lors de l'initialisation afin que les bibliothèques clientes puissent appeler les APICloud de Confiance au nom de votre application.

En savoir plus