OAuth 동적 클라이언트 등록 구성

마지막 업데이트: 2026. 9. 30.

OAuth Dynamic Client Registration(DCR)은 호환되는 OAuth 클라이언트 애플리케이션이 OAuth 클라이언트를 동적으로 등록할 수 있도록 지원하는 테넌트 수준의 OAuth 기능입니다.이 맥락에서 호환되는 OAuth 클라이언트 애플리케이션은 OAuth 2.0 DCR 프로토콜을 지원하고 테넌트 정책 요구 사항을 충족하는 애플리케이션입니다.

인증, 사용자 동의 및 범위 관리에 대한 테넌트 제어를 계속 적용하면서 적은 수동 설정으로 여러 OAuth 클라이언트를 온보딩해야 하는 경우 DCR을 사용하십시오.DCR의 주요 사용 사례는 Model Context Protocol(MCP) 서버 클라이언트를 연결하는 것이지만, 호환되는 다른 서드파티 애플리케이션에도 사용할 수 있습니다.각 클라이언트를 직접 생성하고 유지 관리하려는 경우 대신 수동 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 구성하기

다음을 수행합니다.

1. 관리 활동 센터에서 설정 > 보안으로 이동합니다.

2. 동적 클라이언트 등록을 활성화합니다.

   DCR이 비활성화되면 새 클라이언트를 동적으로 등록할 수 없습니다.기존에 동적으로 등록된 클라이언트는 수동으로 제거하거나 승인을 철회할 때까지 계속 작동합니다.

3. 허용된 인증 방법에서 동적으로 등록된 클라이언트가 사용할 수 있는 인증 방법을 선택합니다:

   • 클라이언트 암호: 안전한 백엔드가 있는 웹 애플리케이션과 같은 기밀 클라이언트를 허용합니다.

   • 클라이언트 시크릿 + 없음: 기밀 클라이언트와 공개 클라이언트를 모두 허용합니다.

   • 없음: 단일 페이지 애플리케이션 또는 네이티브 애플리케이션과 같은 퍼블릭 클라이언트를 허용합니다.

   정책에서 허용되지 않는 방법으로 등록을 시도하는 애플리케이션은 거부됩니다.

   이러한 인증 방법에 대한 자세한 내용은 다음 섹션 인증 방법을(를) 참조하십시오.

OAuth 클라이언트 앱에서 DCR 구성하기

Qlik Cloud에서 DCR을 구성한 후 OAuth 클라이언트 애플리케이션에서 DCR 연결을 구성하십시오.연결 세부 정보는 사용 사례에 따라 다릅니다.

다음을 수행합니다.

1. OAuth 클라이언트 애플리케이션에서 연결을 구성할 때 사용 사례에 맞는 연결 URL을 사용하십시오:

   사용 사례	연결 URL 형식
   MCP 또는 GenAI 클라이언트	https://<tenant-id>.<region>.qlikcloud.com/api/ai/mcp 자세한 MCP 구성 정보는 다음을 참조하십시오. Qlik MCP 서버에 연결서
   기타 OAuth 클라이언트 애플리케이션	https://<tenant-id>.<region>.qlikcloud.com

2. 새로 등록된 DCR 클라이언트의 승인 및 동의 동작을 검토하십시오:

   • 새 DCR 클라이언트를 사용하기 전에 명시적인 테넌트 승인이 필요한지 확인하십시오.타사 애플리케이션에서 메시지가 표시되면 승인합니다.

   • 첫 번째로 승인된 연결은 필수 동의를 사용합니다.

   • 승인 후, Qlik Cloud에서 클라이언트를 편집하고 보안 정책에 부합하는 경우 동의 방식을 Trusted(으)로 변경하십시오.

   테넌트 승인은 귀하의 Qlik Cloud 테넌트와 OAuth 클라이언트 애플리케이션 간에 테넌트 수준의 신뢰를 구축합니다.테넌트 관리자가 연결하고, 인증하고, 동의 요청을 승인한 후에는 다른 사용자가 별도의 동의 승인 없이 동일한 OAuth 애플리케이션을 통해 Qlik Cloud에 연결할 수 있습니다.

   동의 방식은 승인 후 클라이언트별로 관리됩니다.자세한 내용은 다음을 참조하십시오. OAuth 클라이언트 만들기 및 관리.

인증 방법

DCR 설정을 구성할 때 동적으로 등록된 클라이언트가 사용할 수 있도록 허용되는 인증 방식을 지정할 수 있습니다.다음 인증 방법을 사용할 수 있습니다:

• 클라이언트 시크릿: 클라이언트 시크릿을 사용하여 인증하는 기밀 클라이언트를 허용합니다.클라이언트는 등록 시 클라이언트 시크릿을 받습니다.여기에는 client_secret_basic 및 client_secret_post 인증 방식이 모두 포함됩니다.

• 없음: 클라이언트 암호를 사용하지 않는 퍼블릭 클라이언트를 허용합니다.이러한 클라이언트는 인증을 위해 PKCE(Proof Key for Code Exchange)를 사용하는 인가 코드 흐름을 사용합니다.

기본적으로, 동적으로 등록된 클라이언트는 등록 시 달리 지정되지 않는 한 client_secret_basic 인증 방식을 사용합니다.

DCR 클라이언트 관리

공급업체의 다중 등록 관리

많은 OAuth 클라이언트 애플리케이션은 Qlik Cloud에 단일 OAuth 클라이언트를 동적으로 등록합니다.애플리케이션 사용자는 동일한 OAuth 클라이언트를 공유합니다.

일부 OAuth 클라이언트 애플리케이션은 사용자당 하나씩 여러 OAuth 클라이언트를 동적으로 등록합니다.이 동작은 다음에서 관찰되었습니다:

• Anthropic Claude

• 반중력

동일한 공급업체의 DCR 클라이언트가 다수 표시되는 경우, 해당 OAuth 클라이언트 애플리케이션이 클라이언트를 등록하는 방식과 공유 커넥터 옵션을 사용할 수 있는지 검토하십시오.

Anthropic Claude의 경우, Qlik에서는 Anthropic 디렉터리를 위한 전용 Qlik Cloud MCP 커넥터를 검토하고 있습니다.Anthropic에서 승인하는 경우, 커넥터는 다중 등록 문제를 해결하는 데 도움이 될 수 있습니다.해당 기능을 사용할 수 있게 될 때까지 여러 DCR 등록이 우려되는 경우, Claude에 연결의 정적 Claude OAuth 구성을 팔로우하세요.

OAuth 클라이언트 일괄 삭제

테넌트에 OAuth 클라이언트가 많은 경우 다음을 수행하십시오:

1. OAuth 클라이언트 목록에서 필터링을 사용하여 공급업체 또는 이름 지정 패턴별로 클라이언트를 찾으세요.

2. 일치하는 클라이언트를 선택합니다.

3. 선택한 클라이언트를 일괄 삭제합니다.

동적으로 등록된 클라이언트 식별하기

동적으로 등록된 클라이언트는 다음과 같은 방법으로 수동으로 생성된 클라이언트와 구분할 수 있습니다:

• 관리에서 OAuth 클라이언트 목록에 소스 열이 표시됩니다.DCR 클라이언트의 소스 값은 DCR이며, 수동으로 생성된 클라이언트의 소스 값은 User입니다.

• API 응답에는 동적으로 등록된 클라이언트의 경우 dcr(으)로, 수동으로 생성된 클라이언트의 경우 user(으)로 설정된 createdByType 필드가 포함됩니다.

MCP 액세스 예제

DCR의 한 가지 사용 사례는 Qlik MCP 서버 연동을 위한 OAuth 클라이언트 온보딩입니다.DCR은 MCP에만 국한되지 않으며 호환되는 다른 OAuth 클라이언트 애플리케이션에서도 사용할 수 있습니다.MCP 기반 연결의 경우, 일반적으로 테넌트 관리자가 첫 번째 연결을 생성하고 다른 사용자가 연결하기 전에 클라이언트를 승인합니다.

MCP 관리 및 연결 지침은 다음을 참조하십시오:

• 배포 및 관리 Qlik MCP 서버

• Qlik MCP 서버에 연결