Azure AI 서비스와 함께 환경 변수 사용

이 가이드에서는 애플리케이션을 테스트할 때 Azure AI 서비스 자격 증명에 대한 환경 변수를 설정하고 검색하는 방법을 보여 줍니다.

Important

클라우드에서 실행되는 애플리케이션에 자격 증명을 저장하지 않으려면 Microsoft Entra ID 인증과 함께 Azure 리소스에 대한 관리 ID를 사용하는 것이 좋습니다.

주의해서 API 키를 사용합니다. API 키를 코드에 직접 포함하지 말고, 공개적으로 게시하지 마세요. API 키를 사용하는 경우 Azure Key Vault에 안전하게 저장하고, 정기적으로 키를 회전하고, 역할 기반 액세스 제어 및 네트워크 액세스 제한을 사용하여 Azure Key Vault에 대한 액세스를 제한합니다. 앱에서 API 키를 안전하게 사용하는 방법에 대한 자세한 내용은 Azure Key Vault를 사용하여 API 키를 참조하세요.

AI 서비스 보안에 대한 자세한 내용은 Azure AI 서비스에 대한 요청 인증을 참조하세요.

환경 변수 설정

환경 변수를 설정하려면 다음 명령 중 하나를 사용합니다. 여기서 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

팁

환경 변수를 설정한 후에는 IDE(통합 개발 환경)를 다시 시작하여 새로 추가된 환경 변수를 사용할 수 있는지 확인하세요.

환경 변수 검색

코드에서 환경 변수를 사용하려면 메모리로 읽어야 합니다. 사용 중인 언어에 따라 다음 코드 조각 중 하나를 사용합니다. 이러한 코드 조각은 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 AI 서비스를 살펴보고 시작할 서비스를 선택합니다.