La pKey: cos'è e come gestirla – THRON Guide

La pKey è la chiave di autorizzazione che consente di distribuire i contenuti THRON su sistemi esterni — siti, CMS, connettori — in modo controllato e sicuro. Senza una pKey attiva, i contenuti non vengono esposti al di fuori della piattaforma.

Prerequisito: la pKey esiste solo se sulla piattaforma hai attivato una Custom Application, tramite l'app THRON Custom Application Manager. Senza una Custom Application attiva non puoi generare né gestire pKey. Se non l'hai ancora creata, segui prima la Guida alla Creazione e Configurazione di una Custom Application.

Tipi di pKey

Tipo	Comportamento
Single content pKey	Autorizza la distribuzione di un singolo asset. Se l'asset viene eliminato, la pKey diventa automaticamente non valida.
Folder pKey	Autorizza la distribuzione di tutti gli asset presenti nella cartella collegata. Si aggiorna automaticamente quando aggiungi nuovi asset; diventa non valida per i contenuti eliminati.

Accedi alla pKey dalla cartella

In THRON X puoi raggiungere le applicazioni collegate a una cartella direttamente dall'interfaccia asset.

Seleziona la cartella nell'albero a sinistra e apri il menu in corrispondenza del nome cartella attivata in alto.

Clicca su Applicazioni associate.
Nella modale Applicazioni associate individua l'applicazione che ti interessa e clicca sull'icona di apertura nella colonna Azioni.

Sei ora nel pannello dell'applicazione, nella sezione Create new sharing, dove trovi le pKey esistenti.

Visibilità riservata: le pKey sono visibili solo all'utente che ha creato l'applicazione. Anche chi ha diritti amministrativi sull'app non può vedere le pKey generate da altri utenti.

Accedi alla pKey da Applicazioni e Connettori

In alternativa, puoi raggiungere le applicazioni dalla navigazione globale:

Clicca sul menu di contesto in alto a sinistra (dove compare Asset Digitali o la sezione attiva).
Seleziona Applicazioni e Connettori.

Individua l'applicazione e clicca sull'icona di apertura nella colonna Azioni.

openapp.png
Le pKey esistenti sono visibili nella sezione Create new sharing del pannello.

pkey.png

Crea una nuova pKey

Dal pannello dell'applicazione, nella sezione Create new sharing, clicca su + Add sharing.

Nella modale configura i seguenti campi:

Nome — assegna un nome descrittivo alla condivisione (es. website-public).
Template — seleziona il Player Template da associare all'embed.

Aggiornamento automatico dello stile: se in futuro modifichi il Player Template associato a questa pKey, il nuovo stile grafico si propagherà automaticamente su tutti i contenuti già distribuiti tramite quella pKey — senza dover rigenerare il codice embed.
Tipo di condivisione — scegli in base al livello di accesso richiesto:

Tipo	Comportamento	Quando usarla
Public Sharing	Accesso libero a tutti i contenuti della cartella; i contenuti vengono indicizzati dai motori di ricerca.	Siti web pubblici, canali aperti.
Secure Sharing	I contenuti vengono distribuiti solo con un token utente valido; non vengono indicizzati.	Portali B2B, aree protette, contenuti riservati.

Clicca su Confirm. La pKey generata è visibile nella parte superiore della modale e nell'embed script sotto il parametro sessId.

Configurazione consigliata: per la maggior parte dei siti pubblici usa Public Sharing con il template standard. Passa a Secure Sharing solo se i contenuti non devono essere accessibili senza autenticazione.

Attiva e disattiva una pKey

Puoi attivare o disattivare una pKey in qualsiasi momento tramite il checkbox nella sezione Create new sharing del pannello dell'applicazione.

Attenzione: disattivare una pKey interrompe immediatamente la distribuzione di tutti i contenuti che la utilizzano su canali esterni.

## Articoli di approfondimento
- Guida alla Creazione e Configurazione di una Custom Application

Serve aiuto?

Per problemi tecnici, scrivi a support@thron.com.

Channel Activation