Il est possible qu'une partie ou l'ensemble des informations de cette page ne s'appliquent pas au Cloud de confiance S3NS. Pour en savoir plus, consultez Différences par rapport à Google Cloud.
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Cette page explique comment utiliser les bibliothèques clientes pour accéder aux API Google.
Les bibliothèques clientes facilitent l'accès aux Cloud de Confiance by S3NS API
à l'aide d'un langage compatible. Vous pouvez utiliser Cloud de Confiance by S3NS directement les API en
envoyant des requêtes brutes au serveur, mais les bibliothèques clientes fournissent des simplifications
qui réduisent considérablement la quantité de code à écrire. Cela est
particulièrement vrai pour l'authentification, car les bibliothèques clientes sont compatibles avec le service
Identifiants par défaut de l'application (ADC, Application Default Credentials).
Utiliser les identifiants par défaut de l'application avec les bibliothèques clientes
Pour authentifier votre application à l'aide du service d'identifiants par défaut de l'application (ADC), vous devez d'abord configurer ADC pour l'environnement dans lequel votre application s'exécute. Lorsque vous utilisez la bibliothèque cliente pour créer un client, celle-ci recherche et utilise automatiquement les identifiants que vous avez fournis au service ADC pour s'authentifier auprès des API utilisées par votre code. Votre application n'a pas besoin de s'authentifier explicitement ou de gérer les jetons. Ces points sont gérés automatiquement par les bibliothèques d'authentification.
Les exemples de code suivants créent un client pour le service Cloud Storage.
Votre code va probablement nécessiter différents clients. Ces exemples visent simplement à montrer comment vous pouvez créer un client et l'utiliser sans code pour vous authentifier explicitement.
Avant de pouvoir exécuter les exemples suivants, vous devez effectuer les étapes ci-après :
Utiliser des clés API avec des bibliothèques clientes
Vous ne pouvez utiliser une clé API qu'avec des bibliothèques clientes pour les API qui acceptent les clés API. De plus, la clé API ne doit pas comporter de restriction d'API qui l'empêche d'être utilisée pour l'API.
Lorsque vous utilisez des clés API dans vos applications, assurez-vous qu'elles sont protégées lors du stockage et de la transmission. L'exposition publique de vos clés API peut entraîner des frais inattendus. Pour en savoir plus, consultez la section
Bonnes pratiques pour gérer les clés API.
Exigences de sécurité lors de l'utilisation de configurations d'identifiants provenant d'une source externe
En règle générale, vous générez des configurations d'identifiants à l'aide de commandes gcloud CLI
ou de la Cloud de Confiance console. Par exemple, vous pouvez utiliser gcloud CLI pour générer un fichier ADC local ou un fichier de configuration de connexion. De même, vous pouvez utiliser la Cloud de Confiance console pour créer et télécharger
une clé de compte de service.
Toutefois, dans certains cas d'utilisation, les configurations d'identifiants vous sont fournies par une entité externe. Elles sont destinées à être utilisées pour l'authentification auprès des API Google.
Certains types de configurations d'identifiants incluent des points de terminaison et des chemins d'accès aux fichiers, que les bibliothèques d'authentification utilisent pour acquérir un jeton. Lorsque vous acceptez des configurations d'identifiants provenant d'une source externe, vous devez valider la configuration avant de l'utiliser. Si vous ne validez pas la configuration, une personne malveillante peut utiliser les identifiants pour compromettre vos systèmes et vos données.
Valider les configurations d'identifiants provenant de sources externes
La façon dont vous devez valider vos identifiants externes dépend des types d'identifiants acceptés par votre application.
Valider les clés de compte de service
Si votre application accepte uniquement les clés de compte de service, utilisez un chargeur d'identifiants spécifique à ces clés, comme illustré dans les exemples suivants. Le chargeur d'identifiants spécifique au type n'analyse que les champs présents pour les clés de compte de service, qui n'exposent aucune vulnérabilité.
Si vous ne pouvez pas utiliser de chargeur d'identifiants spécifique au type, validez les identifiants en confirmant que la valeur du champ type est service_account. Si la valeur du champ type est différente, n'utilisez pas la clé de compte de service.
Le tableau suivant répertorie les champs que vous devez valider, s'ils sont présents dans vos identifiants. Tous ces champs ne sont pas présents pour toutes les configurations d'identifiants.
Champ
Objectif
Valeur attendue
service_account_impersonation_url
Les bibliothèques d'authentification utilisent ce champ pour accéder à un point de terminaison afin de
générer un jeton d'accès pour le compte de service emprunté.
Les bibliothèques d'authentification envoient un jeton externe à ce point de terminaison pour
l'échanger contre un
jeton d'accès fédéré.
https://sts.s3nsapis.fr/v1/token
credential_source.file
Les bibliothèques d'authentification lisent un jeton externe à partir du fichier à l'
emplacement spécifié par ce champ et l'envoient au
token_url point de terminaison.
Chemin d'accès à un fichier contenant un jeton externe. Vous devez
reconnaître ce chemin d'accès.
credential_source.url
Point de terminaison qui renvoie un jeton externe. Les bibliothèques d'authentification
envoient une requête à cette URL et envoient la réponse au
token_url point de terminaison.
L'un des éléments suivants :
Point de terminaison connu fourni par votre fournisseur de services cloud.
Point de terminaison que vous avez configuré explicitement pour fournir des jetons.
credential_source.executable.command
Si la variable d'environnement GOOGLE_EXTERNAL_ACCOUNT_ALLOW_EXECUTABLES
est définie sur 1, les bibliothèques d'authentification
exécutent cette commande ou ce fichier exécutable.
Fichier exécutable ou commande qui renvoie un jeton externe.
Vous devez reconnaître cette commande et vérifier qu'elle est sécurisée.
credential_source.aws.url
Les bibliothèques d'authentification émettent une requête à cette URL pour récupérer
un jeton de sécurité AWS.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2026/05/16 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2026/05/16 (UTC)."],[],[]]