Configurazione dei documenti di metadati dell'ID client OAuth

Ultimo aggiornamento: 09/10/2026

I documenti di metadati dell'ID client OAuth (CIMD) consentono alle applicazioni client compatibili di utilizzare l'URL di un documento di metadati HTTPS come ID client OAuth. Qlik Cloud recupera i metadati del client da tale URL quando il client si connette.

CIMD è il metodo di registrazione preferito quando un client supporta sia CIMD sia OAuth Dynamic Client Registration (DCR). CIMD non richiede che DCR sia abilitato nel tenant, e l'applicazione client fornisce il proprio documento di metadati.

Prerequisiti e limitazioni di

Prerequisiti:

• Sei un amministratore del tenant in Qlik Cloud.

• La tua applicazione client supporta CIMD.

CIMD presenta le seguenti limitazioni:

• CIMD supporta i metodi di autenticazione client none e private_key_jwt. Non supporta client_secret.

• I client CIMD utilizzano sempre il consenso Obbligatorio. Non è possibile modificare il metodo di consenso in Attendibile, indipendentemente dallo stato di pubblicazione.

• CIMD non supporta connessioni Machine-to-Machine (M2M) o service-to-service. Per le integrazioni M2M, utilizza un client OAuth Web creato manualmente.

Connessione con CIMD

Avviare la connessione nell'applicazione client compatibile con CIMD. Il client fornisce l'URL del proprio documento di metadati, e Qlik Cloud recupera i metadati da tale URL.

La prima connessione richiede l'approvazione da parte di un amministratore tenant. La connessione viene quindi approvata per il tenant e gli utenti successivi possono autenticarsi con la stessa identità client approvata quando utilizzano un'applicazione che fa riferimento allo stesso URL del documento CIMD. Ciascun utente continua ad autenticarsi con il proprio account Qlik Cloud, ruoli e autorizzazioni. Un provider può utilizzare URL dei documenti di metadati diversi per applicazioni diverse.

Gli ambiti predefiniti iniziali per una connessione CIMD sono user_default, mcp:execute e offline_access. Un amministratore del tenant può modificare gli ambiti consentiti dopo l'approvazione. Se rimuovi tutti gli ambiti da una connessione CIMD, la connessione non ha alcun accesso. Non esegue il fallback agli ambiti predefiniti iniziali.

Per le procedure di connessione specifiche del provider, vedere Connessione al Qlik server MCP.

Gestione delle connessioni CIMD

Il passaggio di una connessione DCR esistente a CIMD non è un aggiornamento in-place. Disconnetti la connessione esistente nell'applicazione client, quindi riconnettiti utilizzando CIMD per creare una connessione CIMD separata. Un amministratore del tenant deve eliminare manualmente il vecchio client DCR dall'elenco dei client OAuth. Fino ad allora, esistono entrambi i record del cliente.

L'eliminazione di una connessione CIMD rimuove la configurazione della connessione del tuo tenant e revoca i token per quel client nel tuo tenant. Il client CIMD condiviso utilizzato da altri tenant non viene eliminato.

Qlik Cloud recupera e verifica il documento di metadati CIMD ogni 24 ore e aggiorna i metadati memorizzati solo se il documento è cambiato.

Questo metodo di registrazione si basa su uno standard OAuth in evoluzione, pertanto i dettagli di configurazione nell'applicazione client potrebbero cambiare nel tempo.

Per informazioni sullo schema e sul protocollo del documento di metadati, vedere Documenti di metadati dell'ID client OAuth sul portale per sviluppatori Qlik.

Identificazione dei client CIMD

Nel centro attività Amministrazione, l'elenco dei client OAuth identifica i client CIMD con un valore Origine pari a CIMD. Per i dettagli sulle API relativi al valore createdByType e sulla differenza tra Origine e Tipo di client, vedere Gestione di registrazioni multiple da parte dei fornitori.