Linee guida per scripting e codifica scripting-coding-guidelines

Scripting

Per ulteriori informazioni, consulta Documentazione JSAPI per Campaign.

Se esegui uno script utilizzando workflow, applicazioni web e jssp, segui le best practice:

Per evitare SQL injection, è necessario aggiungere le funzioni SQL al inserisco nell'elenco Consentiti di da utilizzare in Adobe Campaign. Una volta aggiunte al inserisco nell'elenco Consentiti di, queste diventano visibili agli operatori nell’editor di espressioni. Consulta questa pagina.

Se utilizzi l’input dell’utente per generare filtri nelle query o nelle istruzioni SQL, devi sempre eseguirne l’escape (consulta Documentazione JSAPI per Campaign - Protezione dei dati: escape functions). Queste funzioni sono:

Protezione del nuovo modello dati

Base cartella

Consulta queste pagine:

Diritti denominati

Oltre al modello di protezione basato su cartelle, è possibile utilizzare i diritti denominati per limitare le azioni dell'operatore:

Tabella di overflow

Se devi proteggere i dati riservati (parte di uno schema) a seconda del livello di accesso dell’operatore, non nasconderli nella definizione del modulo (condizioni enabledIf/visibleIf).

L’entità completa viene caricata dalla schermata, e puoi anche visualizzarla nella definizione della colonna. A questo scopo, è necessario creare una tabella di overflow. Fai riferimento a questa pagina.

Aggiunta di captcha nelle applicazioni web

È buona prassi aggiungere un captcha nelle pagine di destinazione pubbliche o nelle pagine di abbonamento. Sfortunatamente, aggiungere un captcha nelle pagine DCE (Digital Content Editor) non è facile. Ti mostreremo come aggiungere un captcha v5 o un reCAPTCHA Google.

Il modo generale per aggiungere un captcha nel DCE consiste nel creare un blocco di personalizzazione per includerlo facilmente nel contenuto della pagina. Dovrai aggiungere una Script attività e un Test.

Blocco di personalizzazione

Aggiornamento dell’applicazione web

Campaign captcha

var captchaID = request.getParameter("captchaID");
var captchaValue = request.getParameter("captchaValue");

if( !CaptchaValidate(captchaID, captchaValue) ) {
  serverForm.logInputError("captchaValue",
                           "The characters you typed for the captcha must match the image ones.",
                           "captchaValue")
  ctx.vars.captchaValid = false
}
else
  ctx.vars.captchaValid = true

Riga 6: puoi inserire qualsiasi messaggio di errore.

Google recaptcha

Consulta la sezione documentazione ufficiale.

ctx.vars.captchaValid = false
var gReCaptchaResponse = request.getParameter("g-recaptcha-response");

// Call reCaptcha API to validate it
var req = new HttpClientRequest("https://www.google.com/recaptcha/api/siteverify")
req.method = "POST"
req.header["Content-Type"] = "application/x-www-form-urlencoded"
req.body = "secret=YOUR_SECRET_HERE&response=" + encodeURIComponent(gReCaptchaResponse)
req.execute()
var response = req.response
if( response.code == 200 ) {
  captchaRes = JSON.parse(response.body.toString(response.codePage));
  ctx.vars.captchaValid = captchaRes.success
}

if( ctx.vars.captchaValid == false ) {
  serverForm.logInputError("reCaptcha",
                           "Please validate the captcha",
                           "reCaptcha")
  logInfo("reCaptcha not validated")
}

Per utilizzare JSON.parse è necessario includere "shared/json2.js" nel WebApp:

A partire dalla build 8797, per utilizzare l’URL dell’API di verifica, è necessario aggiungerlo al inserisco nell'elenco Consentiti di nel file serverConf aggiungendo nel nodo urlPermission:

<url dnsSuffix="www.google.com" urlRegEx="https://www.google.com/recaptcha/api/siteverify"/>