Verwenden von Umgebungsvariablen mit Azure KI Services

In diesem Leitfaden erfahren Sie, wie Sie Umgebungsvariablen für Ihre Azure KI Services-Anmeldeinformationen festlegen und abrufen, wenn Sie Anwendungen testen.

Wichtig

Es wird empfohlen, die Microsoft Entra ID-Authentifizierung mit verwalteten Identitäten für Azure-Ressourcen zu kombinieren, um das Speichern von Anmeldeinformationen mit den in der Cloud ausgeführten Anwendungen zu vermeiden.

Verwenden Sie API-Schlüssel mit Vorsicht. Fügen Sie den API-Schlüssel nicht direkt in Ihren Code ein, und machen Sie ihn nicht öffentlich zugänglich. Wenn Sie API-Schlüssel verwenden, speichern Sie sie sicher in Azure Key Vault, rotieren Sie die Schlüssel regelmäßig, und beschränken Sie den Zugriff auf Azure Key Vault mithilfe von rollenbasierter Zugriffssteuerung und Netzwerkzugriffsbeschränkungen. Weitere Informationen zur sicheren Verwendung von API-Schlüsseln in Ihren Apps finden Sie unter API-Schlüssel mit Azure Key Vault.

Weitere Informationen zur Sicherheit von KI Services finden Sie unter Authentifizieren von Anforderungen an Azure KI Services.

Festlegen einer Umgebungsvariable

Verwenden Sie zum Festlegen von Umgebungsvariablen einen der folgenden Befehle. ENVIRONMENT_VARIABLE_KEY ist hierbei der benannte Schlüssel, und value ist der in der Umgebungsvariable gespeicherte Wert.

Befehlszeile

Verwenden Sie den folgenden Befehl, um aus dem angegebenen Eingabewert eine permanente Umgebungsvariable zu erstellen und zuzuweisen.

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

Verwenden Sie in einer neuen Instanz der Eingabeaufforderung den folgenden Befehl, um die Umgebungsvariable zu lesen.

:: Prints the env var value
echo %ENVIRONMENT_VARIABLE_KEY%

PowerShell

Verwenden Sie den folgenden Befehl, um aus dem angegebenen Eingabewert eine permanente Umgebungsvariable zu erstellen und zuzuweisen.

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

Verwenden Sie in einer neuen Instanz von Windows PowerShell den folgenden Befehl, um die Umgebungsvariable zu lesen.

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

Bash

Verwenden Sie den folgenden Befehl, um aus dem angegebenen Eingabewert eine permanente Umgebungsvariable zu erstellen und zuzuweisen.

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

Verwenden Sie in einer neuen Instanz der Bash den folgenden Befehl, um die Umgebungsvariable zu lesen.

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

# Or use printenv:
# printenv ENVIRONMENT_VARIABLE_KEY

Tipp

Führen Sie nach dem Festlegen einer Umgebungsvariable einen Neustart Ihrer integrierten Entwicklungsumgebung (Integrated Development Environment, IDE) aus, um sicherzustellen, dass die neu hinzugefügten Umgebungsvariablen verfügbar sind.

Abrufen einer Umgebungsvariable

Damit Sie eine Umgebungsvariable in Ihrem Code verwenden können, muss sie in den Arbeitsspeicher gelesen werden. Verwenden Sie einen der folgenden Codeschnipsel, je nach der verwendeten Sprache. In diesen Codeschnipseln wird gezeigt, wie Sie eine Umgebungsvariable mit ENVIRONMENT_VARIABLE_KEY abrufen und den Wert einer Programmvariablen namens value zuweisen.

C#

Weitere Informationen finden Sie unter 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++

Weitere Informationen finden Sie unter getenv_s und 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

Weitere Informationen finden Sie unter 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

Weitere Informationen finden Sie unter process.env .

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

Python

Weitere Informationen finden Sie unter os.environ .

import os

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

Objective-C

Weitere Informationen finden Sie unter environment .

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

Nächste Schritte

• Erkunden Sie Azure KI Services, und wählen Sie einen Dienst aus, um einzusteigen.