Foundry IQ (Azure AI 검색)에서 역할 기반 액세스 제어를 사용하거나 사용하지 않도록 설정

메모

Foundry IQ (Azure AI 검색)는 관리형 검색을 위한 상위 수준의 지식 원본 및 지식 베이스 API와 함께 직접 인덱싱 및 쿼리 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.

이 문서에서는 Azure AI 검색(Foundry IQ)에서 데이터 평면 작업에 RBAC(역할 기반 액세스 제어)를 사용하도록 설정하는 방법을 설명합니다. RBAC를 사용하도록 설정하면 API 키 대신 Microsoft Entra ID 인증을 사용할 수 있습니다.

중요한

Foundry IQ 서비스를 생성할 때 키 기반 인증이 기본이지만 가장 안전한 옵션은 아닙니다. 이 문서에 설명된 대로 역할 기반 액세스로 바꾸는 것이 좋습니다.

데이터 평면 역할만 사용하지 않도록 설정할 수 있습니다. 서비스 관리(컨트롤 플레인)에 대한 역할이 기본 제공되며 사용하거나 사용하지 않도록 설정할 수 없습니다.

역할 전용 Foundry IQ 서비스의 활동 로그에서 Get Admin Keys와 같은 키 관련 활동이 확인되는 경우, 해당 작업은 제어 평면에서 시작되며 사용자의 콘텐츠 또는 콘텐츠 관련 작업에는 영향을 주지 않습니다.

필수 조건

  • 무료를 포함하여 모든 계층의 모든 지역의 Foundry IQ 서비스입니다.
  • 소유자, 사용자 액세스 관리자 또는 RBAC를 사용하도록 설정할 수 있는 Microsoft.Authorization/roleAssignments/write 권한이 있는 사용자 지정 역할.
  • RBAC를 사용하도록 설정한 후 콘텐츠에 액세스하려면 데이터 평면 역할이 필요합니다. Search Service 기여자, 검색 인덱스 데이터 기여자 및 검색 인덱스 데이터 판독기. 자세한 내용은 역할 할당 을 참조하세요.

데이터 평면 작업에 대한 역할 기반 액세스 사용

OAuth2 액세스 토큰을 제공하는 데이터 요청에서 Authorization 헤더를 인식하도록 Foundry IQ 서비스를 구성합니다.

데이터 평면에 역할을 사용하도록 설정하면 변경 내용이 즉시 적용되지만 역할을 할당하기 전에 몇 초 정도 기다립니다.

권한이 없는 요청에 대한 기본 오류 모드는 http401WithBearerChallenge입니다. 또는 실패 모드를 http403(으)로 설정할 수 있습니다.

  1. Azure 포털에서 Foundry IQ 서비스로 이동합니다.

  2. 설정을 선택한 다음 왼쪽 창에서 키를 선택합니다.

    인증 옵션이 있는 키 페이지의 스크린샷.

  3. 역할 기반 컨트롤을 선택합니다. 현재 키를 사용하고 있고 클라이언트를 역할 기반 액세스 제어로 전환하는 데 시간이 필요한 경우에만 둘 다 선택합니다.

    옵션 설명
    API 키(기본값) 권한 부여를 위해 요청 헤더에 API 키가 필요합니다.
    역할 기반 액세스 제어(권장) 작업을 완료하려면 역할 할당의 멤버 자격이 필요합니다. 요청의 인증 헤더도 필요합니다.
    모두 요청은 API 키 또는 역할 기반 액세스 제어를 사용하면 유효하지만 동일한 요청에 둘 다 제공하는 경우 API 키가 사용됩니다.
  4. 관리자로서 역할 전용 접근 방식을 선택하는 경우 사용자 계정에 데이터 평면 역할을 할당하여 Azure Portal에서 데이터 평면 작업에 대한 전체 관리 액세스를 복원합니다. 역할에는 Search Service 기여자, 검색 인덱스 데이터 기여자 및 검색 인덱스 데이터 읽기 권한자 등이 있습니다. 동등한 액세스 권한을 원하는 경우 처음 두 역할이 필요합니다.

    간혹 역할 할당이 적용되는 데 5~10분이 걸릴 수 있습니다. 그때까지 데이터 평면 작업에 사용되는 Azure 포털 페이지에 다음 메시지가 표시됩니다.

    권한이 부족함을 나타내는 포털 메시지의 스크린샷.

역할 기반 액세스 제어 사용 안 함

데이터 평면 작업에 대한 역할 기반 액세스 제어를 사용하지 않도록 설정하고 대신 키 기반 인증을 사용할 수 있습니다. 예를 들어 권한 문제를 배제하기 위해 테스트 워크플로의 일부로 이 작업을 수행할 수 있습니다.

Azure Portal에서 역할 기반 액세스 제어를 사용하지 않도록 설정하려면 다음을 수행합니다.

  1. Azure 포털에서 Foundry IQ 서비스로 이동합니다.

  2. 설정을 선택한 다음 왼쪽 창에서 키를 선택합니다.

  3. API 키를 선택합니다.

API 키 인증 사용 안 함

기본 제공 역할 및 Microsoft Entra 인증만 전적으로 사용하는 경우 서비스에서 키 액세스 또는 로컬 인증을 비활성화할 수 있습니다. API 키를 사용하지 않도록 설정하면 Foundry IQ 서비스가 헤더에 API 키를 전달하는 모든 데이터 관련 요청을 거부합니다.

관리자 API 키는 사용하지 않도록 설정할 수 있지만 삭제할 수는 없습니다. 쿼리 API 키는 삭제할 수 있습니다.

보안 기능을 사용하지 않도록 설정하려면 소유자 또는 기여자 권한이 필요합니다.

  1. Azure 포털에서 Foundry IQ 서비스로 이동합니다.

  2. 왼쪽 탐색 창에서 키를 선택합니다.

  3. 역할 기반 액세스 제어를 선택합니다.

변경 내용은 즉시 적용되지만 테스트하기 전에 몇 초 정도 기다립니다. 소유자, 서비스 관리자 또는 공동 관리자의 구성원으로 역할을 할당할 수 있는 권한이 있다고 가정하면 포털 기능을 사용하여 역할 기반 액세스를 테스트할 수 있습니다.

다음 단계