OAuth 동적 클라이언트 등록 구성
마지막 업데이트: 2026-11-18OAuth 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 설정 구성
OAuth 클라이언트 애플리케이션이 테넌트에서 OAuth 클라이언트를 등록하는 방식을 제어하도록 동적 클라이언트 등록 설정을 구성하십시오.
Qlik Cloud에서 DCR 구성하기
다음을 수행합니다.
-
관리 활동 센터에서 설정 > 보안으로 이동합니다.
-
동적 클라이언트 등록을 활성화합니다.
DCR이 비활성화된 경우, 새 클라이언트를 동적으로 등록할 수 없습니다.기존에 동적으로 등록된 클라이언트는 수동으로 제거하거나 승인을 취소할 때까지 계속 작동합니다.
-
허용된 인증 방법에서 동적으로 등록된 클라이언트가 사용할 수 있는 인증 방식을 선택합니다:
-
클라이언트 암호: 안전한 백엔드가 있는 웹 애플리케이션과 같은 기밀 클라이언트를 허용합니다.
-
Client secret + None: 기밀 클라이언트와 퍼블릭 클라이언트를 모두 허용합니다.
-
없음: 단일 페이지 애플리케이션 또는 네이티브 애플리케이션과 같은 퍼블릭 클라이언트를 허용합니다.
정책에서 허용하지 않는 방식으로 등록을 시도하는 애플리케이션은 거부됩니다.
이러한 인증 방법에 대한 자세한 내용은 다음 섹션 인증 방법을 참조하십시오.
-
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에서 클라이언트를 편집하고 보안 정책에 부합하는 경우 동의 방법을 Trusted로 변경하십시오.
테넌트 승인은 귀하의 Qlik Cloud 테넌트와 OAuth 클라이언트 애플리케이션 간에 테넌트 수준의 신뢰를 구축합니다.테넌트 관리자가 연결, 인증하고 동의 요청을 승인한 후에는 다른 사용자가 별도의 동의 승인을 받을 필요 없이 동일한 OAuth 애플리케이션을 통해 Qlik Cloud에 연결할 수 있습니다.
동의 방식은 승인 후 클라이언트별로 관리됩니다.자세한 내용은 OAuth 클라이언트 만들기 및 관리을(를) 참조하십시오.
-
인증 방법
DCR 설정을 구성할 때 동적으로 등록된 클라이언트가 사용할 수 있는 인증 방식을 지정할 수 있습니다.다음 인증 방법을 사용할 수 있습니다:
-
클라이언트 시크릿: 클라이언트 시크릿을 사용하여 인증하는 기밀 클라이언트를 허용합니다.클라이언트는 등록 시 클라이언트 시크릿을 받습니다.여기에는 client_secret_basic 및 client_secret_post 인증 방식이 모두 포함됩니다.
-
None: 클라이언트 암호를 사용하지 않는 퍼블릭 클라이언트를 허용합니다.이러한 클라이언트는 인증을 위해 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을 Qlik MCP 서버에 연결하기을(를) 참조하십시오.
MCP 액세스 예제
DCR의 한 가지 사용 사례는 Qlik MCP 서버 연동을 위한 OAuth 클라이언트 온보딩입니다.DCR은 MCP에만 국한되지 않으며 다른 호환 가능한 OAuth 클라이언트 애플리케이션에서도 사용할 수 있습니다.MCP 기반 연결의 경우, 일반적으로 다른 사용자가 연결하기 전에 테넌트 관리자가 첫 번째 연결을 생성하고 클라이언트를 승인합니다.
MCP 관리 및 연결 지침은 다음을 참조하십시오:
OAuth 클라이언트가 생성된 후 이를 관리하는 방법—여러 공급업체 등록 처리, 일괄 삭제, DCR 또는 CIMD 클라이언트 식별 포함—에 대한 지침은 OAuth 클라이언트 관리을(를) 참조하십시오.