La pKey: cos'è e come gestirla
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: per accedere e creare una pKey devi avere una Custom Application già configurata. Se non l'hai ancora fatto, consulta prima la guida alla creazione 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.
Serve aiuto?
Per problemi tecnici, scrivi a support@thron.com.