Utiliser des variables d’environnement avec Azure AI services

Ce guide vous montre comment définir et récupérer des variables d’environnement pour vos informations d’identification Azure AI services lorsque vous testez des applications.

Important

Si vous utilisez une clé API, stockez-la en toute sécurité dans un autre emplacement, par exemple dans Azure Key Vault. N'incluez pas la clé API directement dans votre code et ne la diffusez jamais publiquement.

Pour plus d’informations sur la sécurité des services IA, consultez Authentifier les requêtes auprès d’Azure AI services.

Définir une variable d’environnement

Pour définir des variables d’environnement, utilisez l’une des commandes suivantes, où ENVIRONMENT_VARIABLE_KEY est la clé nommée et value la valeur stockée dans la variable d’environnement.

Ligne de commande

Utilisez la commande suivante pour créer et affecter une variable d’environnement persistante, en fonction de la valeur d’entrée.

:: Assigns the env var to the value
setx ENVIRONMENT_VARIABLE_KEY "value"

Dans une nouvelle instance de l’invite de commandes, utilisez la commande suivante pour lire la variable d’environnement.

:: Prints the env var value
echo %ENVIRONMENT_VARIABLE_KEY%

PowerShell

Utilisez la commande suivante pour créer et affecter une variable d’environnement persistante, en fonction de la valeur d’entrée.

# Assigns the env var to the value
[System.Environment]::SetEnvironmentVariable('ENVIRONMENT_VARIABLE_KEY', 'value', 'User')

Dans une nouvelle instance de Windows PowerShell, utilisez la commande suivante pour lire la variable d’environnement.

# Prints the env var value
[System.Environment]::GetEnvironmentVariable('ENVIRONMENT_VARIABLE_KEY')

Bash

Utilisez la commande suivante pour créer et affecter une variable d’environnement persistante, en fonction de la valeur d’entrée.

# Assigns the env var to the value
echo export ENVIRONMENT_VARIABLE_KEY="value" >> /etc/environment && source /etc/environment

Dans une nouvelle instance de Bash, utilisez la commande suivante pour lire la variable d’environnement.

# Prints the env var value
echo "${ENVIRONMENT_VARIABLE_KEY}"

# Or use printenv:
# printenv ENVIRONMENT_VARIABLE_KEY

Conseil

Après avoir défini une variable d’environnement, redémarrez votre environnement de développement intégré (IDE) pour vous assurer que les variables d’environnement nouvellement ajoutées sont disponibles.

Extraire une variable d’environnement

Pour utiliser une variable d’environnement dans votre code, elle doit être lue dans la mémoire. Utilisez l’un des extraits de code suivants, selon la langue que vous utilisez. Ces extraits de code montrent comment obtenir une variable d’environnement en fonction de ENVIRONMENT_VARIABLE_KEY et comment affecter la valeur à une variable de programme nommée value.

C#

Pour plus d’informations, consultez Environment.GetEnvironmentVariable .

using static System.Environment;

class Program
{
    static void Main()
    {
        // Get the named env var, and assign it to the value variable
        var value =
            GetEnvironmentVariable(
                "ENVIRONMENT_VARIABLE_KEY");
    }
}

C++

Pour plus d’informations, consultez getenv_s et getenv.

#include <iostream> 
#include <stdlib.h>

std::string GetEnvironmentVariable(const char* name);

int main()
{
    // Get the named env var, and assign it to the value variable
    auto value = GetEnvironmentVariable("ENVIRONMENT_VARIABLE_KEY");
}

std::string GetEnvironmentVariable(const char* name)
{
#if defined(_MSC_VER)
    size_t requiredSize = 0;
    (void)getenv_s(&requiredSize, nullptr, 0, name);
    if (requiredSize == 0)
    {
        return "";
    }
    auto buffer = std::make_unique<char[]>(requiredSize);
    (void)getenv_s(&requiredSize, buffer.get(), requiredSize, name);
    return buffer.get();
#else
    auto value = getenv(name);
    return value ? value : "";
#endif
}

Java

Pour plus d’informations, consultez System.getenv .

import java.lang.*;

public class Program {
   public static void main(String[] args) throws Exception {
    // Get the named env var, and assign it to the value variable
    String value =
        System.getenv(
            "ENVIRONMENT_VARIABLE_KEY")
   }
}

Node.JS

Pour plus d’informations, consultez process.env .

// Get the named env var, and assign it to the value variable
const value =
    process.env.ENVIRONMENT_VARIABLE_KEY;

Python

Pour plus d’informations, consultez os.environ .

import os

# Get the named env var, and assign it to the value variable
value = os.environ['ENVIRONMENT_VARIABLE_KEY']

Objective-C

Pour plus d’informations, consultez environment .

// Get the named env var, and assign it to the value variable
NSString* value =
    [[[NSProcessInfo processInfo]environment]objectForKey:@"ENVIRONMENT_VARIABLE_KEY"];

Étapes suivantes

• Explorez Azure AI services et choisissez un service pour commencer.