Cloudflare Workers를 사용한 Gmail 전송 구현에 관한 시리즈의 1부입니다.
- 1부: 설정(현재)
- 2부: 개발 환경(출시 예정)
- 3부: 구현(출시 예정)
소개
Cloudflare Pages에 호스팅된 정적 웹사이트에 문의 양식을 구현할 때 이메일 전송 기능에는 서버리스 솔루션이 필요합니다. 이 가이드는 양식 제출을 처리하기 위해 Cloudflare Workers로 Gmail API를 설정하는 방법을 보여줍니다.
Cloudflare 작업자 제약
Cloudflare 작업자와 작업할 때 고려해야 할 두 가지 주요 제한 사항이 있습니다.
-
Google API 패키지를 사용할 수 없음:
- Cloudflare Workers는 Node.js 환경이 아닙니다
- Node.js 클라이언트 라이브러리 대신 Google API REST 엔드포인트에 대한 직접 HTTP 요청을 사용해야 합니다
-
노드메일러 패키지를 사용할 수 없음:
- Nodemailer는 Node.js 환경에 따라 다릅니다
- Cloudflare Workers에서는 사용할 수 없습니다
설정 프로세스
1. 서비스 계정 생성
- Google 클라우드 콘솔에 액세스
- 새 프로젝트 만들기 또는 기존 프로젝트 선택
- 'IAM 및 관리자'로 이동합니다. > "서비스 계정"
- "서비스 계정 만들기"를 클릭하세요
- 서비스 계정 이름 및 설명 입력
- 옵션 설정을 건너뛰고 "완료"를 클릭하세요
- 나중에 사용할 수 있도록 OAuth2 클라이언트 ID를 기록해 두세요
2. 필수 역할 할당
- 'IAM 및 관리자'로 이동합니다. > "IAM"
- 해당 교장 선택
- "액세스 권한 부여"를 클릭하세요
- 서비스 계정을 새 주체로 추가
- 다음 역할을 할당합니다.
- 서비스 계정 관리자
- 서비스 계정 주요 관리자
- 서비스 계정 토큰 생성자
- IAP 정책 관리자
- 변경 사항 저장
3. Gmail API 활성화
- 'API 및 서비스'로 이동 > "도서관"
- "gmail"을 검색하세요
- "Gmail API"를 선택하세요
- '활성화'를 클릭하세요
4. 조직 정책 관리자 역할 추가
- 'IAM 및 관리자'로 이동합니다. > "IAM"
- 조직 관리자 편집
- "조직 정책 관리자" 역할 추가
- 변경사항 저장
5. 서비스 계정 키 생성 정책 비활성화
- 'IAM 및 관리자'로 이동합니다. > "조직 정책"
- "iam.disableServiceAccountKeyCreation" 필터
- 정책 링크를 클릭하세요
- '정책 관리' 클릭
- "부모 정책 재정의" 선택
- 규칙을 추가하고 '시행'으로 설정
- '완료'를 클릭하세요
6. 서비스 계정 키 생성
- 'IAM 및 관리자'로 이동합니다. > "서비스 계정"
- 생성된 서비스 계정 선택
- '키' 탭으로 이동
- '키 추가' 클릭 > "새 키 생성"
- JSON 형식 선택
- 다운로드한 JSON 파일을 생성하고 안전하게 저장하세요
7. 도메인 전체 위임 구성
- Google Workspace 관리 콘솔에 액세스
- 보안으로 이동 > 액세스 및 데이터 제어 > API 제어
- "도메인 전체 위임 관리"를 클릭하세요
- 새 클라이언트 ID 추가:
- 서비스 계정의 클라이언트 ID를 입력하세요
- 범위 추가: https://www.googleapis.com/auth/gmail.send
- '승인'을 클릭하세요
참고: 대규모 조직에서는 보안 문제로 인해 도메인 전체 위임을 신중하게 고려해야 합니다.
추가 구성
Gmail 별칭으로 이메일을 보낼 때 별칭 주소를 추가하세요.
- Gmail 설정으로 이동 > 계정
- '다른 이메일 주소 추가'를 통해 별칭 이메일 주소를 추가하세요
무료 이메일 서비스에 대한 중요 참고 사항
이전에는 MailChannels Send API가 Cloudflare 작업자를 위한 무료 이메일 전송 솔루션으로 널리 권장되었습니다. 그러나 2024년 6월 30일부터 MailChannels와 Cloudflare 간의 통합이 중단되었습니다. 이는 이메일 전송 요구를 위해 이 서비스를 사용하는 많은 개발자에게 영향을 미쳤습니다.
많은 AI 언어 모델은 훈련 데이터가 서비스 중단 이전에 발생했기 때문에 여전히 MailChannel을 솔루션으로 제안하고 있습니다. 이러한 상황은 특히 타사 통합 작업 시 현재 서비스 가용성을 확인하는 것의 중요성을 강조합니다.
이 가이드에 설명된 Gmail API 구현은 이전 MailChannels 솔루션에 비해 더 많은 초기 설정이 필요하지만 안정적인 대안으로 사용됩니다.
다음 단계
이 시리즈의 다음 기사에서는 Cloudflare Workers와 함께 Gmail API를 사용하기 위한 개발 환경 설정 및 구현 세부 사항을 다룰 것입니다.
위 내용은 Cloudflare Workers를 통한 Gmail 전송 구현 - 설정 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!