# Creazione e gestione di client OAuth

OAuth è un protocollo di sicurezza standard per l'autorizzazione e la delega. Permette alle applicazioni di terze parti di accedere alle risorse API senza rivelare le credenziali dell'utente finale. Un client OAuth può ottenere un codice di autorizzazione e scambiarlo per un token di accesso utilizzabile per accedere ai contenuti di Qlik Cloud tramite le API.

## Tipi di client OAuth

Un client OAuth è un'applicazione web o un software che richiede l'accesso alle risorse in Qlik Cloud per conto di un utente. OAuth definisce due tipi di client, i client pubblici e i client confidenziali, per rendere sicure le autorizzazioni tra un'applicazione (il client) e il server di autorizzazione (Qlik Cloud).

Qlik Cloud supporta i client confidenziali per le applicazioni web tradizionali (lato server) e i client pubblici per le applicazioni native e a pagina singola che utilizzano flussi di autorizzazione specifici.

Per la specifica ufficiale di OAuth 2.0 sui tipi di client, vedere [RFC 6749 Sezione 2.1: Tipi di client OAuth 2.0](https://oauth.net/2/client-types/ "RFC 6749 Sezione 2.1: Tipi di client OAuth 2.0").

### Client pubblici

I client pubblici sono applicazioni che non utilizzano un segreto client perché non possono mantenere la confidenzialità delle credenziali richieste. In Qlik Cloud, questi includono applicazioni front-end come le applicazioni a pagina singola (SPA) con analisi incorporate o estensioni di visualizzazione personalizzate in Qlik Sense, che richiedono l'autenticazione dell'utente.

### Client confidenziali

I client riservati possono memorizzare in modo sicuro un ID client e un segreto cliente e utilizzarli per autenticarsi con il server di autorizzazione. Questi client possono accedere a risorse protette poiché sono in possesso del segreto client.

Esempio: un'applicazione web con un backend sicuro che interagisce con le API di Qlik Cloud per gestire l'accesso degli utenti ai contenuti o organizzare le attività di aggiornamento dei dati.

## Flussi di autorizzazione OAuth

Qlik supporta due flussi di autorizzazione (tipi di concessione):

* Flusso del codice di autorizzazione: per i client riservati.

* Flusso del codice di autorizzazione con chiave di prova per lo scambio di codici (PKCE): per i client pubblici

### Flusso codice di autorizzazione

Questo flusso è utilizzato dalle applicazioni lato server in cui il codice sorgente non è esposto pubblicamente. Comporta lo scambio di un codice di autorizzazione per un token di accesso, con il segreto client utilizzato per l'autenticazione. Le applicazioni web che usano questo flusso devono essere lato server, perché il segreto client viene passato al server di autorizzazione durante lo scambio del token.

Nota informaticaNon condividere mai pubblicamente il segreto client, perché può compromettere la sicurezza del tenant. Mantenerlo privato e al sicuro.

Per ulteriori informazioni sul flusso del codice di autorizzazione, consultare la documentazione ufficiale di OAuth 2.0: [Flusso del codice di autorizzazione](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow "Flusso codice di autorizzazione").

### Flusso del codice di autorizzazione con PKCE

Le applicazioni native e a pagina singola non possono memorizzare in modo sicuro il segreto client, perché il relativo codice sorgente può essere decompilato o ispezionato in un browser. Il PKCE aumenta la sicurezza richiedendo l'uso di un sistema di verifica dei codici per ottenere un token di accesso.

Per ulteriori informazioni sull'autorizzazione con PKCE, consultare la documentazione ufficiale di OAuth 2.0: [Flusso del codice di autorizzazione con Proof Key for Code Exchange (PKCE)](https://auth0.com/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-proof-key-for-code-exchange-pkce "Flusso codice di autorizzazione con chiave di prova per lo scambio di codici (PKCE)").

## Ambiti e permessi di OAuth

Gli ambiti OAuth definiscono il livello di accesso concesso alle applicazioni client OAuth. Ad esempio, un token di accesso può consentire l'accesso completo alle risorse o limitarlo all'accesso in sola lettura. In Qlik Cloud, gli ambiti controllano l'accesso del client alle funzionalità e risorse disponibili. Senza ambiti, i client non possono accedere ad alcuna risorsa.

Nota informatica

Le credenziali API forniscono accesso programmatico diretto a Qlik Cloud e non sono limitate ai flussi di lavoro disponibili nell'interfaccia utente. Assegnare i ruoli e gli ambiti OAuth utilizzando il principio del privilegio minimo. Trattare gli account di servizio e le credenziali API con lo stesso livello di attenzione delle credenziali di amministratore. Per ulteriori informazioni, vedere [Controllo degli accessi API e limiti di attendibilità](https://qlik.dev/manage/access-control/api-trust-boundaries/).

### Scopi OAuth disponibili

La tabella elenca gli ambiti disponibili e le autorizzazioni ad essi associate:

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-oauth-client.htm)

#### Ambiti disponibili e autorizzazioni associate

| Ambito | Autorizzazione |
| --- | --- |
| user\_default | Accesso completo all'account e ai contenuti personali |
| admin\_classic | Accesso amministratore completo al tenant<br><br>Vedere anche: [Distribuzione e amministrazione Qlik Cloud](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Introduction/qlik-sense-administration.htm)<br><br>Nota informaticaNon supportato con i tipi di client App pagina singola o Nativo. |
| admin.apps | Visualizza e gestisci tutte le applicazioni nel tenant.<br><br>Vedere anche: [Gestione delle applicazioni](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/manage-apps.htm) |
| the Indica un elemento figlio icon admin.app:esportazione | Esporta tutte le applicazioni nel tenant<br><br>Vedere anche: [Download di applicazioni](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/export-apps-cloud-hub.htm) |
| the Indica un elemento figlio icon admin.app:lettura | Visualizza tutte le applicazioni nel tenant |
| admin.automations | Visualizza e gestisci tutte le automazioni nel tenant<br><br>Vedere anche: [Gestione delle automazioni](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-managing-automations.htm) |
| the Indica un elemento figlio icon admin.automazioni:lettura | Visualizza tutte le automazioni nel tenant |
| admin.gateway-ad-accesso-diretto:configurazione-remota | Modifica Gateway di Direct Access impostazioni<br><br>Vedere anche: [Configurazione e risoluzione dei problemi di Qlik Data Gateway - Accesso diretto](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-troubleshooting.htm) e [API pubblica](https://qlik.dev/apis/rest/direct-access-agents/). |
| admin.spaces | Visualizza e gestisce tutti gli spazi nel tenant<br><br>Vedere anche: [Gestione degli spazi](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-spaces.htm) |
| the Indica un elemento figlio icon admin.spaces:read | Visualizza tutti gli spazi nel tenant |
| App | Visualizza e gestisci le tue applicazioni<br><br>Vedere anche: [Gestione delle applicazioni](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/manage-apps.htm) |
| the Indica un elemento figlio icon app:esportazione | Esporta le tue applicazioni<br><br>Vedere anche: [Download di applicazioni](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Apps/export-apps-cloud-hub.htm) |
| the Indica un elemento figlio icon app:lettura | Leggi le tue applicazioni |
| automazioni | Visualizza e gestisci automazioni personali<br><br>Vedere anche: [Gestione delle automazioni](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-managing-automations.htm) |
| the Indica un elemento figlio icon automazioni:lettura | Visualizza automazioni personali |
| automl-esperimenti | Visualizza e gestisci esperimenti ML personali |
| automl-distribuzione | Visualizza e gestisci distribuzioni ML personali |
| gateway-ad-accesso-diretto:consumo\_dati | Carica dati tramite Gateway di Direct Access connettori<br><br>Vedere anche: [Qlik Data Gateway - Accesso diretto](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway.htm) |
| identity.email:read | Visualizza indirizzo e-mail personale<br><br>Vedere anche: [Provider di identità in Qlik Cloud](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-idp-configuration.htm) |
| identity.name:read | Visualizza nome personale completo |
| identity.picture:read | Visualizza immagine profilo personale<br><br>Vedere anche: [Provider di identità in Qlik Cloud](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-idp-configuration.htm) |
| identity.subject:read | Visualizza identificatore oggetto utente personale |
| spaces.data | Visualizza e gestisci spazi dati personali<br><br>Vedere anche: [Gestione degli spazi](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-spaces.htm) |
| the Indica un elemento figlio icon spazi.dati:lettura | Visualizza spazi dati personali |
| spaces.managed | Visualizza e gestisci spazi gestiti personali<br><br>Vedere anche: [Gestione degli spazi](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-spaces.htm) |
| the Indica un elemento figlio icon spazi.gestiti:lettura | Visualizza spazi gestiti personali |
| spaces.shared | Visualizza e gestisci spazi condivisi personali<br><br>Vedere anche: [Gestione degli spazi](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-spaces.htm) |
| the Indica un elemento figlio icon spaces.shared:read | Visualizza spazi condivisi personali |
| offline\_access | Accedi alle risorse in modalità offline<br><br>Nota informaticaNon supportato con il tipo di client App pagina singola. |

Nota informaticaL'elenco riflette gli ambiti supportati nella versione iniziale. È possibile trovare un elenco completo degli ambiti sul portale per sviluppatori di Qlik nella sezione [Ambiti](https://qlik.dev/manage/access-control/scopes/).

## Creazione di client OAuth

Gli amministrati tenant gestiscono i client OAuth nel centro attività Amministrazione sulla pagina OAuth. Con un client OAuth, è possibile integrare la propria applicazione client con Qlik Cloud per accedere alle risorse in modo sicuro.

### Metodi di configurazione del client OAuth

È possibile configurare i client OAuth in uno dei seguenti modi:

* Configurazione manuale del client (registrazione statica): Crea e mantieni la definizione del client direttamente nel tuo tenant. Utilizza questo metodo quando desideri avere il pieno controllo sulle impostazioni del client durante la configurazione.

* Registrazione dinamica dei client (DCR): consente alle applicazioni compatibili di registrare client OAuth in modo dinamico, in base alle impostazioni DCR a livello di tenant. Per i dettagli, vedere [Configurazione della registrazione dinamica del client OAuth](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/oauth-dynamic-client-registration.htm).

### Limiti per i client OAuth

Si applicano i seguenti limiti:

* Un massimo di 5 URL di reindirizzamento per client.

* Un massimo di 5 origini consentite per client.

* Un massimo di 5 segreti client per client.

* Un massimo di 200 client OAuth per tenant.

### Passaggi per la creazione di un client OAuth

Procedere come indicato di seguito:

1. Nel centro attività Amministrazione, andare a OAuth.

2. Fare clic su Crea nuovo.

3. Selezionare un tipo di client:

   * Web per i client riservati.

   * App pagina singola o Nativa per i client pubblici.

   * Incorporamento anonimo per i client pubblici.

4. Nella finestra di dialogo, assegnare un nome al client OAuth.

5. in via opzionale, aggiungere una descrizione.

6. Selezionare uno degli ambiti disponibili scorrendo l'elenco o utilizzando il campo di ricerca.

   Nota di suggerimentoUtilizzare i pulsanti Tutti e Selezionati per visualizzare per visualizzare tutti gli ambiti o solo quelli selezionati.

7. Inserire uno o più URL di reindirizzamento per l'applicazione client OAuth (per un massimo di 5). Quindi, fare clic su Aggiungi per aggiungere l'URL di reindirizzamento alla allowlist.

   * L'URL di reindirizzamento è dove il server di autorizzazione invia il browser dell'utente dopo aver autenticato correttamente e concesso l'autorizzazione all'applicazione client. Per esempio, https://www.exampleapp.com/oauth/callback, dove /oauth/callback gestisce i richiami di autenticazione dal provider OAuth.

   * Qlik Cloud reindirizzerà l'utente all'applicazione dopo un'autorizzazione riuscita solo se il relativo URL è nell'elenco degli URL di reindirizzamento consentito.

   * Gli URL devono iniziare con https:// a meno che il dominio sia localhost, nel qual caso può iniziare con http://. Le applicazioni native possono anche usare il formato di collegamento specifico dell'applicazione, ad esempio, exampleapp://.

8. Per i tipi di client Web o App a pagina singola, specificare una o più origini consentite (5 al massimo).

   * L'accesso all'applicazione verrà consentito solamente se l'URL viene aggiunto all'elenco delle origini consentite.

9. Per il tipo di client Web, è possibile attivare una delle seguenti opzioni per l'accesso automatico al sistema senza l'interazione dell'utente:

   * Consenti Machine-to-Machine (M2M): consente la comunicazione da sistema a sistema senza il coinvolgimento dell'utente.

   * Consenti rappresentazione utente con M2M: consente all'applicazione dell'utente di autenticarsi per conto degli utenti, agendo come loro durante il processo di autenticazione.

10. Per il tipo di client Web, selezionare una o entrambe le opzioni in Metodo di autenticazione:

    * Segreto client (predefinito)

    * JWT con chiave privata, un'opzione più sicura che autentica il client utilizzando una coppia di chiavi pubblica/privata invece di un segreto condiviso.

      * Quando si seleziona JWT con chiave privata, viene visualizzato il campo Chiave pubblica. Inserisci la chiave pubblica della tua app di terze parti nel formato JSON Web Key (JWK). La chiave privata rimane con la tua app per firmare i JWT. Per ulteriori informazioni sul formato della chiave pubblica, vedere [Creare una coppia di chiavi pubblica/privata per la firma dei JWT](https://qlik.dev/authenticate/oauth/oauth-private-key-jwt-reference/ "Creare una coppia di chiavi pubblica/privata per firmare i JWT") sul Qlik Developer Portal.

        Nota informaticaLa chiave pubblica dipende dai requisiti del tuo provider di identità. Se la chiave pubblica della tua app di terze parti è in un formato diverso, usa uno strumento di terze parti per convertirla in JWK.

11. Fare clic su Crea.

12. Fare clic su Copia negli appunti per salvare l'ID client e il segreto client per un utilizzo futuro. Archiviare il segreto client in modo sicuro.

    Nota informaticaI client pubblici non hanno un segreto client.

13. Fare clic su Fine.

## Gestione dei client OAuth

Alcuni fornitori registrano dinamicamente più client OAuth, uno per utente. Qlik consiglia di utilizzare gli OAuth Client ID Metadata Documents (CIMD) per ridurre le registrazioni multiple. Per informazioni dettagliate su questo comportamento, vedere [Gestione di registrazioni multiple da parte dei fornitori](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/oauth-dynamic-client-registration.htm#ManagingVendors).

### Identificazione dei client DCR e CIMD

I client DCR e CIMD possono essere distinti dai client creati manualmente nei seguenti modi:

* In Amministrazione, l'elenco dei client OAuth mostra una colonna Origine. I client DCR hanno un valore di origine pari a `DCR`, i client CIMD hanno un valore di origine pari a `CIMD` e i client creati manualmente hanno un valore di origine pari a `User`.

* Le risposte dell'API includono un campo `createdByType` impostato su `dcr` per i client DCR, `cimd` per i client CIMD e `user` per i client creati manualmente.

* Per i client CIMD, l'ID client è l'URL del documento di metadati fornito dal client LLM.

Origine identifica come è stato registrato il client OAuth. Tipo di client mostra il modello di client OAuth, ad esempio Nativo o Web. Ad esempio, Claude appare come Native, che è un client pubblico, e ChatGPT appare come Web, che è un client confidenziale. Pubblico e confidenziale descrivono il modo in cui l'applicazione si autentica. Non descrivono se i dati utente siano pubblici o riservati e gli utenti accedono comunque con i propri account.

## Client OAuth per casi d'uso specifici

Per i casi d'uso del client OAuth, fare riferimento alle seguenti risorse:

* [Panoramica di OAuth](https://qlik.dev/authenticate/oauth/ "Panoramica di OAuth") sul portale per sviluppatori di Qlik: panoramica dei casi d'uso di OAuth e dei diversi tipi di OAuth.

* [Configurazione della registrazione dinamica del client OAuth](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/oauth-dynamic-client-registration.htm): Configura le impostazioni a livello di tenant per OAuth Dynamic Client Registration.

* [Configurazione dei documenti di metadati dell'ID client OAuth](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/oauth-client-id-metadata-documents.htm): Configurare e gestire le connessioni CIMD.

* [Creazione di client OAuth per Qlik componenti aggiuntivi per Microsoft Office](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-oauth-client.htm#Creating): configurare un client OAuth per l'installazione del componente aggiuntivo di Qlik per Microsoft Excel.

* [Creazione di un client OAuth per l'incorporamento anonimo dei contenuti dell'applicazione](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-oauth-client.htm#CreateOAuth): Creare un client OAuth per consentire l'accesso anonimo ai contenuti dell'applicazione incorporati.

### Creazione di client OAuth per Qlik componenti aggiuntivi per Microsoft Office

La configurazione di un client OAuth è richiesta per installare i componenti aggiuntivi Qlik per Microsoft Office. I componenti aggiuntivi sono usati dagli sviluppatori di report per preparare modelli di report per il reporting in-applicazione con Qlik Cloud.

Per fare in modo che OAuth funzioni correttamente nei componenti aggiuntivi, è necessario configurare il client OAuth utilizzando la configurazione esatta mostrata sotto.

Procedere come indicato di seguito:

1. In Qlik Cloud, fare clic su the Apri Menu di navigazione icon nell'angolo in alto a sinistra.

2. Selezionare Amministrazione.

3. Vai a OAuth.

4. Fare clic su Crea nuovo.

5. Nel menu a comparsa Tipo di client, selezionare App pagina singola. Verranno visualizzati ulteriori campi.

6. Inserire un Nome. L'opzione Descrizione è facoltativa.

7. Come minimo, selezionare la casella di controllo per includere l'ambito user\_default. È possibile aggiungere anche altri ambiti nella configurazione, ma se non si include user\_default, l'installazione non funzionerà.

   Per una descrizione completa di ogni ambito disponibile, vedere [Scopi OAuth disponibili](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-create-oauth-client.htm#Availabl).

8. Nel campo Aggiungi URL di reindirizzamento, inserire l'URL del Qlik Cloud tenant, seguito da questa stringa fissa: /office-add-ins/oAuthLoginSuccess.html

   Il risultato dovrebbe essere simile a questo: https://&lt;tenant or alias hostname&gt;.&lt;region&gt;.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Ad esempio: http://example-company-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

9. Fare clic su Aggiungi.

10. Nel campo Aggiungi origini consentite, inserire l'URL del tenant e fare clic su Aggiungi.

11. Fare clic su Crea.

12. Viene visualizzata la finestra Copia il tuo ID client. È possibile scegliere di copiare l'ID del client negli appunti; oppure, fare clic su Fine per chiudere la finestra

Dopo aver creato il client OAuth, ottenere il collegamento al XML manifesto aggiornato dal centro attività Amministrazione. Andare alla pagina Impostazioni e selezionare la scheda Email e report. Nella sezione Componenti aggiuntivi Qlik per Microsoft Office, recupera il collegamento che puoi utilizzare per distribuire e installare il componente aggiuntivo.

Per maggiori informazioni sulla generazione del file manifesto e sulla distribuzione e installazione del componente aggiuntivo, vedere:

* [Distribuzione e installazione di Qlik componenti aggiuntivi per Microsoft Office](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Reporting/Install/reporting-install-add-ins.htm)

* [Gestione dei file manifesto di installazione per i componenti aggiuntivi di Qlik per Microsoft Office](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-add-in.htm)

### Creazione di un client OAuth per l'incorporamento anonimo dei contenuti dell'applicazione

Per incorporare i contenuti dell'applicazione per l'accesso anonimo tramite qlik-embed, è necessario creare un client OAuth con un tipo specificamente progettato per questo caso d'uso.

Nota informatica Questa funzionalità è disponibile solo con una sottoscrizione a Qlik Anonymous Access. Per ulteriori informazioni, vedere [Sottoscrizioni a Qlik Anonymous Access](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/subscription-options-anonymous.htm).

Procedere come indicato di seguito:

1. Nel centro attività Amministrazione, andare alla sezione OAuth.

2. Fare clic su Crea nuovo.

3. Nel menu a comparsa Tipo di client, selezionare Incorpora in modo anonimo.

4. Inserire un Nome e, facoltativamente, una Descrizione per il client OAuth.

5. In Origini consentite, inserire ogni origine da autorizzare. Questi sono i domini che accederanno al tenant Qlik Cloud per recuperare le informazioni per le analisi incorporate.

   Fare clic su Aggiungi dopo aver inserito ogni URL.

6. Una volta terminato, fare clic su Crea.

7. Fare clic su Copia negli appunti per salvare l'ID client per un utilizzo futuro. Sarà necessario quando il contenuto dell'applicazione viene incorporato con qlik-embed.

8. Fare clic su Fine.

## Modifica dei client OAuth

È possibile rinominare un client OAuth, aggiornare la descrizione o gestire gli URL di reindirizzamento.

Procedere come indicato di seguito:

1. Nel centro attività Amministrazione, andare a OAuth.
2. Individuare il client OAuth che si desidera modificare.
3. Fare clic su the Altro icon, quindi selezionare Modifica.
4. Modificare le opzioni per il client OAuth come richiesto.
5. Fare clic su Salva.

## Eliminazione dei client OAuth

È possibile eliminare un client OAuth quando non è più necessario, oppure revocarne l'accesso.

Se il tuo tenant ha molti client OAuth, utilizza i filtri nell'elenco dei client OAuth per trovare i client in base al fornitore o allo schema di denominazione, seleziona i client corrispondenti ed eliminali in blocco.

Procedere come indicato di seguito:

1. Nel centro attività Amministrazione, andare a OAuth.

2. Selezionare uno o più client OAuth che si desidera rimuovere, quindi fare clic su Elimina.

3. Confermare l'eliminazione.

## Pubblicazione di client OAuth

I client OAuth sono inizialmente associati al tenant che li ha creati. Tuttavia, è possibile configurare un client OAuth da condividere tra più tenant all'interno nella stessa regione. Ciò consente alle applicazioni di terze parti di utilizzare lo stesso ID client in diversi tenant di Qlik Cloud.

I proprietari dell'applicazione possono effettuare la rotazione dei segreti e aggiornare la configurazione senza interazione da parte di un amministratore tenant. Gli amministratori tenant non devono gestire le credenziali o essere a conoscenza dei dettagli di configurazione per il client pubblicato.

Per consentire agli altri tenant di connettersi a un client OAuth, è necessario pubblicarlo.

Procedere come indicato di seguito:

1. Nel centro attività Amministrazione, andare a OAuth.
2. Individuare il client OAuth che si desidera pubblicare.
3. Fare clic su the Altro icon accanto al client e selezionare Pubblica.
4. Fare clic su Pubblica per confermare.

Una volta pubblicato il client OAuth, diventa disponibile per l'uso esterno da parte di altri tenant. Quando un utente visita un sito web esterno che utilizza questo client OAuth, gli viene chiesto di inserire il nome host del tenant e le proprie credenziali utente, a meno che l'utente non abbia già una sessione SaaS attiva.

Il login iniziale richiederà il consenso da parte di un amministratore del tenant. Una volta approvato, il client OAuth apparirà nel centro attività Amministrazione del tenant.

## Metodi di consenso

Per impostazione predefinita, Qlik Cloud chiede agli utenti il consenso al momento dell'autenticazione. Per semplificare il processo, soprattutto per le applicazioni attendibili, è possibile impostare il metodo di consenso su "Attendibile", che salta la richiesta di consenso.

Sono disponibili due opzioni per il consenso:

* Richiesto: all'utente viene chiesto di fornire l'autorizzazione ogni volta che viene richiesto un nuovo ambito per l'utente tramite il client OAuth. Questo metodo garantisce l'approvazione esplicita dell'utente per ogni livello di accesso.

* Attendibile: all'utente non viene richiesto di fornire il proprio consenso. Questa opzione è disponibile solo per i client non pubblicati. Per i client che sono stati pubblicati, viene sempre utilizzato il metodo di consenso Richiesto per mantenere la sicurezza su più tenant.

Nota informaticaPer i client utilizzati come Machine-to-Machine (M2M), il metodo di consenso deve essere modificato in Attendibile dopo la creazione del client. Le connessioni OAuth Client ID Metadata Documents (CIMD) utilizzano sempre il consenso Richiesto e non possono essere modificate in Attendibile, indipendentemente dallo stato di pubblicazione.

### Modifica del metodo di consenso

Per modificare il metodo di consenso per un client OAuth, fare quanto segue:

1. Nel centro attività Amministrazione, andare a OAuth.
2. Sul client OAuth, fare clic su the Altro icon e selezionare Cambia metodo di consenso.
3. Selezionare Richiesto o Attendibile, quindi fare clic su Cambia metodo di consenso.

## Visualizzazione e copia della configurazione OAuth

Nella sezione OAuth del centro attività di Amministrazione, selezionare Visualizza configurazione OAuth per visualizzare i dati di autenticazione per il tenant Qlik Cloud. Verrà visualizzato uno snippet di codice con gli endpoint e le impostazioni OAuth, oltre a un URL che è possibile copiare per utilizzarlo in applicazioni esterne.

È possibile utilizzare questa configurazione per integrare Qlik Cloud con applicazioni di terze parti, automatizzare l'accesso alle API o configurare l'autenticazione per l'analisi incorporata.

## Gestione dei segreti client

Se un segreto del client viene compromesso o se la politica di sicurezza della propria organizzazione richiede aggiornamenti periodici, è possibile aggiungere o rimuovere segreti. Per evitare i tempi di inattività, è possibile aggiungere più segreti del cliente (un massimo di 5), aggiornare l'applicazione client e poi rimuovere il vecchio segreto.

### Aggiunta di un segreto client

Procedere come indicato di seguito:

1. Nel centro attività Amministrazione, andare a OAuth.

2. Individuare il client OAuth.

3. Fare clic su the Altro icon, quindi selezionare Gestisci segreti.

4. Fare clic su Genera un nuovo segreto client.

5. Copiare il segreto client e l'ID del client e conservarli in modo sicuro.

   Nota informaticaNon sarà possibile accedere al segreto client successivamente.

6. Fare clic su Chiudi.

### Rimozione di un segreto client

Procedere come indicato di seguito:

1. Nel centro attività Amministrazione, andare a OAuth.
2. Individuare il client OAuth.
3. Fare clic su the Altro icon, quindi selezionare Gestisci segreti.
4. Fare clic su the Elimina icon accanto al segreto client.
5. Fare clic su Chiudi.

## Maggiori informazioni sui client OAuth

### Passaggio successivo: creazione di applicazioni client OAuth

Dopo aver registrato un client OAuth con Qlik Cloud, è possibile creare applicazioni client OAuth per accedere ai contenuti di Qlik Cloud. Utilizzare l'ID client e il segreto client associati nella propria applicazione.

Per una guida passo passo, vedere i tutorial nella sezione [Panoramica di OAuth](https://qlik.dev/authenticate/oauth/) del Portale per sviluppatori di Qlik. Questi tutorial spiegano come creare applicazioni client utilizzando i linguaggi di programmazione più diffusi.

### Client OAuth a livello di organizzazione

Oltre ai client OAuth specifici del tenant, è possibile utilizzare client OAuth a livello di organizzazione. In qualità di proprietario dell'account di servizio (SAO), è possibile creare e gestire questi client. I client OAuth a livello di organizzazione forniscono l'accesso alle informazioni del tenant in tutti i tenant delle sottoscrizioni.

Per ulteriori informazioni, vedere [Gestione dei client OAuth in My Qlik](https://help.qlik.com/it-IT/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/create-oauth-client-for-organization.htm).