참고
Azure AI 검색 Azure 포털, REST API 및 Azure SDK 통해 사용할 수 있습니다. 또한 엔터프라이즈 콘텐츠를 Microsoft Foundry 포털의 에이전트에 대해 재사용 가능한 사용 권한 인식 기술 자료로 변환하는 관리되는 기술 계층인 Foundry IQ를 뒷받침합니다.
이 문서에서는 연결 문자열 자격 증명을 제공하는 대신 관리 ID를 사용하여 Azure Storage 계정에 대한 검색 서비스 연결을 구성하는 방법을 설명합니다.
시스템 할당 관리 ID 또는 사용자 할당 관리 ID를 사용할 수 있습니다. 관리 ID는 Microsoft Entra 로그인이며, Azure Storage에 액세스하려면 역할 할당이 필요합니다.
필수 구성 요소
- 관리 ID 있는 기본 계층 이상의 Azure AI 검색.
참고
스토리지가 네트워크로 보호되고 검색 서비스와 동일한 지역에 있는 경우 시스템 할당 관리 ID와 다음 네트워크 옵션 중 하나를 사용해야 합니다. 신뢰할 수 있는 서비스로 연결하거나 리소스 인스턴스 규칙을 사용하여 연결합니다.
Azure Storage 역할 할당 만들기
Azure 포털에 로그인하고 스토리지 계정을 찾습니다.
액세스 제어(IAM)를 선택합니다.
추가를 선택한 다음, 역할 할당을 선택합니다.
작업 함수 역할 목록에서 검색 서비스에 필요한 역할을 선택합니다.
작업 역할 할당 인덱서를 사용한 Blob 인덱싱 Storage Blob 데이터 판독기 추가 인덱서를 사용한 ADLS Gen2 인덱싱 Storage Blob 데이터 판독기 추가 인덱서로 테이블 인덱싱 스토리지 테이블 데이터 판독기 추가 인덱서로 파일 인덱싱 리더 및 데이터 액세스 추가 지식 저장소에 쓰기 개체 및 파일 프로젝션에 대한 Storage Blob 데이터 기여자 및 테이블 프로젝션에 대한 읽기 권한자 및 데이터 액세스를 추가합니다. 보강 캐시에 쓰기(미리 보기) Storage Blob 데이터 기여자 및 스토리지 테이블 데이터 기여자 추가 디버그 세션 상태 저장 Storage Blob 데이터 기여자 추가 다음을 선택합니다.
관리 ID를 선택한 다음 멤버를 선택합니다.
시스템 할당 관리 ID 또는 사용자 할당 관리 ID별로 필터링합니다. 검색 서비스에 대해 이전에 만든 관리 ID가 표시됩니다. 없는 경우 관리 ID를 사용하도록 검색 구성을 참조하세요. 이미 설정했지만 사용할 수 없는 경우 몇 분 정도 주세요.
ID를 선택하고 역할 할당을 저장합니다.
연결 문자열에서 관리되는 ID 지정
역할 할당이 있으면 해당 역할에서 작동하는 Azure Storage 대한 연결을 설정할 수 있습니다.
인덱서는 외부 데이터 원본에 대한 연결에 데이터 원본 개체를 사용합니다. 이 섹션에서는 데이터 원본 연결 문자열에서 시스템 할당된 관리 ID 또는 사용자 할당된 관리 ID를 지정하는 방법을 설명합니다. 관리 ID 문서에서 더 많은 연결 문자열 예제 찾을 수 있습니다.
팁
Azure 포털에서 Azure Storage 대한 데이터 원본 연결을 만들고 시스템 또는 사용자 할당 관리 ID를 지정한 다음 JSON 정의를 확인하여 연결 문자열 어떻게 작성되는지 확인할 수 있습니다.
시스템 할당 관리 ID
system 할당 관리 ID가 이미 구성되어 있어야 하며 Azure Storage 역할 할당이 있어야 합니다.
시스템 할당 관리 ID를 사용하여 만든 연결의 경우 데이터 원본 정의 에 대한 유일한 변경 내용은 속성의 credentials 형식입니다.
계정 키 또는 암호 없이 ResourceId 포함된 연결 문자열 제공합니다.
ResourceId 스토리지 계정의 구독 ID, 스토리지 계정의 리소스 그룹 및 스토리지 계정 이름을 포함해야 합니다.
POST https://[service name].search.windows.net/datasources?api-version=2026-04-01
{
"name" : "blob-datasource",
"type" : "azureblob",
"credentials" : {
"connectionString" : "ResourceId=/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/MY-DEMO-RESOURCE-GROUP/providers/Microsoft.Storage/storageAccounts/MY-DEMO-STORAGE-ACCOUNT/;"
},
"container" : {
"name" : "my-container", "query" : "<optional-virtual-directory-name>"
}
}
사용자 할당 관리 ID
사용자 할당 관리 ID가 이미 구성되어 있고 검색 서비스와 연결되어 있어야 하며 id에는 Azure Storage 대한 역할 할당이 있어야 합니다.
사용자 할당 관리 ID를 통한 연결은 시스템 할당 관리 ID와 동일한 자격 증명과 사용자 할당 관리 ID 컬렉션을 포함하는 추가 ID 속성을 사용합니다. 데이터 원본을 만들 때는 사용자 할당 관리 ID를 하나만 제공해야 합니다.
계정 키 또는 암호 없이 ResourceId 포함된 연결 문자열 제공합니다.
ResourceId 스토리지 계정의 구독 ID, 스토리지 계정의 리소스 그룹 및 스토리지 계정 이름을 포함해야 합니다.
다음 예제에 보여진 구문을 사용하여 identity를 제공합니다. 사용자 할당 관리 ID로 userAssignedIdentity를 설정합니다.
POST https://[service name].search.windows.net/datasources?api-version=2026-04-01
{
"name" : "blob-datasource",
"type" : "azureblob",
"credentials" : {
"connectionString" : "ResourceId=/subscriptions/00000000-0000-0000-0000-00000000/resourceGroups/MY-DEMO-RESOURCE-GROUP/providers/Microsoft.Storage/storageAccounts/MY-DEMO-STORAGE-ACCOUNT/;"
},
"container" : {
"name" : "my-container", "query" : "<optional-virtual-directory-name>"
},
"identity" : {
"@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
"userAssignedIdentity" : "/subscriptions/00000000-0000-0000-0000-00000000/resourcegroups/MY-DEMO-RESOURCE-GROUP/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MY-DEMO-USER-MANAGED-IDENTITY"
}
}
원격 서비스에 대한 연결 정보 및 권한은 인덱서를 실행하는 동안 런타임에 유효성을 검사합니다. 인덱서가 성공하면 연결 구문 및 역할 할당이 유효합니다. 자세한 내용은 인덱서, 기술 또는 문서 실행 또는 재설정을 참조하세요.
스토리지 계정에서 네트워크 보안 데이터 액세스
Azure 스토리지 계정은 방화벽 및 가상 네트워크를 사용하여 더욱 보호될 수 있습니다. 방화벽 또는 가상 네트워크를 사용하여 보호되는 스토리지 계정의 콘텐츠를 인덱싱하려면 Azure Storage 신뢰할 수 있는 서비스로 인덱서 연결을 연결합니다 참조하세요.