Panoramica sulle sandbox

Adobe Experience Platform è stato progettato per arricchire le applicazioni di esperienza digitale su scala globale. Le aziende spesso eseguono più applicazioni di esperienza digitale in parallelo e devono occuparsi di sviluppo, test e distribuzione di tali applicazioni, garantendo al contempo la conformità operativa.

Per soddisfare questa esigenza, Experience Platform fornisce sandbox che permettono di suddividere una singola istanza Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.

Questo documento fornisce una panoramica di alto livello delle sandbox in Experience Platform.

Informazioni sulle sandbox

Le sandbox sono partizioni virtuali all’interno di un’unica istanza di Experience Platform, che consentono un’integrazione fluida con il processo di sviluppo delle applicazioni di esperienza digitale. Tutti i contenuti e le azioni eseguite all’interno di una sandbox sono limitati a tale sandbox e non influiscono su altre sandbox. Ad Experience Platform, sono supportati due tipi di sandbox:

Un’istanza di Experience Platform supporta più sandbox di produzione e sviluppo, ognuna delle quali mantiene la propria libreria indipendente di risorse Platform (inclusi schemi, set di dati, profili e così via). Inoltre, sia le sandbox di produzione che quelle di sviluppo dispongono di una funzione di ripristino che rimuove tutte le risorse create dal cliente dalla sandbox. Le sandbox di sviluppo non possono essere convertite in sandbox di produzione.

Una licenza di Experience Platform predefinita ti concede un totale di cinque sandbox, che puoi classificare come produzione o sviluppo. Puoi concedere in licenza pacchetti aggiuntivi di 10 sandbox per un massimo di 75 sandbox in totale. Queste sandbox aggiuntive possono essere utilizzate per creare sandbox di produzione e di sviluppo. Per ulteriori informazioni, contatta l’amministratore dell’organizzazione o il rappresentante commerciale Adobe.

Infine, la sandbox di produzione predefinita è la prima sandbox di produzione creata al momento della creazione di un’organizzazione. La sandbox di produzione predefinita consente di acquisire o utilizzare dati da Platform, nonché di accettare richieste che non includono valori per il nome di una sandbox o l’ID di una sandbox.

In sintesi, le sandbox offrono i seguenti vantaggi:

Controllo degli accessi per le sandbox

Per impostazione predefinita, tutti gli utenti di un’organizzazione hanno accesso a una sandbox di produzione. L'accesso alle sandbox non di produzione deve essere concesso da un amministratore di sistema, un amministratore di prodotto o un amministratore del profilo di prodotto tramite Adobe Admin Console.

Per visualizzare, creare, aggiornare o eliminare sandbox non di produzione, è necessario concedere agli utenti anche le autorizzazioni di amministrazione delle sandbox.

Per ulteriori informazioni sulla gestione di ruoli e autorizzazioni per le sandbox, vedere panoramica sul controllo degli accessi.

Sandbox nell’interfaccia utente di Experience Platform

Nell'interfaccia utente di Experience Platform, gli utenti possono passare dalle sandbox a cui hanno accesso utilizzando il controllo commutatore sandbox in alto a sinistra dello schermo. Gli utenti con privilegi di amministrazione della sandbox possono inoltre accedere alla scheda Sandbox nella navigazione a sinistra, dove possono visualizzare e gestire le sandbox per la propria organizzazione. Per ulteriori informazioni su come utilizzare le sandbox nell'interfaccia utente, consulta la guida utente sulle sandbox.

Sandbox nelle API di Experience Platform

Quando si effettuano chiamate alle API Experience Platform, è necessario fornire un nome di sandbox sotto l'intestazione x-sandbox-name. Ad esempio, quando si effettua una chiamata a Catalog Service API per visualizzare tutti i set di dati all'interno della sandbox di produzione, il nome della sandbox ("prod") viene fornito come intestazione nella richiesta API:

curl -X GET \
  https://platform.adobe.io/data/foundation/catalog/dataSets \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: prod'

Se x-sandbox-name non è incluso in una chiamata API, il sistema utilizzerà una sandbox predefinita. Tuttavia, la best practice prevede di includere sempre questa intestazione in tutte le chiamate API, anche quando si utilizza la sandbox predefinita. Per questo motivo, nella documentazione API di Experience Platform x-sandbox-name viene considerato come intestazione obbligatoria.

API sandbox

L’API Sandbox consente di gestire le sandbox utilizzando le operazioni API RESTful. Consulta la guida per gli sviluppatori di sandbox per informazioni dettagliate su come utilizzare l'API, incluse richieste formattate correttamente e risposte di esempio.

Passaggi successivi

Una volta letto questo documento, avrai introdotto i concetti essenziali relativi alle sandbox in questo Experience Platform. Per i passaggi dettagliati su come gestire le sandbox, consulta la guida utente per l'interfaccia utente o la guida per sviluppatori per l'API.

Anche se le sandbox sono uno strumento utile per isolare gli ambienti Platform per il team di sviluppo, puoi anche gestire un controllo degli accessi più granulare utilizzando Adobe Admin Console. Per ulteriori informazioni, vedere panoramica sul controllo degli accessi.