Aanbevolen werkwijzen voor Rainbow Extensions

U kunt dit artikel gebruiken als checklist voordat u een aangepast manifest aanmaakt, test of in de productieomgeving implementeert. Gebruik het om uw manifest onderhoudbaar, veilig en gemakkelijker te doorgronden te houden.

Opbouw

• Begin met een sjabloon dat is geëxporteerd vanuit Rainbow Desktop of met een reeds gevalideerd manifest.
• Verwijder ongebruikte uitbreidingspunten voordat u het manifest in de productieomgeving implementeert.
• Zorg ervoor dat de versie op „2” staat en dat jsonType is ingesteld op „Rainbow-custo-manifest”.
• Definieer niet meer dan 3 acties voor hetzelfde uitbreidingspunt.
• Vermijd hardgecodeerde paden vanaf een ontwikkelaarscomputer. Gebruik ${custo.path} en verpak de bronbestanden in een ZIP-archief.

Beveiliging

• Geef vóór de implementatie alle REST- en iframe-oorsprongen op in de Custo-manifest-domeinen.
• Geef de voorkeur aan HTTPS-eindpunten met stabiele DNS-namen.
• Configureer voor REST-API’s CORS expliciet en test de preflight-verzoeken van de browser.
• Controleer voor servers in lokale/privé-netwerken het gedrag van Rainbow Web aan de hand van de regels voor lokale netwerktoegang.
• Verwerk geen geheime gegevens rechtstreeks in een manifest dat aan uw gebruikers wordt verspreid. Geef waar mogelijk de voorkeur aan tokens aan de serverzijde of tijdelijke inloggegevens.

Variabelen

• Gebruik de meest specifieke variabele die beschikbaar is voor het uitbreidingspunt.
• Test variabelen met realistische oproepen, contacten en bubbels; sommige waarden zijn leeg wanneer de context ontbreekt.
• Gebruik reguliere expressies alleen voor eenvoudige transformaties. Complexe transformaties dienen aan de serverzijde plaats te vinden.
• Controleer de formaten van telefoonnummers in Cloud PBX-, OmniPCX Enterprise- en OXO Connect-implementaties.

Adaptieve kaarten

• Houd kaarten kort en gericht op de actie van de gebruiker.
• Test de weergave op Rainbow Web en Desktop.
• Vermijd niet-ondersteunde Adaptive Card 1.6+-elementen, tenzij de doelversie van de Rainbow-client deze expliciet ondersteunt.
• Zorg er bij Action.Submit voor dat het doel-eindpunt idempotent is en geef duidelijke feedback aan de gebruiker.

Validatie vóór de productie

• Controleer de JSON-syntaxis.
• Test de lokale import vóór de centrale implementatie.
• Test het manifest op het web en op de desktop wanneer beide clients het doel vormen.
• Controleer alle vertrouwde domeinen, CORS-headers en iframe-headers.
• Implementeer eerst bij één pilotgebruiker of -profiel alvorens tot een bredere uitrol over te gaan.
• Bewaar een kopie van het vorige manifest, zodat u onmiddellijk kunt terugkeren naar de vorige versie.