# Appendix ### DB 데이터 복호화 기능 사용자로부터 DB 메시지 테이블에 데이터가 암호화되어 입력되는 경우, 복호화하는 기능에 관련하여 설정합니다.\ 설정파일에 존재하는 아래 항목에 대해 입력 또는 변경하여 사용하시기를 바랍니다. ``` ############################################## # DB 데이터 복호화기능 사용여부 # (A:API P:PLUGIN N:NONE) DB_DATA_DECRYPTION = N # 복호화 대상 필드명 DB_DATA_DECRYPTION_FIELD = # 암호화 구분 필드 사용여부 DB_DATA_DECRYPTION_SEPARATION_FIELD = # PLUGIN 방식의 경우, 함수명 DB_DATA_DECRYPTION_FUNCTION # PLUGIN 방식의 경우, 추가 매개변수 # 복수개일 경우 |(파이프라인)로 구분하여 입력 # 예) DB_DATA_DECRYPTION_PARAMETER = 1 | 'PHONE' DB_DATA_DECRYPTION_PARAMETER = # PLUGIN 방식의 경우, 복호화 대상 필드명의 매개변수 위치 (기본 : 1) DB_DATA_DECRYPTION_FIELD_LOCATION = # API 방식의 경우, 암호화 DB_DATA_DECRYPTION_KEY = ############################################## ``` #### #### 1. DB\_DATA\_DECRYPTION 복호화 기능 사용 여부(방식)을 설정합니다. * \- A(API) : 어플리케이션에서 AES 방식으로 복호화 하여 사용. * \- P(PLUG-IN) : DBMS 에 Plug-In 방식으로 설치되어 있는 복호화 모듈(함수)를 사용. * \- N(NONE) : 사용하지 않음. #### 2. DB\_DATA\_DECRYPTION\_FIELDS 복호화 대상 필드 명을 설정합니다. 기본값은 MSG\_BODY 와 RE\_BODY 입니다. 복수로 입력하는 경우, |(파이프라인)로 구분하여 입력합니다. 예) MSG\_BODY|RE\_BODY #### 3. USE\_DECRYPTION\_SEPARATION\_FIELD (Y/N) 복호화 기능을 사용하는 경우, 복호화에 대해 구분하는 필드 사용 여부를 설정합니다.\ 기본 값은 Y이며, 구분하는 필드 명은 USE\_DECRYPT 입니다. #### 4. DB\_DATA\_DECRYPTION\_FUNCTION PLUG-IN 방식을 사용하는 경우, 복호화 모듈(함수)명을 설정합니다. 예) DECRYPT\_FUNCTION #### 5. DB\_DATA\_DECRYPTION\_PARAMETER\_COUNT PLUG-IN 방식을 사용하는 경우, 복호화 함수의 매개변수 개수를 설정합니다. ( 기본 : 1 )\\ #### 6. DB\_DATA\_DECRYPTION\_PARAMETER\_1 PLUG-IN 방식을 사용하는 경우, 복호화 함수의 매개변수를 입력합니다\ DB\_DATA\_DECRYPTION\_FIELDS 에 입력한 필드명 위치를 비워두시면 모듈에서 자동으로 입력합니다. \ 예 ) 함수 1 : DECRYPT\_FUNCTION(1, 'PHONE', MSG\_BODY)\ 예 ) 함수 2 : DECRYPT\_FUNCTION(1, 'PHONE', RE\_BODY) DB\_DATA\_DECRYPTION\_PARAMETER\_COUNT = 3\ DB\_DATA\_DECRYPTION\_PARAMETER\_1 = 1\ DB\_DATA\_DECRYPTION\_PARAMETER\_2 = 'PHONE'\ DB\_DATA\_DECRYPTION\_PARAMETER\_3 = #### 7. DB\_DATA\_DECRYPTION\_KEY API 방식을 사용하는 경우, 복호화하는 키를 설정합니다.\ 입력된 키는 비즈클라이언트가 정상적으로 구동되면 자동으로 암호화되어 저장됩니다. ### 백업 수행 시, 메시지 본문 길이 보관 #### 1. USE\_BACKUP\_PERSONAL\_DATA\_PROCESSING (Y/N) 발송 완료된 메시지에 대해 메시지테이블에서 로그테이블로 백업할 때,\ 사용자로부터 입력된 메시지에 대해서 길이만 저장하도록 설정합니다. (대상 : MSG\_BODY, RE\_BODY) ### 첨부파일 관리 설정 #### 1. FILE\_HANDLING\_MODE 첨부파일 관리 모드를 설정합니다. * \- 0 : DEFAULT. 첨부파일 데이터를 MSG\_TABLE 에서 관리합니다. 첨부파일 전송 시 파일명 (여러 개일 경우, '|' 문자로 구분) * \- 1 : 첨부파일 컬럼을 추가하여 데이터를 관리합니다.\ FILE\_PATH1 부터 FILE\_PATH5 까지의 5 개의 컬럼을 사용자가 추가해야 하며 파일명을 포함한 모든 경로를 입력해야 합니다. * \- 2 : 첨부파일 테이블을 추가하여 첨부파일 데이터를 관리합니다.\ 첨부파일 등록 시 데이터 타입 입력이 필요하며 JSON String Type 을 사용할 수 있습니다 (여러 개의 파일 등록 시 동일한 MSG\_KEY 입력)\ \- FILE : DEFAULT. 파일명\ \- HTTP : http/https 로 시작하는 URL\ \- JSON : 알림톡/친구톡 발송 시 버튼 정보 JSON 데이터 > FILE\_HANDLING\_MODE = 2 사용시 AT + ATTACHMENT 발송 예 (BIZ\_MSG TABLE) **AT + ATTACHEMENT** ```sql INSERT INTO biz_msg ( MSG_TYPE, CMID, REQUEST_TIME, SEND_TIME, DEST_PHONE, SEND_PHONE, MSG_BODY, TEMPLATE_CODE, SENDER_KEY, NATION_CODE, RE_TYPE, RE_BODY, ATTACHED_FILE) VALUES ( 6, ‘201XXXXXXXXX’, NOW(), NOW(), ‘01012341234’, ‘0212341234’, ‘홍길동 고객님 다우기술 비즈메시지 프로모션에 당첨 되었습니다.’, {템플릿코드}, {발신프로필키}, ‘82’, ‘MMS’, ‘[다우기술] 응모하신 프로모션에 당첨되셨습니다.’,‘msgKey1’) ``` **BIZ\_ATTACHMENTS TABLE**
MSG_KEYSEQTYPECONTENTS
msgKey1{숫자}FILE{첨부파일명.jpg}
msgKey1{숫자}HTTPhttp://www.daou.co.kr/file/jpg.jpg
msgKey1{숫자}JSON아래 msgKey JSON 참고
**msgKey JSON** {% hint style="info" %} json 을 그대로 삽입할 수 있는 옵션입니다. (FILE\_HANDLING\_MODE = 2) {% endhint %} ```json5 { "button": [ { "name": "미리 주문하기", "type": "WL", "url_mobile": "http://www.kakao.com" }, { "name": "상담원 연결하기", "type": "MD" }, { "name": "방송 알림 설정 보기", "type": "AL", "scheme_android": "daumapps://open", "scheme_ios": "daumapps://open" } ] } ``` **2. ABSOLUTE\_PATH\_OPTION (Y/N)** 첨부파일명 등록 시 상대경로/절대경로를 설정합니다. * \- N (상대경로) : 테이블에 파일명을 입력하고 기본 경로( ./spool ) 폴더에 파일을 등록하여 사용합니다. * \- Y (절대경로) : 테이블에 파일명을 포함한 모든 경로(ex. D:/img.jpg )를 입력하여 사용합니다. ### 모듈 재구동시 오래된 데이터 처리 옵션 #### 1. SEND\_VALID\_TIME (0 \~ 1440, MINUTE) 모듈 재구동 및 DB 세션 재 연결시 실패 처리 할 발송 유효시간을 설정합니다. (대상 컬럼 : SEND\_TIME) * DEFAULT : 180 ( 3시간 ) * 0 : 사용하지 않음 * 1\~1440 : 재구동 시점 기준 1\~1440 분 지난 미발송 메시지 실패 처리 (결과 코드 :9034) ### 잔존 메시지 처리 옵션 네트워크 장애 및 모듈 비정상 종료 등의 사유로 백업되지 않고 메시지 테이블에 남아있는 메시지를 서버에 결과 리포트를 요청하거나 실패로 결과 처리하여 백업 테이블로 이동 되도록 하 옵션입니다. 해당 기능은 BATCH 스레드에서 5 분 간격으로 동작합니다. {% hint style="danger" %} 해당옵션 사용시 실제 비즈서버의 통계와 고객사 DB 의 통계의 불일치가 발생할 수 있습니다. {% endhint %} #### 1. REPORT\_RECONFIRM\_OPTION (Y/N) 상태값(STATUS)이 1(발송 후 대기) 이고 발송시간이 55 시간(최대 리포트 타임아웃시간)이 지난 메시지에\ 대해 리포트를 1회 재 요청 하고 상태값을 3으로 변경합니다.\ 또한 발송시간 기준으로 3 일(클라이언트 타임아웃시간) 이내 리포트 수신이 되지 않으면 실패 결과처리를 하여 백업 테이블로 이동되도록 합니다. * DEFAULT : N * 결과코드 : 9023 #### 2. REPORT\_RECONFIRM\_COUNT REPORT\_RECONFIRM\_OPTION 을 사용하는 경우 대상 메시지 FETCH COUNT * DEFAULT : 100 #### 3. REMOVE\_PRESEND\_MSG\_OPTION (Y/N) 상태값(STATUS)이 7(발송 중)이고 발송시간이 3 일(클라이언트 타임아웃시간)이 지난 메시지에 대해 실패 결과처리를 하여 백업 테이블로 이동되도록 합니다. * DEFAULT : N * 결과코드 : 9037 #### 4. REMOVE\_PRESEND\_MSG\_COUNT REMOVE\_PRESEND\_MSG\_OPTION 을 사용하는 경우 대상 메시지 FETCH COUNT * DEFAULT : 100 #### 5. WAIT\_REPORT\_HOUR 최대 리포트 타임아웃시간(서버로부터 리포트가 수신될 수 있는 시간)을 설정합니다. * \- DEFAULT : 55 * \- MIN : 55 #### 6. CLIENT\_TIMEOUT\_HOUR 클라이언트 타임아웃시간을 설정합니다. * \- DEFAULT : 72 * \- MIN : 56 (WAIT\_REPORT\_HOUR + 1) ### RCS AGENCY\_ID(대행사 ID) 설정 (biz\_\_client\_\_v3000 이상) AGENCY\_ID 는 대행사 ID 로 발신번호(chatbotId)에 대한 발송 권한이 대행사에 있는지 체크하며,\ 권한 없을 시 발송 실패됩니다.\ 다우기술의 대행사 ID 는 "daoutech"이며, 파라미터를 설정하지 않는 경우 해당 값으로 기본 설정됩니다. 환경 설정 파일을 수정합니다.\ \&#xNAN;**{모듈경로}/config/data/columns-{DBMS}.json** 1. RCS BUTTONS 컬럼 정보 아래 RCS AGENCY\_ID 컬럼 정보를 추가합니다.
기존추가
  "constraints":"",
  "usage":"ALL"
  },{
    "description":"RCS_TABLE_RCS_BUTTON",
    "name":"BUTTONS",
    "datatype":"VARCHAR(2000)",
    "constraints":"",
    "usage":"ALL",
    "telegramKey":"BUTTONS"
  }
]

  "usage":"ALL"
  "telegramKey":"BUTTONS"
  },{
    "description":"RCS_TABLE_AGENCY_ID",
    "name":"AGENCY_ID",
    "datatype":"VARCHAR(20)",
    "constraints":"",
    "usage":"ALL",
    "telegramKey":"AGENCY_ID"
  }
]
2\. 기존 BIZ\_RCS 테이블이 존재한다면\_ AGENCY\_ID VARCHAR(20) 컬럼을 추가합니다. 3\. 모듈 재 구동 후 AGENCY\_ID 컬럼에 대행사 ID를 입력하여 발송합니다. ### RESELLERCODE **최초 발신사업자 식별코드 설정 (biz\_client\_v3015 이상)** RESELLERCODE 는 특부가사업자 등록번호(9 자리 숫자로 구성)를 의미합니다. 1. USE\_RESELLERCODE (Y/N) 옵션 설정 메시지 발송시 식별코드를 포함하여 전송합니다. \- DEFAULT : N 2. 메시지/로그 테이블 RESELLERCODE VARCHAR(10) 컬럼 추가 \- 신규 설치시 위 옵션을 설정 후 구동하면 자동으로 추가됩니다.\ \- 기존 테이블(BIZ\_MSG/BIZ\_LOG)이 존재한다면 테이블 삭제 후 모듈을 재구동하거나 해당 컬럼을 추가하여 발송 가능합니다. ### 중복 발송 제한 설정 (biz\_client\_v3016 이상만 해당) 중복 발송 제한 설정이란 수신번호 및 본문 내용이 동일한 메시지에 대해 첫 발송 후 일정 시간동안 발송을 차단하는 기능을 의미합니다. * 제한 대상 메시지 타입 : SMS, LMS, MMS, AT, FT, RCS * 버튼 및 첨부파일, 대체발송 메시지 내용은 비교하지 않습니다. 1. DUPLICATE\_SENDING\_POLICY * 0 : DEFAULT. 중복 발송 제한 기능 사용 안함 * 1 : 수신번호 기준으로 중복 발송 제한 * 2 : 수신번호 및 메시지 내용을 기준으로 중복 발송 제한 2\. DUPLICATE\_SENDING\_MONIT\_SECONDS (30 \~ 60, SECONDS) 메시지 발송 후 동일한 메시지에 대해 모니터링하는 시간을 설정합니다. * DEFAULT : 30 * MIN : 30 * MAX : 60 3\. DUPLICATE\_SENDING\_ALLOW\_COUNT 모니터링 시간 동안 첫 발송을 포함한 발송 허용 수를 설정합니다. * DEFAULT : 1 * MIN : 1 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://biztech.gitbook.io/bizclient-manual-v4.8.1/appendix.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.