라이브폼 암호화 설정과 보안 전송 설정을 통해 안전한 데이터 전송과 보관을 지원합니다.
라이브폼 암호화 설정
라이브폼의 암호화 설정을 통해 보다 높은 수준의 사용자 제출에 대한 보안 상태를 유지할 수 있습니다.
라이브폼 암호화 설정 화면
암호화 알고리즘 방식 선택
라이브폼 URL의 Query String에서 암호화가 필요한 경우, 선택한 암호화 알고리즘 방식과 암호화 키를 사용하여 데이터를 암호화해야 합니다.| 알고리즘 | 설명 |
|---|---|
| ECB (Electronic Codebook) | 빠르고 간단한 블록 암호화 방식 |
| GCM (Galois/Counter Mode) | 인증 및 무결성 기능을 포함한 강화된 암호화 방식 |
알고리즘 선택 후 사용 방법암호화 알고리즘을 선택한 후, 라이브폼 URL의 Query String에서 암호화가 필요한 파라미터는 반드시 선택한 알고리즘 방식과 암호화 키를 통해 암호화한 후,
encrypted={암호화된_데이터} 형태로 사용해야 합니다.암호화 전용 모드
모든 Query String 파라미터를 암호화하여 사용하고 싶은 경우, 암호화 전용 모드를 활성화합니다.
암호화 전용 모드 설정
pid, encrypted, lang 파라미터만 허용되며, 다른 모든 파라미터는 암호화되어 encrypted 파라미터에 포함되어야 합니다.
허용되는 URL 형식:
암호화 키 관리
암호화에 사용될 키를 관리합니다. API KEY를 사용하거나 전용 키(secretKey)를 발급받아 사용할 수 있습니다.
암호화 키 관리 화면

암호화 키 발급 팝업
| 키 종류 | 설명 |
|---|---|
| API KEY | 프로젝트에 부여된 기본 API 키를 암호화 키로 사용 |
| 전용 키 (secretKey) | 라이브폼에서 신규로 발급받아 사용하는 전용 암호화 키 |
라이브폼 URL 암호화 사용 방법
라이브폼 URL에서 Query String 파라미터를 암호화하여 사용하는 방법을 안내합니다.Step 1: 암호화할 데이터 준비
암호화할 Query String 파라미터를 JSON 형식으로 준비합니다.암호화 불가 파라미터
pid, lang 쿼리 스트링 및 ‘추가 프로세스 (Injection)’ 페이지에서 사용하는 sid, action 쿼리 스트링은 암호화를 지원하지 않습니다. 단, Injection 사용 시 sid와 action은 encrypted 파라미터 내부에 포함하여 암호화해야 합니다.Step 2: 암호화 수행
선택한 암호화 알고리즘(ECB 또는 GCM)과 암호화 키(API KEY 또는 secretKey)를 사용하여 데이터를 암호화합니다.암호화 가이드
상세한 암호화/복호화 방법과 코드 예시를 확인하세요.
Step 3: 암호화된 데이터를 URL에 추가
암호화된 데이터를encrypted 쿼리 파라미터에 추가합니다.
URL 인코딩암호화된 데이터는 URL에 사용하기 전에 반드시 URL 인코딩을 수행해야 합니다.
보안 전송 설정
API 메서드를 통한 데이터 전송 시 보안을 강화하는 설정입니다.
보안 전송 설정 화면
안전한 데이터 전송
안전한 데이터 전송 옵션을 활성화하면, 아르고스와 고객사 간의 모든 데이터 전송이 암호화됩니다.| 설정 | 설명 |
|---|---|
| 안전한 데이터 전송 | API 메서드(GET, POST, PATCH 등)와 웹훅에서 데이터를 암호화하여 전송합니다. |
API 요청 데이터 암호화
안전한 데이터 전송이 활성화된 경우, API 요청 시 Request Body를 반드시 암호화하여 전송해야 합니다. 암호화 방식:- API 요청 (GET, POST, PATCH): AES-256-ECB 방식
- 웹훅 데이터: AES-256-CBC 방식
API 응답 데이터 복호화
안전한 데이터 전송이 활성화된 경우, API 응답도 암호화되어 전송되므로 복호화가 필요합니다. 응답 형식:웹훅 데이터 암호화/복호화
웹훅 데이터는 AES-256-CBC 방식으로 암호화됩니다.암호화 가이드
웹훅 데이터 암호화/복호화 방법을 자세히 확인하세요.
설정 시나리오별 가이드
시나리오 1: 선택적 암호화 사용
시나리오 1: 선택적 암호화 사용
암호화 알고리즘을 선택하고 일부 Query String만 암호화하여 사용하는 경우입니다.설정:이 경우
- 암호화 알고리즘: ECB 또는 GCM 선택
- 암호화 키: API KEY 또는 전용 키 선택
- 암호화 전용 모드: 비활성화
email은 일반 파라미터로, token 등 민감한 정보는 encrypted 파라미터에 암호화하여 포함합니다.시나리오 2: 전체 암호화 사용 (암호화 전용 모드)
시나리오 2: 전체 암호화 사용 (암호화 전용 모드)
모든 Query String 파라미터를 암호화하여 사용하는 경우입니다.설정:이 경우
- 암호화 알고리즘: ECB 또는 GCM 선택
- 암호화 키: API KEY 또는 전용 키 선택
- 암호화 전용 모드: 활성화
pid, lang을 제외한 모든 파라미터는 encrypted 파라미터에 암호화하여 포함해야 합니다.시나리오 3: API 데이터 전송 보안 강화
시나리오 3: API 데이터 전송 보안 강화
API를 통한 데이터 전송 시 보안을 강화하는 경우입니다.설정:
- 안전한 데이터 전송: 활성화
- 모든 API 요청(Request Body) 암호화
- 모든 API 응답(Response Body) 복호화
- 웹훅 수신 데이터 복호화