Migliori pratiche per Rainbow Extensions

Potete utilizzare questo articolo come lista di controllo prima di creare, testare o distribuire un manifesto personalizzato in ambiente di produzione. Utilizzatelo per garantire che il vostro manifesto sia gestibile, sicuro e più facile da risolvere in caso di problemi.

Creazione

• Partite da un modello esportato da Rainbow Desktop o da un manifesto già convalidato.
• Rimuovete i punti di estensione inutilizzati prima della distribuzione in produzione.
• Mantenete la versione impostata su "2" e jsonType su "Rainbow-custo-manifest".
• Non definire più di 3 azioni per lo stesso punto di estensione.
• Evitare percorsi hardcoded provenienti dal computer di uno sviluppatore. Utilizzare ${custo.path} e raggruppare le risorse in un archivio ZIP.

Sicurezza

• Dichiarare tutte le origini REST e iframe nei domini Custo-manifest prima della distribuzione.
• Privilegiate gli endpoint HTTPS con nomi DNS stabili.
• Per le API REST, configurare esplicitamente il CORS e testare le richieste di preflight del browser.
• Per i server di rete locali/private, verificare il comportamento di Rainbow Web con le regole di accesso alla rete locale.
• Non incorporare informazioni riservate direttamente in un manifesto distribuito agli utenti. Privilegiare, ove possibile, i token lato server o le credenziali a breve durata.

Variabili

• Utilizzi la variabile più specifica disponibile per il punto di estensione.
• Testare le variabili con chiamate, Contatti e Spazi realistici; alcuni valori risultano vuoti in assenza del contesto.
• Utilizzi le espressioni regolari solo per trasformazioni semplici. Le trasformazioni complesse dovrebbero avvenire lato server.
• Verifichi i formati dei numeri di telefono nelle implementazioni di Cloud PBX, OmniPCX Enterprise e OXO Connect.

Schede adattive

• Mantenete le schede concise e incentrate sull’azione dell’utente.
• Verifichi la visualizzazione su Rainbow Web e Desktop.
• Eviti gli elementi Adaptive Card 1.6+ non supportati, a meno che la versione del client Rainbow di destinazione non li supporti esplicitamente.
• Per Action.Submit, rendere l’endpoint di destinazione idempotente e fornire un feedback chiaro all’utente.

Convalida pre-produzione

• Verifichi la sintassi JSON.
• Verifichi l’importazione locale prima della distribuzione centrale.
• Verifichi il manifesto su Web e Desktop quando entrambi i client sono destinati.
• Verificare tutti i domini attendibili, le intestazioni CORS e le intestazioni iframe.
• Effettuare la distribuzione inizialmente su un utente pilota o un profilo prima di procedere a un'implementazione su più ampia scala.
• Conservare una copia del manifesto precedente in modo da poter effettuare immediatamente il rollback.