SendGrid Email로 이메일 인증을 설정하세요

SendGrid 이메일 서비스에 대한 공식 Logto 커넥터입니다.

팁:

이 가이드는 Logto 커넥터에 대한 기본적인 이해를 전제로 합니다. 익숙하지 않은 분들은 커넥터 가이드를 참조하여 시작하세요.

시작하기

SendGrid (즉, Twilio SendGrid)는 트랜잭션 및 마케팅 이메일을 위한 고객 커뮤니케이션 플랫폼입니다. 우리는 인증 코드 를 보내기 위해 그 이메일 전송 기능을 사용할 수 있습니다.

SendGrid 계정 등록

SendGrid 웹사이트에서 새 계정을 만드세요. 이미 계정이 있는 경우 이 단계를 건너뛸 수 있습니다.

발신자 인증

SendGrid 콘솔 페이지로 이동하여 SendGrid 계정으로 로그인하세요.

발신자는 인증 코드 이메일이 발송될 주소를 나타냅니다. SendGrid 메일 서버를 통해 이메일을 보내려면 적어도 하나의 발신자를 인증해야 합니다.

SendGrid 콘솔 페이지에서 시작하여 사이드바에서 "Settings" -> "Sender Authentication"으로 이동하세요.

도메인 인증은 권장되지만 필수는 아닙니다. "Authenticate Your Domain" 카드에서 "Get started"를 클릭하고, 이후 안내에 따라 발신자를 SendGrid에 연결하고 인증하세요.

패널에서 "Verify a Single Sender" 버튼을 클릭하면 발신자를 생성하기 위해 필요한 몇 가지 중요한 정보를 요구하는 양식에 집중하게 됩니다. 안내에 따라 모든 필드를 작성하고 "Create" 버튼을 누르세요.

단일 발신자가 생성되면, 발신자의 이메일 주소로 인증 링크가 포함된 이메일이 발송됩니다. 메일함으로 가서 인증 메일을 찾아 이메일에 제공된 링크를 클릭하여 단일 발신자를 인증하세요. 이제 방금 인증한 발신자를 사용하여 SendGrid 커넥터를 통해 이메일을 보낼 수 있습니다.

API 키 생성

SendGrid 콘솔 페이지에서 시작하여 사이드바에서 "Settings" -> "API Keys"로 이동하세요.

API Keys 페이지의 오른쪽 상단 모서리에 있는 "Create API Key"를 클릭하세요. API 키의 이름을 입력하고 사용 사례에 맞게 "API Key Permission"을 사용자 정의하세요. 이 API 키로 이메일을 보내기 전에 글로벌 Full Access 또는 Mail Send에 대한 전체 접근 권한이 있는 Restricted Access가 필요합니다.

Create API Key 프로세스를 완료하면 화면에 API 키가 표시됩니다. 이 API 키는 안전한 곳에 저장해야 하며, 이는 API 키를 볼 수 있는 유일한 기회입니다.

커넥터 구성

"API 키 생성" 섹션에서 생성한 API 키로 apiKey 필드를 채우세요.

fromEmail 및 fromName 필드를 발신자의 From Address 및 Nickname으로 채우세요. 발신자의 세부 정보는 "Sender Management" 페이지에서 찾을 수 있습니다. fromName은 선택 사항이므로 채우지 않아도 됩니다.

다양한 경우에 대해 여러 SendGrid 메일 커넥터 템플릿을 추가할 수 있습니다. 단일 템플릿을 추가하는 예시는 다음과 같습니다:

• 이메일의 제목으로 작동하는 subject 필드를 채우세요.
• 임의의 문자열 형식의 내용으로 content 필드를 채우세요. 무작위 인증 코드를 위한 {{code}} 자리 표시자를 남기는 것을 잊지 마세요.
• 다양한 사용 사례에 대해 usageType 필드를 Register, SignIn, ForgotPassword, Generic 중 하나로 채우세요.
• 다양한 콘텐츠 유형에 대해 type 필드를 text/plain 또는 text/html 중 하나로 채우세요.

전체 사용자 흐름을 활성화하려면 Register, SignIn, ForgotPassword, Generic 사용 유형의 템플릿이 필요합니다.

다음은 SendGrid 커넥터 템플릿 JSON의 예입니다.

[
  {
    "subject": "<register-template-subject>",
    "content": "<Logto: Your verification code is {{code}}. (register template)>",
    "usageType": "Register",
    "type": "text/plain",
  },
  {
    "subject": "<sign-in-template-subject>",
    "content": "<Logto: Your verification code is {{code}}. (sign-in template)>",
    "usageType": "SignIn",
    "type": "text/plain",
  },
  {
    "subject": "<forgot-password-template-subject>",
    "content": "<Logto: Your verification code is {{code}}. (forgot-password template)>",
    "usageType": "ForgotPassword",
    "type": "text/plain",
  },
  {
    "subject": "<generic-template-subject>",
    "content": "<Logto: Your verification code is {{code}}. (generic template)>",
    "usageType": "Generic",
    "type": "text/plain",
  },
]

SendGrid 이메일 커넥터 테스트

이메일 주소를 입력하고 "Send"를 클릭하여 설정이 작동하는지 "Save and Done" 전에 확인할 수 있습니다.

이제 끝입니다. 로그인 경험에서 커넥터 활성화를 잊지 마세요.

구성 유형

이름	유형
apiKey	string
fromEmail	string
fromName	string (선택 사항)
templates	Template[]

템플릿 속성	유형	열거형 값
subject	string	N/A
content	string	N/A
usageType	enum string	'Register' | 'SignIn' | 'ForgotPassword' | 'Generic'
type	enum string	'text/plain' | 'text/html'