Freeform
AI 지원 빌더로 EmDash에서 양식을 만듭니다. 스팸 점수, 이메일 알림, 웹훅, CSV 내보내기를 제공합니다.
플러그인
Freeform
AI 지원 빌더로 EmDash에서 양식을 만듭니다. 스팸 점수, 이메일 알림, 웹훅, CSV 내보내기를 제공합니다.
설명
Freeform for EmDash
양식을 만들고, 제출 내용을 수집하고, 그에 따라 조치하세요. EmDash를 떠날 필요가 없습니다.
양식 빌더
- 13가지 필드 유형: text, email, textarea, number, phone, date, checkboxes, radio, dropdowns, multi-select, hidden, HTML 블록
- 필드별 유효성 검사(길이, 패턴, 최소/최대)를 지원하는 행 기반 레이아웃
- 평범한 영어 설명으로 양식을 만들고 편집하는 AI 빌더
- 바로 사용할 수 있는 문의 및 뉴스레터 가입용 스타터 양식
제출 내용
- 페이지 나누기와 전체 상세 보기를 지원하는 검색 가능한 제출 받은편지함
- AI 제출 브리프: 의도, 긴급도, 핵심 사실, 권장되는 다음 조치
- 스프레드시트와 보고용 CSV 내보내기
자동화와 보호
- 재사용 가능한 템플릿으로 보내는 이메일 알림을 당신 또는 제출자에게 전송
- 자동 재시도와 전송 로그를 갖춘 서명된 웹훅(HMAC-SHA256)
- 모든 제출에 허니팟과 CSRF 보호가 적용되는 스팸 점수
- AI 에이전트가 양식을 관리하고 제출 내용을 읽을 수 있는 선택적 MCP 서버
양식은 함께 제공되는 @solspace/freeform-astro
패키지로 사이트에 렌더링되며, 이 패키지는 스타일이 없는 컴포넌트를 제공하므로 직접 CSS로 테마를 입힙니다.
설치
설치
1. 플러그인 설치
EmDash 관리자 화면에서 Plugins → Registry로 이동해 Freeform을 찾아 설치하세요. 설치하면 사이드바에 Freeform이 나타납니다.
2. 사이트에 양식 렌더링
Freeform의 관리자 화면은 플러그인 안에 있고, 공개 양식은 작은 동반 Astro 패키지가 렌더링합니다.
pnpm add @solspace/freeform-astro// astro.config.mjs
import { defineConfig } from "astro/config";
import emdash from "emdash/astro";
import freeformAstro from "@solspace/freeform-astro";
export default defineConfig({
integrations: [emdash(), freeformAstro()],
});그런 다음 핸들로 원하는 양식을 삽입합니다.
---
import { FreeformForm } from "@solspace/freeform-astro/components";
---
<FreeformForm formId="contact" />3. 선택 사항: AI 기능
AI 양식 빌더, 스팸 점수, 제출 브리프에는 본인의 Anthropic API 키가 필요합니다. Freeform → Settings에서 추가하세요. 키가 없어도 그 밖의 모든 기능, 즉 직접 양식 만들기, 제출 내용, 이메일, 웹훅은 정상적으로 작동합니다.
자주 묻는 질문
자주 묻는 질문
API 키가 필요한가요? AI 기능(AI 양식 빌더, AI 스팸 점수, 제출 브리프)에만 필요합니다. Freeform → Settings에 본인의 Anthropic API 키를 추가하세요. 양식, 제출 내용, 이메일 알림, 웹훅은 키 없이도 작동합니다.
제출 내용은 스팸으로부터 어떻게 보호되나요? 모든 양식에는 허니팟 필드와 서명된 CSRF 토큰이 포함됩니다. Anthropic 키를 추가하면 각 제출에 AI 스팸 점수도 매겨지며, 양식별 또는 전체로 설정할 수 있는 임계값을 기준으로 표시됩니다.
새 제출에 대한 알림을 받을 수 있나요? 네. 이메일 템플릿을 만들어 양식에 지정하고, 제출자(제출자의 이메일 필드 사용)에게 보낼지 고정된 주소로 보낼지 선택하세요. 제출할 때마다 임의의 URL로 서명된 웹훅을 보낼 수도 있습니다.
제출 내용을 어떻게 내보내나요? Submissions 보기에서 원하는 양식의 CSV를 다운로드하거나, 유효 기간이 짧은 내보내기 링크를 생성할 수 있습니다.
AI 에이전트가 내 양식을 관리할 수 있나요?
네. Freeform에는 선택적 MCP 서버(emdash-freeform-mcp)가 포함되어 있어,
Claude와 Cursor 같은 클라이언트에 양식 및 제출 내용 도구를 제공합니다.
렌더링된 양식에 스타일이 적용되어 있나요?
아니요. 의도된 설계입니다. @solspace/freeform-astro는
data-freeform-* 속성이 있는 시맨틱 HTML을 렌더링하므로 양식을 사이트의 디자인 시스템에 맞출 수 있습니다.
보안
보안
취약점 신고
[email protected]으로 이메일을 보내세요. 보안 문제는 공개 이슈로 올리지 마세요.
Freeform이 사이트를 보호하는 방법
- 제출 양식에는 허니팟 필드와 HMAC 서명이 있는 CSRF 토큰이 포함됩니다 (타이밍 공격에 안전한 검증, 만료 시간 2시간).
- 외부로 나가는 웹훅은 HMAC-SHA256(
X-Freeform-Signature)으로 서명되어 수신자가 진위를 확인할 수 있습니다. - 사용자가 제공한 API 키(예: Anthropic)는 사이트 자체의 플러그인 스토리지에 저장되며, Solspace로 전송되지 않습니다.
- 내보내기 링크는 유효 기간이 짧은 서명된 토큰이며, 자동으로 만료됩니다.