Usar variáveis de ambiente com os serviços de IA do Azure

Este guia mostra como definir e recuperar variáveis de ambiente para suas credenciais de serviços de IA do Azure ao testar aplicativos.

Importante

Recomendamos a autenticação do Microsoft Entra ID com identidades gerenciadas para recursos do Azure para evitar o armazenamento de credenciais com seus aplicativos executados na nuvem.

Use chaves de API com cuidado. Não inclua a chave da API diretamente no seu código e nunca a publique publicamente. Se estiver usando chaves de API, armazene-as com segurança no Cofre de Chaves do Azure, gire as chaves regularmente e restrinja o acesso ao Cofre de Chaves do Azure usando controle de acesso baseado em função e restrições de acesso à rede. Para obter mais informações sobre como usar chaves de API com segurança em seus aplicativos, consulte Chaves de API com o Cofre de Chaves do Azure.

Para obter mais informações sobre segurança de serviços de IA, consulte Autenticar solicitações para serviços de IA do Azure.

Definir uma variável de ambiente

Para definir variáveis de ambiente, use um dos seguintes comandos, onde o ENVIRONMENT_VARIABLE_KEY é a chave nomeada e value é o valor armazenado na variável de ambiente.

Linha de Comandos

Use o comando a seguir para criar e atribuir uma variável de ambiente persistente, dado o valor de entrada.

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

Em uma nova instância do prompt de comando, use o seguinte comando para ler a variável de ambiente.

:: Prints the env var value
echo %ENVIRONMENT_VARIABLE_KEY%

PowerShell

Use o comando a seguir para criar e atribuir uma variável de ambiente persistente, dado o valor de entrada.

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

Em uma nova instância do Windows PowerShell, use o comando a seguir para ler a variável de ambiente.

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

Bash

Use o comando a seguir para criar e atribuir uma variável de ambiente persistente, dado o valor de entrada.

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

Em uma nova instância do Bash, use o seguinte comando para ler a variável de ambiente.

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

# Or use printenv:
# printenv ENVIRONMENT_VARIABLE_KEY

Gorjeta

Depois de definir uma variável de ambiente, reinicie o ambiente de desenvolvimento integrado (IDE) para garantir que as variáveis de ambiente recém-adicionadas estejam disponíveis.

Recuperar uma variável de ambiente

Para usar uma variável de ambiente em seu código, ela deve ser lida na memória. Use um dos seguintes trechos de código, dependendo do idioma que você está usando. Esses trechos de código demonstram como obter uma variável de ambiente dada e ENVIRONMENT_VARIABLE_KEY atribuir o valor a uma variável de programa chamada value.

C#

Para obter mais informações, veja 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++

Para obter mais informações, consulte getenv_s e 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

Para obter mais informações, veja 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

Para obter mais informações, veja process.env .

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

Python

Para obter mais informações, veja os.environ .

import os

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

Objective-C

Para obter mais informações, veja environment .

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

Próximos passos

• Explore os serviços de IA do Azure e escolha um serviço para começar.