마케팅 이메일을 스팸으로부터 보호하는 API 구축

이메일 마케팅 캠페인을 실행할 때 가장 큰 과제 중 하나는 메시지가 스팸 폴더가 아닌 받은 편지함에 도달하는지 확인하는 것입니다.

Apache SpamAssassin은 메시지를 스팸으로 분류하기 위해 많은 이메일 클라이언트 및 이메일 필터링 도구에 널리 사용되는 도구입니다. 이 게시물에서는 SpamAssassin을 활용하여 이메일이 스팸으로 표시되는지 여부와 스팸으로 표시되는 이유를 확인하는 방법을 살펴보겠습니다.
로직은 API로 패키징되어 온라인으로 배포되므로 워크플로에 통합될 수 있습니다.

왜 Apache SpamAssassin인가?

Apache SpamAssassin은 Apache Software Foundation에서 관리하는 오픈 소스 스팸 탐지 플랫폼입니다. 다양한 규칙, 베이지안 필터링 및 네트워크 테스트를 사용하여 특정 이메일에 스팸 "점수"를 할당합니다. 일반적으로 5점 이상의 이메일은 스팸으로 분류될 위험이 높습니다.

SpamAssassin의 점수는 투명하고 잘 문서화되어 있으므로 이를 사용하여 이메일의 어떤 측면이 높은 스팸 점수를 유발하는지 정확히 식별하고 글쓰기를 향상시킬 수도 있습니다.

SpamAssassin 시작하기

SpamAssassin은 Linux 시스템에서 실행되도록 설계되었습니다. 설치하고 실행하려면 Linux OS가 필요하거나 Docker VM을 생성해야 합니다.

Debian 또는 Ubuntu 시스템에서는 다음을 사용하여 SpamAssassin을 설치합니다.

apt-get update && apt-get install -y spamassassin
sa-update

sa-update 명령은 SpamAssassin의 규칙이 최신 상태인지 확인합니다.

설치하고 나면 이메일 메시지를 SpamAssassin의 명령줄 도구로 연결할 수 있습니다. 출력에는 스팸 점수가 포함된 주석이 달린 이메일 버전이 포함되며 어떤 규칙이 실행되는지 설명합니다.

일반적인 사용법은 다음과 같습니다.

spamassassin -t  results.txt

results.txt에는 SpamAssassin의 헤더 및 점수와 함께 처리된 이메일이 포함됩니다.

FastAPI를 사용하여 SpamAssassin을 API로 래핑

다음으로 제목과 html_body라는 두 개의 이메일 필드를 허용하는 간단한 API를 만들어 보겠습니다. 필드를 SpamAssassin에 전달하고 검증 결과를 반환합니다.

FastAPI 코드 예

from fastapi import FastAPI
from datetime import datetime, timezone
from email.utils import format_datetime
from pydantic import BaseModel
import subprocess
import re

def extract_analysis_details(text):
    rules_section = re.search(r"Content analysis details:.*?(pts rule name.*?description.*?)\n\n", text, re.DOTALL)
    if not rules_section:
        return []

    rules_text = rules_section.group(1)
    pattern = r"^\s*([-\d.]+)\s+(\S+)\s+(.+)$"
    rules = []
    for line in rules_text.splitlines()[1:]:
        match = re.match(pattern, line)
        if match:
            score, rule, description = match.groups()
            rules.append({
                "rule": rule,
                "score": float(score),
                "description": description.strip()
            })
    return rules

app = FastAPI()

class Email(BaseModel):
    subject: str
    html_body: str

@app.post("/spam_check")
def spam_check(email: Email):
    # assemble the full email
    message = f"""From: example@example.com
To: recipient@example.com
Subject: {email.subject}
Date: {format_datetime(datetime.now(timezone.utc))}
Content-Type: text/html; charset="UTF-8"

{email.html_body}"""

    # Run SpamAssassin and capture the output directly
    output = subprocess.run(["spamassassin", "-t"], 
                            input=message.encode('utf-8'), 
                            capture_output=True)

    output_str = output.stdout.decode('utf-8', errors='replace')
    details = extract_analysis_details(output_str)
    return {"result": details}

응답에는 SpamAssassin 결과에 대한 분석 세부정보가 포함됩니다.

다음 입력을 예로 들어보겠습니다.

subject:
Test Email

html_body:

  
    <p>This is an <b>HTML</b> test email.</p>
  

응답은 다음과 같습니다.

[
  {
    "rule": "MISSING_MID",
    "score": 0.1,
    "description": "Missing Message-Id: header"
  },
  {
    "rule": "NO_RECEIVED",
    "score": -0.0,
    "description": "Informational: message has no Received headers"
  },
  {
    "rule": "NO_RELAYS",
    "score": -0.0,
    "description": "Informational: message was not relayed via SMTP"
  },
  {
    "rule": "HTML_MESSAGE",
    "score": 0.0,
    "description": "BODY: HTML included in message"
  },
  {
    "rule": "MIME_HTML_ONLY",
    "score": 0.1,
    "description": "BODY: Message only has text/html MIME parts"
  },
  {
    "rule": "MIME_HEADER_CTYPE_ONLY",
    "score": 0.1,
    "description": "'Content-Type' found without required MIME headers"
  }
]

API 온라인 배포

SpamAssassin을 실행하려면 소프트웨어가 설치된 Linux 환경이 필요합니다. 일반적으로 배포하려면 EC2 인스턴스나 DigitalOcean 드롭릿이 필요할 수 있으며, 이는 특히 사용량이 적은 경우 비용이 많이 들고 지루할 수 있습니다.

서버리스 플랫폼의 경우 SpamAssassin과 같은 시스템 패키지를 실행하는 간단한 방법을 제공하지 않는 경우가 많습니다.

이제 Leapcell을 사용하면 SpamAssassin과 같은 시스템 패키지를 배포하는 동시에 서비스를 서버리스로 유지할 수 있습니다. 일반적으로 더 저렴한 호출에 대해서만 비용을 지불하면 됩니다.

Leapcell에 API를 배포하는 것은 매우 쉽습니다. Linux 환경을 설정하는 방법이나 Dockerfile을 빌드하는 방법에 대해 걱정할 필요가 없습니다. 배포할 Python 이미지를 선택하고 "빌드 명령" 필드를 적절하게 입력하면 됩니다.

배포되면 온디맨드 방식으로 호출할 수 있는 엔드포인트가 제공됩니다. API가 호출될 때마다 SpamAssassin을 실행하고 이메일에 점수를 매긴 후 응답을 반환합니다.

위 내용은 마케팅 이메일을 스팸으로부터 보호하는 API 구축의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!