이 페이지에서는 지원되는 인증 방법 및 클라이언트에 대한 정보와 Service Connector를 사용하여 Azure AI 다중 서비스 리소스를 다른 클라우드 서비스에 연결하기 위한 샘플 코드를 제공합니다. 이 페이지에는 서비스 연결을 만들 때 얻은 기본 환경 변수 이름 및 값도 나열됩니다.
지원되는 컴퓨팅 서비스
서비스 커넥터를 사용하여 다음 컴퓨팅 서비스를 Azure AI 다중 서비스 리소스에 연결할 수 있습니다.
Azure App Service
Azure Container Apps
Azure 기능
AKS(Azure Kubernetes Service)
Azure Spring Apps
지원되는 인증 유형 및 클라이언트 유형
아래 표는 Service Connector를 사용하여 컴퓨팅 서비스를 Azure AI 다중 서비스 리소스에 연결하는 데 지원되는 인증 방법 및 클라이언트를 나타냅니다. "예"는 조합이 지원됨을 나타내고 "아니오"는 지원되지 않음을 나타냅니다.
클라이언트 유형
시스템 할당 관리 ID
사용자 할당 관리 ID
비밀/연결 문자열
서비스 사용자
.NET
예
예
예
예
Java
예
예
예
예
Node.JS
예
예
예
예
Python
예
예
예
예
없음
예
예
예
예
이 표는 표에 있는 클라이언트 유형과 모든 인증 방법 조합이 지원됨을 나타냅니다. 모든 클라이언트 유형은 인증 방법 중 하나를 사용하여 서비스 커넥터를 사용하여 Azure AI 다중 서비스 리소스에 연결할 수 있습니다.
기본 환경 변수 이름 또는 애플리케이션 속성과 샘플 코드
아래 연결 세부 정보를 사용하여 컴퓨팅 서비스를 Azure AI 다중 서비스 리소스에 연결합니다. 명명 규칙에 대한 자세한 내용은 Service Connector 내부 문서를 참조 하세요 .
시스템이 할당한 관리 ID를 사용하여 Azure AI 다중 서비스 리소스에 연결하려면 아래 단계 및 코드를 참조하세요.
Azure 클라이언트 라이브러리를 사용하여 Azure AI 다중 서비스 리소스에서 지원하는 다양한 인식 API에 액세스할 수 있습니다. 이 샘플에서는 Azure AI Text Analytics를 예제로 사용합니다. 인식 API를 직접 호출하려면 Azure AI 서비스에 대한 요청 인증을 참조하세요.
Azure ID 라이브러리를 사용하여 인증하고 서비스 커넥터에서 추가한 환경 변수에서 Azure AI 다중 서비스 리소스 엔드포인트를 가져옵니다. 아래 코드를 사용하는 경우 사용하려는 인증 유형에 대한 코드 조각 부분의 주석 처리를 제거합니다.
using Azure.AI.TextAnalytics;
using Azure.Identity;
string endpoint = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_ENDPOINT");
// Uncomment the following lines corresponding to the authentication type you want to use.
// system-assigned managed identity
// var credential = new DefaultAzureCredential();
// user-assigned managed identity
// var credential = new DefaultAzureCredential(
// new DefaultAzureCredentialOptions
// {
// ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
// });
// service principal
// var tenantId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTSECRET");
// var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
TextAnalyticsClient languageServiceClient = new(
new Uri(endpoint),
credential);
pom.xml 파일에 다음 종속성을 추가합니다.
azure-ai-textanalytics을(를) 예제로 사용합니다.
azure-identity을(를) 사용하여 인증하고 서비스 커넥터에서 추가한 환경 변수에서 Azure AI 다중 서비스 리소스 엔드포인트를 가져옵니다. 아래 코드를 사용하는 경우 사용하려는 인증 유형에 대한 코드 조각 부분의 주석 처리를 제거합니다.
// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
// for user-assigned managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
// .managedIdentityClientId(System.getenv("AZURE_COGNITIVESERVICES_CLIENTID"))
// .build();
// for service principal
// ClientSecretCredential credential = new ClientSecretCredentialBuilder()
// .clientId(System.getenv("AZURE_COGNITIVESERVICES_CLIENTID"))
// .clientSecret(System.getenv("AZURE_COGNITIVESERVICES_CLIENTSECRET"))
// .tenantId(System.getenv("AZURE_COGNITIVESERVICES_TENANTID"))
// .build();
String endpoint = System.getenv("AZURE_COGNITIVESERVICES_ENDPOINT");
TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
.credential(credential)
.endpoint(endpoint)
.buildClient();
다음 종속성을 설치합니다.
azure-ai-textanalytics을(를) 예제로 사용합니다.
사용자가 할당한 관리 ID를 사용하여 Azure AI 다중 서비스 리소스에 연결하려면 아래 단계 및 코드를 참조하세요.
Azure 클라이언트 라이브러리를 사용하여 Azure AI 다중 서비스 리소스에서 지원하는 다양한 인식 API에 액세스할 수 있습니다. 이 샘플에서는 Azure AI Text Analytics를 예제로 사용합니다. 인식 API를 직접 호출하려면 Azure AI 서비스에 대한 요청 인증을 참조하세요.
Azure ID 라이브러리를 사용하여 인증하고 서비스 커넥터에서 추가한 환경 변수에서 Azure AI 다중 서비스 리소스 엔드포인트를 가져옵니다. 아래 코드를 사용하는 경우 사용하려는 인증 유형에 대한 코드 조각 부분의 주석 처리를 제거합니다.
using Azure.AI.TextAnalytics;
using Azure.Identity;
string endpoint = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_ENDPOINT");
// Uncomment the following lines corresponding to the authentication type you want to use.
// system-assigned managed identity
// var credential = new DefaultAzureCredential();
// user-assigned managed identity
// var credential = new DefaultAzureCredential(
// new DefaultAzureCredentialOptions
// {
// ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
// });
// service principal
// var tenantId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTSECRET");
// var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
TextAnalyticsClient languageServiceClient = new(
new Uri(endpoint),
credential);
pom.xml 파일에 다음 종속성을 추가합니다.
azure-ai-textanalytics을(를) 예제로 사용합니다.
azure-identity을(를) 사용하여 인증하고 서비스 커넥터에서 추가한 환경 변수에서 Azure AI 다중 서비스 리소스 엔드포인트를 가져옵니다. 아래 코드를 사용하는 경우 사용하려는 인증 유형에 대한 코드 조각 부분의 주석 처리를 제거합니다.
// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
// for user-assigned managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
// .managedIdentityClientId(System.getenv("AZURE_COGNITIVESERVICES_CLIENTID"))
// .build();
// for service principal
// ClientSecretCredential credential = new ClientSecretCredentialBuilder()
// .clientId(System.getenv("AZURE_COGNITIVESERVICES_CLIENTID"))
// .clientSecret(System.getenv("AZURE_COGNITIVESERVICES_CLIENTSECRET"))
// .tenantId(System.getenv("AZURE_COGNITIVESERVICES_TENANTID"))
// .build();
String endpoint = System.getenv("AZURE_COGNITIVESERVICES_ENDPOINT");
TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
.credential(credential)
.endpoint(endpoint)
.buildClient();
다음 종속성을 설치합니다.
azure-ai-textanalytics을(를) 예제로 사용합니다.
연결 문자열을 사용하여 Azure AI 다중 서비스 리소스에 연결하려면 아래 단계 및 코드를 참조하세요.
Azure 클라이언트 라이브러리를 사용하여 Azure AI 다중 서비스 리소스에서 지원하는 다양한 인식 API에 액세스할 수 있습니다. 이 샘플에서는 Azure AI Text Analytics를 예제로 사용합니다. 인식 API를 직접 호출하려면 Azure AI 서비스에 대한 요청 인증을 참조하세요.
서비스 주체를 사용하여 Azure AI 다중 서비스 리소스에 연결하려면 아래 단계 및 코드를 참조하세요.
Azure 클라이언트 라이브러리를 사용하여 Azure AI 다중 서비스 리소스에서 지원하는 다양한 인식 API에 액세스할 수 있습니다. 이 샘플에서는 Azure AI Text Analytics를 예제로 사용합니다. 인식 API를 직접 호출하려면 Azure AI 서비스에 대한 요청 인증을 참조하세요.
Azure ID 라이브러리를 사용하여 인증하고 서비스 커넥터에서 추가한 환경 변수에서 Azure AI 다중 서비스 리소스 엔드포인트를 가져옵니다. 아래 코드를 사용하는 경우 사용하려는 인증 유형에 대한 코드 조각 부분의 주석 처리를 제거합니다.
using Azure.AI.TextAnalytics;
using Azure.Identity;
string endpoint = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_ENDPOINT");
// Uncomment the following lines corresponding to the authentication type you want to use.
// system-assigned managed identity
// var credential = new DefaultAzureCredential();
// user-assigned managed identity
// var credential = new DefaultAzureCredential(
// new DefaultAzureCredentialOptions
// {
// ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
// });
// service principal
// var tenantId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_TENANTID");
// var clientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
// var clientSecret = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTSECRET");
// var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
TextAnalyticsClient languageServiceClient = new(
new Uri(endpoint),
credential);
pom.xml 파일에 다음 종속성을 추가합니다.
azure-ai-textanalytics을(를) 예제로 사용합니다.
azure-identity을(를) 사용하여 인증하고 서비스 커넥터에서 추가한 환경 변수에서 Azure AI 다중 서비스 리소스 엔드포인트를 가져옵니다. 아래 코드를 사용하는 경우 사용하려는 인증 유형에 대한 코드 조각 부분의 주석 처리를 제거합니다.
// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
// for user-assigned managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
// .managedIdentityClientId(System.getenv("AZURE_COGNITIVESERVICES_CLIENTID"))
// .build();
// for service principal
// ClientSecretCredential credential = new ClientSecretCredentialBuilder()
// .clientId(System.getenv("AZURE_COGNITIVESERVICES_CLIENTID"))
// .clientSecret(System.getenv("AZURE_COGNITIVESERVICES_CLIENTSECRET"))
// .tenantId(System.getenv("AZURE_COGNITIVESERVICES_TENANTID"))
// .build();
String endpoint = System.getenv("AZURE_COGNITIVESERVICES_ENDPOINT");
TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
.credential(credential)
.endpoint(endpoint)
.buildClient();
다음 종속성을 설치합니다.
azure-ai-textanalytics을(를) 예제로 사용합니다.