Configurando documentos de metadados do ID do cliente OAuth

Última atualização: 09/10/2026

Os documentos de metadados de ID do cliente OAuth (CIMD) permitem que aplicativos cliente compatíveis usem um URL de documento de metadados HTTPS como o ID do cliente OAuth. Qlik Cloud recupera os metadados do cliente desse URL quando o cliente se conecta.

O CIMD é o método de registro preferencial quando um cliente oferece suporte tanto ao CIMD quanto ao OAuth Dynamic Client Registration (DCR). O CIMD não exige que o DCR esteja habilitado no locatário, e o aplicativo cliente fornece seu próprio documento de metadados.

Pré-requisitos e limitações do

Pré-requisitos:

• Você é um administrador do locatário em Qlik Cloud.

• Seu aplicativo cliente oferece suporte ao CIMD.

O CIMD possui as seguintes limitações:

• O CIMD oferece suporte aos métodos de autenticação de cliente none e private_key_jwt. Não suporta client_secret.

• Os clientes CIMD sempre usam o consentimento Obrigatório. Você não pode alterar o método de consentimento para Confiável, independentemente do status de publicação.

• O CIMD não oferece suporte a conexões Machine-to-Machine (M2M) ou de serviço para serviço. Para integrações M2M, use um cliente OAuth Web criado manualmente.

Conectando-se com o CIMD

Inicie a conexão no aplicativo cliente compatível com CIMD. O cliente fornece a URL do seu documento de metadados, e Qlik Cloud recupera os metadados dessa URL.

A primeira conexão requer aprovação de um administrador do locatário. A conexão é então aprovada para o locatário, e os usuários subsequentes podem se autenticar com a mesma identidade de cliente aprovada quando usarem um aplicativo que faz referência à mesma URL do documento CIMD. Cada usuário ainda se autentica com sua própria conta Qlik Cloud, funções e permissões. Um provedor pode usar diferentes URLs de documentos de metadados para diferentes aplicativos.

Os escopos padrão iniciais para uma conexão CIMD são user_default, mcp:execute e offline_access. Um administrador do locatário pode editar os escopos permitidos após a aprovação. Se você remover todos os escopos de uma conexão CIMD, a conexão não terá acesso. Ele não reverte para os escopos padrão iniciais.

Para procedimentos de conexão específicos do provedor, consulte Conectando-se ao servidor Qlik MCP.

Gerenciando conexões CIMD

Alternar uma conexão DCR existente para CIMD não é uma atualização in-place. Desconecte a conexão existente no aplicativo cliente e, em seguida, reconecte usando CIMD para criar uma conexão CIMD separada. Um administrador do locatário deve excluir manualmente o cliente DCR antigo da lista de clientes OAuth. Até lá, ambos os registros do cliente existem.

Excluir uma conexão CIMD remove a configuração de conexão do seu locatário e revoga os tokens para esse cliente no seu locatário. O cliente CIMD compartilhado usado por outros locatários não é excluído.

Qlik Cloud busca e verifica o documento de metadados do CIMD a cada 24 horas e atualiza os metadados armazenados apenas se o documento tiver sido alterado.

Este método de registro é baseado em um padrão OAuth em evolução, portanto, os detalhes de configuração em seu aplicativo cliente podem mudar ao longo do tempo.

Para obter informações sobre o esquema e o protocolo do documento de metadados, consulte Documentos de metadados do ID do cliente OAuth no Portal do Desenvolvedor da Qlik.

Identificando clientes CIMD

No centro de atividades Administração, a lista de clientes OAuth identifica clientes CIMD com um valor de Origem de CIMD. Para obter detalhes da API sobre o valor createdByType e a diferença entre Origem e Tipo de cliente, consulte Gerenciar vários cadastros de fornecedores.