DokumentationCampaignDokumentation för Campaign Classic v7

[v7]{class="badge informative" title="Gäller endast Campaign Classic v7"}

Riktlinjer för skript och kodning scripting-coding-guidelines

Last update: Tue Mar 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skript

Mer information finns i Kampanj-JSAPI-dokumentation.

Om du skriptar med arbetsflöde, webbprogram, jssp, ska du följa dessa rutiner:

  • Försök att undvika SQL-satser så mycket du kan.

  • Om du behöver det använder du parametriserade funktioner (förbered-sats) i stället för strängsammanfogning.

    Felaktig praxis:

    code language-none 
    sqlGetInt( "select iRecipientId from NmsRecipient where sEmail ='" + request.getParameter('email') +  "'  limit 1" )

    God praxis:

    code language-none 
    sqlGetInt( "select iRecipientId from NmsRecipient where sEmail = $(sz) limit 1", request.getParameter('email'));
    note important
    IMPORTANT
    sqlSelect stöder inte den här funktionen, så du måste använda frågefunktionen i klassen DBEngine:
    code language-none 
    var cnx = application.getConnection()
var stmt = cnx.query("SELECT sFirstName, sLastName FROM NmsRecipient where sEmail = $(sz)", request.getParameter('email'))
for each(var row in stmt) logInfo(row[0] + " : " + row[1])
cnx.dispose()

För att undvika SQL-injektioner måste SQL-funktioner läggas till i tillåtelselista som ska användas i Adobe Campaign. När de har lagts till i tillåtelselista blir de synliga för dina operatorer i uttrycksredigeraren. Se den här sidan.

IMPORTANT
Om du använder en version som är äldre än 8 140 är XtkPassUnknownSQLFunactionsToRDBMS kan anges till "1". Om du vill skydda databasen tar du bort det här alternativet (eller anger värdet 0).

Om du använder användarindata för att skapa filter i frågor eller SQL-satser måste du alltid undvika dem (se Kampanj-JSAPI-dokumentation - Dataskydd: funktioner för flytning). De här funktionerna är:

  • NL.XML.escape(data)
  • NL.SQL.escape(data)
  • NL.JS.escape(data)
  • NL.XML.escapeAttribute(data)

Skydda din nya datamodell

Mappbas

Se följande sidor:

Namngivna rättigheter

Förutom den mappbaserade säkerhetsmodellen kan du använda namngivna rättigheter för att begränsa operatoråtgärder:

  • Du kan lägga till vissa systemfilter (sysFilter) för att förhindra att data läses/skrivs (se den här sidan).

    code language-none 
    <sysFilter name="writeAccess">
    <condition enabledIf="hasNamedRight('myNewRole')=false" expr="FALSE"/>
</sysFilter>

  • Du kan även skydda vissa åtgärder (SOAP-metod) som definieras i scheman. Ange bara åtkomstattributet med motsvarande namngiven rättighet som värde.

    code language-none 
    <method name="grantVIPAccess" access="myNewRole">
    <parameters>
...
    </parameters>
</method>

    Mer information finns på den här sidan.

IMPORTANT
Du kan använda namngivna rättigheter i kommandonoden i ett navigeringsträd. Det ger en bättre användarupplevelse men ger inget skydd (använd bara klientsidan för att dölja/inaktivera dem). Du måste använda åtkomstattributet.

Överflödestabell

Om du behöver skydda konfidentiella data (del av ett schema) beroende på operatörens åtkomstnivå, ska du inte dölja dem i formulärdefinitionen (enabledIf/visibleIf-villkor).

Den fullständiga enheten läses in av skärmen och du kan även visa dem i kolumndefinitionen. För att göra detta måste du skapa en flödestabell. Referens den här sidan.

Lägga till bildtexter i webbprogram

Det är en god vana att lägga till en captcha på offentliga landningssidor/prenumerationssidor. Tyvärr är det inte så enkelt att lägga till en captcha på DCE-sidor (Digital Content Editor). Vi visar hur du lägger till en v5-captcha eller en Google reCAPTCHA.

Det allmänna sättet att lägga till en captcha i DCE är att skapa ett personaliseringsblock som enkelt kan inkluderas i sidinnehållet. Du måste lägga till en Skript aktivitet och Testa.

Personaliseringsblock

  1. Gå till Resources > Campaign Management > Personalization blocks och skapa en ny.

  2. Använd Web application innehållstyp och kontroll Visible in the customization menus.

    För mer information om detta hittar du i det här avsnittet.

    Här är ett exempel på en Campaign captcha:

    code language-javascript 
    <%
var captchaID = CaptchaIDGen();
%>
<img src="/nms/jsp/captcha.jsp?captchaID=<%=captchaID%>&width=200&height=50&minWordSize=8&maxWordSize=8"/>
<input id="captchaValue" name="captchaValue" <%= String(ctx.vars.captchaValid) === "false" ? class="ui-state-error" : "" %>>
<input type="hidden" name="captchaID" value="<%=captchaID%>"/>
<%
if( serverForm.isInputErroneous("captchaValue") ) {
%>
<script type="text/javascript">
$("#captchaValue").addClass("ui-state-error")
</script>
<%
}
%>

    • Rader 1 till 6 genererar alla indata som behövs.

    • Rader 7 till slutet hanterar fel.

    • Med rad 4 kan du ändra storleken på den inmatade gråa rutan (bredd/höjd) och längden på det genererade ordet (minWordSize/maxWordSize).

    • Innan du använder Google reCAPTCHA måste du registrera dig på Google och skapa en ny reCAPTCHA-webbplats.

      <div class="g-recaptcha" data-sitekey="YOUR_SITE_KEY"></div>

    Du bör kunna inaktivera valideringsknappen, men eftersom vi inte har någon standardknapp/länk är det bättre att göra det i själva HTML. Om du vill veta hur du gör det kan du läsa den här sidan.

Uppdatera ditt webbprogram

  1. Gå till egenskaperna för webbprogrammet och lägg till en boolesk variabel med namnet captchaValid.

  2. Mellan den sista sidan och Storage aktivitet, lägga till Script och Test.

    Anslut grenen True till Storage och den andra till sidan som ska ha captcha.

  3. Redigera villkoret för grenen True med "[vars/captchaValid]" är lika med True.

  4. Redigera Script aktivitet. Innehållet beror på den valda captcha-motorn.

  5. Slutligen kan du lägga till ditt personliga block på sidan: se den här sidan.

IMPORTANT
För reCAPTCHA-integrering måste du lägga till JavaScript på klientsidan i HTML (i <head>...</head>):
<script src="https://www.google.com/recaptcha/api.js" async defer></script>

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

Rad 6: du kan skicka vilket felmeddelande som helst.

Google recaptcha

Läs mer i officiell dokumentation.

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")
}

Om du vill använda JSON.parse måste du inkludera"shared/json2.js" i din webApp:

Sedan build 8797 måste du lägga till den i tillåtelselista i filen serverConf för att kunna använda URL:en för verifierings-API:t genom att lägga till den i noden urlPermission:

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

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1