Guida alla Creazione e Configurazione di una Custom Application – THRON Guide

Una Custom Application è il meccanismo con cui autorizzi un sistema esterno — un CMS, un sito, un connettore — a distribuire contenuti dalla tua library THRON in modo controllato e sicuro.

Configurarla correttamente è il prerequisito per attivare qualsiasi connettore (Drupal, Storyblok, Live Story e altri).

Prerequisiti

Avere accesso alla sezione Applicazioni e Connettori e vedere THRON Custom Application Manager. tra le app disponibili. In caso contrario, contatta il tuo Customer Success THRON
Disporre del ruolo di Amministratore sulla piattaforma
Avere diritti necessari nella cartella sorgente che l'applicazione dovrà esporre al sistema esterno (es. /channels/website)

Crea la Custom Application

Seleziona THRON Custom Application Manager, poi clicca sul pulsante Attiva in alto a destra.

Nella modale di creazione compila i seguenti campi:

Nome dell’applicazione — un nome descrittivo (es. wordpress-site-it)
ID dell'applicazione da visualizzare sull'URL — l'identificativo non è modificabile dopo la creazione
Cartelle pubbliche — Seleziona una cartella di primo livello; tutte le sottocartelle verranno incluse e l'applicazione potrà accedere ai contenuti in esse presenti.

Accetta le varie condizioni d’uso.

Clicca su Attiva. Verrai reindirizzato automaticamente al pannello di configurazione dell'app.

Configura il pannello dell'applicazione

Una volta attivata, nel pannello di gestione esegui questi passaggi:

Annota l'AppID mostrato in cima al pannello — serve per l'autenticazione e per invocare i web service.
Nella sezione Gestione dei contenuti, puoi abilitare Può inserire nuovi contenuti e scegliere l'utente che verrà impersonificato dall'app per le operazioni sui contenuti:
- Proprietario dell'applicazione (default)
- Utente specifico
- Nuovo utente
Nella sezione Diritti di accesso alla cartella e ai suoi contenuti, puoi scegliere quali diritti dare all’applicazione
Scorri in basso e annota l'AppKey — la chiave privata per l'autenticazione sicura.

I valori AppID, AppKey e username possono essere recuperati in un secondo momento accedendo alla pagina delle applicazioni.

Riferimento credenziali

Credenziale	Descrizione	Dove si trova
AppID	Identificativo dell'applicazione, usato per autenticazione e chiamate API	In cima al pannello di configurazione
AppKey	Chiave privata per autenticazione sicura	In fondo al pannello, sezione Create and manage access keys
pKey	Chiave pubblica della cartella, usata per la distribuzione dei contenuti tramite player THRON	Generata dalla sezione Create new sharing (vedi sotto)
Client ID	Identificativo del tenant THRON (il dominio usato per accedere alla piattaforma)	Visibile nell'URL di accesso a THRON
Username	L'utente impersonificato dall'app per le operazioni sui contenuti	Scelto durante la configurazione Content Management

Crea la pKey per la distribuzione dei contenuti

La pKey non viene generata automaticamente: va creata esplicitamente dalla sezione Create new sharing nel pannello dell'app. Clicca su + Add sharing.

Nella modale scegli il tipo di condivisione:

Tipo	Comportamento	Quando usarla
Public Sharing	Accesso libero a tutti i contenuti della cartella; i contenuti vengono indicizzati dai motori di ricerca	Contenuti pubblici, siti web aperti
Secure Sharing	I contenuti vengono distribuiti solo se viene fornito un token utente valido; non indicizzati dai motori di ricerca	Contenuti riservati, portali B2B, aree protette

Seleziona il Player Template da associare all'embed e clicca su Confirm. La pKey generata è visibile nella parte superiore della modale e nell'embed script sotto il parametro sessId.

📸 [Screenshot: modale Enable Sharing — selezione Public/Secure sharing, Player Template e pulsante Confirm]

Attiva e disattiva la pKey in qualsiasi momento tramite il checkbox nella sezione Create new sharing del pannello. Se la disattivi, tutti gli embed che la usano smettono immediatamente di funzionare sui canali.

Gestisci le applicazioni esistenti

Dal pannello Applicazioni e Connettori puoi:

Visualizzare tutte le app attive, con nome, tipo e cartella collegata
Modificare nome e configurazione di un'app esistente
Revocare un'applicazione — i sistemi esterni che la usano smettono immediatamente di funzionare

Attenzione: solo l'utente proprietario dell'app può modificarla. Una Custom Application non può creare un'altra applicazione.

📦 Configurazione Consigliata

Se stai configurando una Custom Application per collegare un connettore CMS (WordPress, Drupal, Storyblok o simili), usa questo preset come punto di partenza:

Parametro	Valore consigliato
Nome app	`[nome-cms]-[canale]` (es. `wordpress-website-it`)
ID dell'applicazione da visualizzare sull'URL	Stesso del nome, in minuscolo senza spazi (es. `wordpress-website-it`)
Cartella sorgente	Cartella dedicata al canale, non la root (es. `/channels/website`)
Utente impersonificato	Utente dedicato con accesso solo alla cartella sorgente — non usare l'admin principale
Tipo di sharing	Public Sharing per siti pubblici; Secure Sharing per aree protette

Perché una cartella dedicata? Collegare una cartella specifica invece della root limita l'esposizione dei contenuti: il sistema esterno vede solo gli asset che deve vedere, niente di più.

Nota tecnica per sviluppatori — autenticazione via API

Per ottenere un token di sessione valido, invoca il web service su tramite una chiamata POST al seguente endpoint:

//{clientId}-view.thron.com/api/xadmin/resources/apps/su

Parametri richiesti nel body:

{
  "clientId": "",
  "appId": "",
  "username": "",
  "appKey": ""
}

Il token restituito nella risposta deve essere usato in tutte le chiamate successive. La pKey è utilizzabile anche come parametro per tutti i web service /public per includere contenuti nelle pagine. Il parametro dinamico nell'embed script è xcontentId, da sostituire con l'ID del contenuto specifico da embedare (deve essere un contenuto della cartella collegata all'app).

Serve aiuto?

Per domande sull'attivazione o per problemi tecnici, scrivi a support@thron.com.

Channel Activation