OAuth 동적 클라이언트 등록 구성
마지막 업데이트: 2026. 10. 20.OAuth Dynamic Client Registration(DCR)은 호환되는 OAuth 클라이언트 애플리케이션이 OAuth 클라이언트를 동적으로 등록할 수 있도록 지원하는 테넌트 수준의 OAuth 기능입니다.이러한 맥락에서 호환 가능한 OAuth 클라이언트 애플리케이션은 OAuth 2.0 DCR 프로토콜을 지원하고 테넌트 정책 요구 사항을 충족하는 애플리케이션입니다.
DCR의 주요 사용 사례는 Model Context Protocol(MCP) 서버 클라이언트를 연결하는 것이지만, 호환되는 다른 서드파티 애플리케이션에 사용할 수도 있습니다.
MCP 클라이언트에 연결하는 추가 방법은 OAuth 클라이언트 생성 방법 선택을(를) 참조하세요.
게시와 동의는 별도의 제어 항목입니다:
-
게시는 동일한 리전의 다른 테넌트가 OAuth 클라이언트를 사용할 수 있는지 여부를 제한합니다.
-
동의 방법(필수 또는 신뢰할 수 있음)은 권한 부여 중에 사용자에게 프롬프트가 표시되는지 여부를 제어합니다.
게시 제약 조건을 포함한 수동 설정 및 동의 동작에 대한 자세한 내용은 OAuth 클라이언트 만들기 및 OAuth 클라이언트 만들기 및 관리을(를) 참조하세요.
사전 요구 사항 및 주의 사항
전제 조건:
-
귀하는 Qlik Cloud의 테넌트 관리자입니다.
주의 사항:
-
DCR이 활성화되면 호환되는 OAuth 클라이언트 애플리케이션이 DCR 정책에 따라 테넌트에 OAuth 클라이언트 등록을 요청할 수 있습니다.프로덕션에서 DCR을 활성화하기 전에 허용된 인증 방법과 승인 프로세스를 검토하십시오.
-
DCR로 생성된 클라이언트에는 초기에 user_default, mcp:execute 및 offline_access 스코프가 할당됩니다.이러한 범위에 대해 자세히 알아보려면 Qlik 개발자 포털의 범위에서 전체 범위 목록을 참조하십시오.
-
승인되지 않은 DCR 클라이언트는 1시간 후에 자동으로 삭제됩니다.해당 기간 내에 테넌트 관리자가 타사 애플리케이션에서 클라이언트를 승인하지 않으면 클라이언트가 삭제되며 사용자는 연결을 다시 생성해야 합니다.
DCR 설정 구성
Dynamic Client Registration 설정을 구성하여 OAuth 클라이언트 애플리케이션이 테넌트에서 OAuth 클라이언트를 등록하는 방식을 제어합니다.
Qlik Cloud에서 DCR 구성하기
다음을 수행합니다.
-
관리 활동 센터에서 설정 > 보안으로 이동합니다.
-
동적 클라이언트 등록을 활성화합니다.
DCR이 비활성화된 경우 새 클라이언트를 동적으로 등록할 수 없습니다.기존에 동적으로 등록된 클라이언트는 수동으로 제거하거나 승인을 취소할 때까지 계속 정상적으로 작동합니다.
-
허용된 인증 방법에서 동적으로 등록된 클라이언트가 사용할 수 있는 인증 방법을 선택합니다:
-
클라이언트 암호: 보안 백엔드가 있는 웹 애플리케이션과 같은 기밀 클라이언트를 허용합니다.
-
클라이언트 암호 + 없음: 기밀 클라이언트 및 퍼블릭 클라이언트를 모두 허용합니다.
-
없음: 단일 페이지 애플리케이션 또는 네이티브 애플리케이션과 같은 퍼블릭 클라이언트를 허용합니다.
정책에서 허용하지 않는 방식으로 등록을 시도하는 애플리케이션은 거부됩니다.
이러한 인증 방법에 대한 자세한 내용은 다음 섹션 인증 방법을 참조하세요.
-
OAuth 클라이언트 앱에서 DCR 구성하기
Qlik Cloud에서 DCR을 구성한 후, OAuth 클라이언트 애플리케이션에서 DCR 연결을 구성하십시오.연결 세부 정보는 사용 사례에 따라 다릅니다.
다음을 수행합니다.
-
OAuth 클라이언트 애플리케이션에서 연결을 구성할 때 사용 사례에 맞는 연결 URL을 사용하십시오:
사용 사례 연결 URL 형식 MCP 또는 GenAI 클라이언트 https://<tenant-id>.<region>.qlikcloud.com/api/ai/mcp MCP 구성 정보에 대한 자세한 내용은 다음을 참조하십시오. Qlik MCP 서버에 연결.
기타 OAuth 클라이언트 애플리케이션 https://<tenant-id>.<region>.qlikcloud.com -
새로 등록된 DCR 클라이언트의 승인 및 동의 동작을 검토하십시오:
-
새 DCR 클라이언트를 사용하기 전에 명시적인 테넌트 승인이 필요한지 확인하십시오.타사 애플리케이션에서 메시지가 표시되면 승인하십시오.
-
첫 번째로 승인된 연결은 필수 동의를 사용합니다.
-
승인 후 Qlik Cloud에서 클라이언트를 편집하고, 보안 정책에 부합하는 경우 동의 방식을 신뢰할 수 있음으로 변경하십시오.
테넌트 승인은 귀하의 Qlik Cloud 테넌트와 OAuth 클라이언트 애플리케이션 간에 테넌트 수준의 신뢰를 구축합니다.테넌트 관리자가 연결하여 인증하고 동의 요청을 승인하면 다른 사용자는 자체 동의 승인을 거치지 않고도 동일한 OAuth 애플리케이션을 통해 Qlik Cloud에 연결할 수 있습니다.
동의 방식은 승인 후 클라이언트별로 관리됩니다.자세한 내용은 다음을 참조하십시오. OAuth 클라이언트 만들기 및 관리.
-
인증 방법
DCR 설정을 구성할 때 동적으로 등록된 클라이언트가 사용할 수 있는 인증 방식을 지정할 수 있습니다.다음 인증 방법을 사용할 수 있습니다:
-
클라이언트 암호: 클라이언트 암호를 사용하여 인증하는 기밀 클라이언트를 허용합니다.클라이언트는 등록 시 클라이언트 시크릿을 받습니다.여기에는 client_secret_basic 및 client_secret_post 인증 방식이 모두 포함됩니다.
-
없음: 클라이언트 암호를 사용하지 않는 퍼블릭 클라이언트를 허용합니다.이러한 클라이언트는 인증을 위해 PKCE(Proof Key for Code Exchange)가 포함된 인증 코드 흐름을 사용합니다.
기본적으로 동적으로 등록된 클라이언트는 등록 시 별도로 지정하지 않는 한 client_secret_basic 인증 방식을 사용합니다.
공급업체의 복수 등록 관리
많은 OAuth 클라이언트 애플리케이션은 Qlik Cloud에 단일 OAuth 클라이언트를 동적으로 등록합니다.애플리케이션 사용자는 동일한 OAuth 클라이언트를 공유합니다.
일부 OAuth 클라이언트 애플리케이션은 사용자당 하나씩 여러 OAuth 클라이언트를 동적으로 등록합니다.이러한 동작은 다음에서 확인되었습니다:
-
Anthropic Claude
-
반중력
동일한 공급업체의 DCR 클라이언트가 다수 표시되는 경우, 해당 OAuth 클라이언트 애플리케이션이 클라이언트를 등록하는 방식과 공유 커넥터 옵션을 사용할 수 있는지 검토하십시오.불필요한 DCR 클라이언트를 일괄 삭제하려면 OAuth 클라이언트 삭제을(를) 참조하십시오.
Claude 및 Claude Code는 다중 등록 문제를 방지하는 CIMD를 지원합니다.Claude에 연결을(를) 참조하십시오.
MCP 액세스 예제
DCR의 한 가지 사용 사례는 Qlik MCP 서버 통합을 위한 OAuth 클라이언트 온보딩입니다.DCR은 MCP에만 국한되지 않으며, 호환되는 다른 OAuth 클라이언트 애플리케이션에서도 사용할 수 있습니다.MCP 기반 연결의 경우, 일반적으로 테넌트 관리자가 다른 사용자가 연결하기 전에 첫 번째 연결을 생성하고 클라이언트를 승인합니다.
MCP 관리 및 연결 안내는 다음을 참조하세요:
OAuth 클라이언트 생성 후 관리(여러 공급업체 등록 처리, 일괄 삭제, DCR 또는 CIMD 클라이언트 식별 포함)에 대한 지침은 OAuth 클라이언트 관리을(를) 참조하십시오.