다른 작성자 및 편집자와 협업

QnA Maker 리소스에 배치된 Azure RBAC(Azure 역할 기반 액세스 제어)를 사용하여 다른 작성자 및 편집자와 협업합니다.

참고 항목

QnA Maker 서비스가 2025년 3월 31일부로 종료됩니다. 이제 최신 버전의 질문 및 답변 기능이 Azure AI 언어의 일부로 사용할 수 있습니다. 언어 서비스 내의 질문 답변 기능은 질문 답변을 참조하세요. 2022년 10월 1일부터 새로운 QnA Maker 리소스를 만들 수 없습니다. 기존 QnA Maker 기술 자료를 질문 답변으로 마이그레이션하는 방법에 대한 정보는 마이그레이션 가이드를 참조하세요.

액세스 권한은 QnA Maker 리소스에 제공됩니다.

모든 권한은 QnA Maker 리소스에 배치된 사용 권한에 의해 제어됩니다. 이러한 권한은 읽기, 쓰기, 게시 및 전체 액세스에 맞게 조정됩니다. QnA Maker 리소스에 대한 RBAC 액세스를 업데이트하여 여러 사용자 간의 협업을 허용할 수 있습니다.

이 Azure RBAC 기능에는 다음이 포함됩니다.

• Microsoft Entra ID는 소유자 및 기여자에 대한 키 기반 인증을 통해 이전 버전과 100% 호환됩니다. 고객은 요청에 키 기반 인증 또는 Azure RBAC 기반 인증을 사용할 수 있습니다.
• 제어가 기술 자료 수준이 아닌 리소스 수준에 있기 때문에 리소스의 모든 기술 자료에 작성자와 편집자를 빠르게 추가합니다.

참고 항목

리소스에 대한 사용자 지정 하위 도메인을 추가해야 합니다. 기본적으로 사용자 지정 하위 도메인이 있어야 합니다. 그렇지 않은 경우 추가하세요.

정의된 역할에 의해 액세스가 제공됩니다.

협업을 위해 제공되는 역할은 다음과 같습니다.

역할	기능	API 액세스	API 권한
담당자	모두	인증 키	모두
Cognitive Services 기여자	역할에 새 멤버를 추가하는 기능을 제외한 모든 기능	인증 키	역할에 새 멤버를 추가하는 기능을 제외한 모든 기능
Cognitive Services QnA Maker 읽기 권한자 (읽기)	내보내기/다운로드 테스트	전달자 토큰	1. KB API 다운로드 2. 사용자 API에 대한 KB 나열 3. 기술 자료 세부 정보 가져오기 4. 변경 사항 다운로드 답변 생성
Cognitive Services QnA Maker 편집기 (읽기/쓰기)	내보내기/다운로드 테스트 KB 업데이트 KB 내보내기 KB 가져오기 KB 바꾸기 기술 자료 만들기	전달자 토큰	1. KB API 만들기 2. KB API 업데이트 3. KB API 바꾸기 4. 변경 내용 바꾸기 5. "학습 API"[새 서비스 모델 v5]
Cognitive Services 사용자 (읽기/쓰기/게시)	모두	인증 키	다음 기능을 제외한 Azure AI 서비스 리소스에 대한 모든 액세스 권한: 1. 역할에 새 멤버를 추가합니다. 2. 새 리소스를 만듭니다.

인증 흐름

다음 다이어그램에서는 작성자의 관점에서 QnA Maker 포털에 로그인하고 작성 API를 사용하는 흐름을 보여 줍니다.

단계	설명
1	포털에서 QnA Maker 리소스에 대한 토큰을 가져옵니다.
2	포털은 키 대신 토큰을 전달하는 적절한 QnA Maker 작성 API(APIM)를 호출합니다.
3	QnA Maker API에서 토큰의 유효성을 검사합니다.
4	QnA Maker API에서 QnAMaker 서비스를 호출합니다.

작성 API를 호출하려는 경우 인증을 설정하는 방법에 대해 자세히 알아보세요.

QnA Maker 포털에서 인증

QnA Maker 포털을 사용하여 작성 및 협업하는 경우 협업자의 리소스에 적절한 역할을 추가하면 QnA Maker 포털에서 모든 액세스 권한을 관리할 수 있습니다.

QnA Maker API 및 SDK를 통해 인증

REST 또는 SDK를 통해 API를 사용하여 작성 및 협업하는 경우 인증을 관리하는 서비스 주체를 만들어야 합니다.

다음 단계

• 언어 및 클라이언트 애플리케이션에 대한 기술 자료 디자인