설명서CampaignCampaign Classic v7 설명서

스크립팅 및 코딩 지침 scripting-coding-guidelines

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

스크립팅

자세한 내용은 Campaign JSAPI 설명서를 참조하세요.

워크플로우, 웹 애플리케이션, jssp를 사용하여 스크립팅하는 경우 다음 모범 사례를 따르십시오.

  • SQL 문을 최대한 사용하지 않도록 하십시오.

  • 필요한 경우 문자열 연결 대신 매개 변수가 있는 (prepare 문) 함수를 사용하십시오.

    잘못된 방법:

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

    모범 사례:

    code language-none 
    sqlGetInt( "select iRecipientId from NmsRecipient where sEmail = $(sz) limit 1", request.getParameter('email'));
    note important
    IMPORTANT
    sqlSelect는 이 기능을 지원하지 않으므로 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()

허용 목록에 추가하다 SQL 주입을 방지하려면 Adobe Campaign에서 사용할 SQL 함수를 SQL 함수에 추가해야 합니다. 허용 목록에 추가하다에 추가되면 표현식 편집기에서 연산자에게 표시됩니다. 이 페이지를 참조하십시오.

IMPORTANT
8140 이전 빌드를 사용하는 경우 XtkPassUnknownSQLFunactionsToRDBMS 옵션이 '1'로 설정될 수 있습니다. 데이터베이스를 보호하려면 이 옵션을 삭제하거나 '0'으로 설정합니다.

쿼리 또는 SQL 문에서 필터를 만드는 데 사용자 입력을 사용하는 경우 항상 해당 필터를 이스케이프 처리해야 합니다(Campaign JSAPI 설명서 - 데이터 보호: 이스케이프 함수 참조). 이 함수들은 다음과 같습니다.

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

새로운 데이터 모델 보호

폴더 기본

다음 페이지를 참조하십시오.

명명된 권한

폴더 기반 보안 모델 외에도 명명된 권한을 사용하여 연산자 작업을 제한할 수 있습니다.

  • 데이터를 읽거나 쓰지 못하도록 일부 시스템 필터(sysFilter)를 추가할 수 있습니다(이 페이지 참조).

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

  • 스키마에 정의된 일부 작업(SOAP 메서드)을 보호할 수도 있습니다. 해당 명명된 권한을 값으로 사용하여 액세스 속성을 설정하기만 하면 됩니다.

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

    자세한 정보는 이 페이지를 참조하십시오.

IMPORTANT
탐색 트리의 명령 노드에서 명명된 권한을 사용할 수 있습니다. 더 나은 사용자 경험을 제공하지만 보호를 제공하지 않습니다(클라이언트측만 사용하여 숨기거나 비활성화하십시오). 액세스 속성을 사용해야 합니다.

오버플로 테이블

연산자 액세스 수준에 따라 기밀 데이터(스키마의 일부)를 보호해야 하는 경우 양식 정의(enabledIf/visibleIf 조건)에서 숨기지 마십시오.

전체 엔티티가 화면에 로드되면 열 정의에도 표시할 수 있습니다. 이렇게 하려면 오버플로 테이블을 만들어야 합니다. 이 페이지를 참조하세요.

웹 애플리케이션에서 captcha 추가

공용 랜딩 페이지/구독 페이지에 captcha를 추가하는 것이 좋습니다. 안타깝게도, DCE(디지털 콘텐츠 편집기) 페이지에서 captcha를 추가하는 것은 쉽지 않습니다. v5 captcha 또는 Google reCAPTCHA를 추가하는 방법을 살펴보겠습니다.

DCE에서 captcha를 추가하는 일반적인 방법은 페이지 콘텐츠 내에 쉽게 포함할 수 있는 개인화 블록을 만드는 것입니다. 스크립트 활동 및 테스트 ​를 추가해야 합니다.

개인화 블록

  1. Resources > Campaign Management > Personalization blocks(으)로 이동하여 새 폴더를 만드십시오.

  2. Web application 콘텐츠 형식을 사용하고 Visible in the customization menus ​을(를) 확인하십시오.

    자세한 정보는 이 페이지를 참조하십시오.

    다음은 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>
<%
}
%>

    • 1행부터 6행까지는 필요한 모든 입력을 생성한다.

    • 7행부터 끝까지 오류를 처리합니다.

    • 4행에서는 captcha 회색 상자 크기(폭/높이)와 생성된 단어의 길이(minWordSize/maxWordSize)를 변경할 수 있습니다.

    • Google reCAPTCHA를 사용하기 전에 Google에 등록하고 새 reCAPTCHA 사이트를 만들어야 합니다.

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

    유효성 검사 단추를 비활성화할 수 있어야 하지만 표준 단추/링크가 없으므로 HTML 자체에서 수행하는 것이 좋습니다. 방법을 알아보려면 이 페이지를 참조하세요.

웹 애플리케이션 업데이트

  1. 웹 응용 프로그램의 속성에 액세스하여 이름이 captchaValid ​인 부울 변수를 추가합니다.

  2. 마지막 페이지와 Storage 활동 사이에 Script 및 Test ​을(를) 추가합니다.

    분기 True ​을(를) Storage ​에 연결하고 다른 분기는 captcha를 포함할 페이지에 연결합니다.

  3. "[vars/captchaValid]"이(가) True인 분기 True의 조건을 편집합니다.

  4. Script 활동을 편집합니다. 콘텐츠는 선택한 captcha 엔진에 따라 다릅니다.

  5. 마지막으로 페이지에 개인화된 블록을 추가할 수 있습니다. 이 페이지를 참조하세요.

IMPORTANT
reCAPTCHA 통합의 경우 HTML(<head>...</head>의)에 클라이언트측 JavaScript을 추가해야 합니다.
<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

6행: 모든 종류의 오류 메시지를 넣을 수 있습니다.

Google recaptcha

공식 설명서를 참조하세요.

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

JSON.parse를 사용하려면 webApp에 "shared/json2.js"을 포함해야 합니다.

빌드 8797부터 확인 API URL을 사용하려면 urlPermission 노드에 를 추가하여 serverConf 파일의 허용 목록에 추가하다에 추가해야 합니다.

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

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