Использование переменных среды со службами ИИ Azure

В этом руководстве показано, как задать и получить переменные среды для учетных данных служб ИИ Azure при тестировании приложений.

Внимание

Мы рекомендуем использовать проверку подлинности Идентификатора Microsoft Entra с управляемыми удостоверениями для ресурсов Azure, чтобы избежать хранения учетных данных с приложениями, работающими в облаке.

Используйте ключи API с осторожностью. Не включайте ключ API непосредственно в код и никогда не публикуйте его. При использовании ключей API безопасно храните их в Azure Key Vault, регулярно поворачивайте ключи и ограничьте доступ к Azure Key Vault с помощью управления доступом на основе ролей и ограничений доступа к сети. Дополнительные сведения об использовании ключей API безопасно в приложениях см. в разделе "Ключи API" с помощью Azure Key Vault.

Дополнительные сведения о безопасности служб ИИ см. в статье "Проверка подлинности запросов к службам ИИ Azure".

Указание переменной среды

Чтобы задать переменные среды, выполните одну из следующих команд, где ENVIRONMENT_VARIABLE_KEY — это именованный ключ, а value — значение, хранящееся в переменной среды.

Командная строка

Используйте следующую команду, чтобы создать и назначить хранимую переменную среды со входным значением.

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

В новом экземпляре командной строки считайте эту переменную среды, используя приведенную ниже команду.

:: Prints the env var value
echo %ENVIRONMENT_VARIABLE_KEY%

PowerShell

Используйте следующую команду, чтобы создать и назначить хранимую переменную среды со входным значением.

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

В новом экземпляре Windows PowerShell считайте эту переменную среды, используя приведенную ниже команду.

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

Bash

Используйте следующую команду, чтобы создать и назначить хранимую переменную среды со входным значением.

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

В новом экземпляре Bash считайте эту переменную среды, используя приведенную ниже команду.

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

# Or use printenv:
# printenv ENVIRONMENT_VARIABLE_KEY

Совет

После указания переменной среды перезапустите интегрированную среду разработки, чтобы гарантировать доступность добавленных переменных среды.

Получение переменной среды

Чтобы использовать переменную среды в коде, ее необходимо считать в память. Используйте один из следующих фрагментов кода в зависимости от используемого языка. В этих фрагментах кода показано, как получить переменную среды с учетом ENVIRONMENT_VARIABLE_KEY и назначить значение программной переменной с именем value.

C#

Дополнительные сведения см. в разделе 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++

Дополнительные сведения см. в разделах getenv_s и 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

Дополнительные сведения см. в разделе 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

Дополнительные сведения см. в разделе process.env .

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

Python

Дополнительные сведения см. в разделе os.environ .

import os

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

Objective-C

Дополнительные сведения см. в разделе environment .

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

Следующие шаги

• Изучите службы ИИ Azure и выберите службу для начала работы.