Edge Function
서버 측 코드 실행
Edge Function은 Deno 런타임에서 실행되는 JavaScript/TypeScript 함수로, 브라우저에서 실행해서는 안 되거나 실행할 수 없는 로직을 구현할 수 있게 해 줍니다. 서버 측 처리, 외부 API 통합, 강화된 보안이 필요한 기능을 설명하면 AI가 이런 함수를 만들어 줍니다.
Edge Function으로 할 수 있는 일:
- 검증과 외부 API 호출을 포함한 양식 처리
- 이메일 발송, 결제 처리, AI API 호출 같은 서비스 통합
- 브라우저 코드에 노출되면 안 되는 민감한 로직 보호
- 사용자에게 노출하지 않고 안전하게 시크릿에 접근
- 브라우저에서 하기에는 너무 느리거나 리소스를 많이 쓰는 복잡한 작업 수행
함수의 작동 방식
AI가 Edge Function을 만들 때는 다음을 수행합니다.
- 설명한 작업을 수행하는 JavaScript 코드를 작성합니다.
- 누가 함수를 호출할 수 있는지 정하는 액세스 제어를 설정합니다.
- 함수에 외부 API 자격 증명이 필요하면 시크릿 접근을 구성합니다.
- 함수를 테스트해 올바르게 동작하는지 확인합니다.
- 애플리케이션이 함수를 실행하기 위해 호출할 수 있는 URL을 제공합니다.
함수는 격리된 보안 환경에서 실행됩니다. 각 실행은 소요 시간, 오류, 실행을 일으킨 사용자와 함께 기록됩니다. 설정 > 사이트 구성 > 모니터링 > 로그에서 이 로그를 확인해 함수의 성능을 모니터링하고 문제를 디버깅할 수 있습니다.
함수의 액세스 제어
데이터베이스 테이블과 마찬가지로 Edge Function에도 실행할 수 있는 사람을 제어하는 보안 정책이 있습니다. AI는 사용자가 만들고 있는 기능에 맞춰 이를 설정합니다.
공개 함수
로그인하지 않아도 누구나 호출할 수 있습니다. 웹훅 핸들러(예: Stripe 결제 알림), 공개 API, 상태 확인 엔드포인트에 사용합니다.
인증된 함수
로그인한 사용자만 호출할 수 있습니다. 대부분의 함수가 이 정책을 사용하며, 사용자 대상 기능, 양식 제출, 애플리케이션용 데이터 조회에 알맞습니다.
그룹 기반 액세스
특정 그룹(예: "admin")에 속한 사용자만 함수를 호출할 수 있습니다. 관리 작업, 운영(모더레이션) 도구, 팀 전용 기능에 알맞습니다.
메타데이터 기반 액세스
사용자 지정 사용자 속성을 기준으로 액세스를 허용합니다. 예를 들어 department = "engineering"인 사용자만 특정 함수를 호출할 수 있습니다. 유연한 맞춤 권한 체계를 만들 수 있습니다.
함수로 할 수 있는 일
데이터베이스 액세스
함수는 동일한 보안 규칙이 적용된 상태에서 데이터베이스를 쿼리하고 수정할 수 있습니다.
외부 API 호출
함수는 저장된 시크릿을 사용해 외부 서비스와 통신할 수 있습니다.
복잡한 로직
함수는 계산, 데이터 변환, 검증, 여러 단계로 이루어진 워크플로를 수행할 수 있습니다.
이메일 및 알림
사용자 작업에 대한 응답으로 트랜잭션 이메일, SMS, 푸시 알림을 보냅니다.
결제 처리
Stripe 같은 서비스로 결제 흐름, 웹훅 처리, 구독 관리를 처리합니다.
AI 통합
OpenAI나 Anthropic 같은 AI API를 호출해 콘텐츠를 생성하고, 데이터를 분석하고, 지능형 기능을 제공합니다.
모니터링 및 로그
모든 함수 실행은 다음 정보와 함께 자동으로 기록됩니다.
- 언제, 누가 호출했는지
- 실행에 걸린 시간
- 성공했는지, 오류가 발생했는지
- 콘솔 출력 또는 오류 메시지
- 반환한 응답
모범 사례
✅ 명확하게 설명 - AI에게 함수 생성을 요청할 때 함수가 무엇을 해야 하는지, 누가 호출할 수 있어야 하는지 구체적으로 설명하세요.
✅ 로그 모니터링 - 함수 실행 로그를 확인해 성능을 파악하고 오류를 조기에 발견하세요.
✅ 시크릿은 시크릿 관리에 보관 - AI는 시크릿을 함수에 하드코딩하지 않고 저장된 시크릿을 사용합니다.
❌ 민감한 작업을 노출하지 마세요 - 적절한 액세스 제어는 AI가 구성하게 하세요. 관리용 함수는 절대 공개해서는 안 됩니다.
관련 문서: