어느 날 워드프레스 관리자 화면에 접속하려고 하니 ‘관리자 이메일 확인’이라는 메시지가 떠서 설정 화면에서 이메일 주소를 변경했지만, 확인 메일이 오지 않더군요. 이 글에서는 AWS Lightsail에서 워드프레스 관리자 이메일 주소 변경 시 메일이 오지 않는 문제 해결 방법에 대해 최대한 상세하게 알아보도록 하겠습니다.
AWS Lightsail에서 워드프레스 관리자 이메일 주소 변경 시 메일이 오지 않는 문제 해결 방법
어느 날 워드프레스 관리자 화면에 접속하려 하니 아래와 같이 관리자 이메일 주소를 검증하라는 메시지가 나와, 설정에서 관리자 이메일 주소를 변경하였지만, 확인 메일이 오지 않아 변경할 수가 없었습니다. 확인 메일이 오지 않는 이유를 알아보니 AWS Lightsail은 메일링 서비스가 비활성화되어 있고, 이를 사용하기 위해서는 별도의 비용을 지불해야 한다고 합니다.
대량으로 이메일을 발송하는 것도 아닌데 별도의 비용을 지불하는 것은 불합리한 것 같아 조금 복잡하더라도 무료로 사용할 수 있는 Gmail API 서비스와 WP Mail SMTP 플러그인을 이용하여 해결하기로 하였습니다.
이 글에서 AWS Lightsail에서 워드프레스 관리자 이메일 주소 변경 시 메일이 오지 않는 문제를 해결하는 전체 과정을 자세히 설명하도록 하겠습니다.
1. 워드프레스 관리자 이메일 주소 변경 시 필요한 것들
워드프레스 관리자 화면에서 ‘설정’으로 들어가 보면, 아래와 같이 ‘관리자 이메일 주소’가 ‘user@example.com’으로 되어 있는 것을 볼 수 있는데요. AWS Lightsail 서비스를 이용하고 있을 경우, PHP mail() 기능을 제공하지 않아 관리자 이메일을 변경하더라도 메일이 오지 않기 때문에 별도로 설정을 해 주어야 합니다.
AWS Lightsail의 유료 메일링 서비스를 사용하지 않고 무료로 메일을 발송하기 위해, 이 글에서는 WP Mail SMTP 플러그인과 구글의 Gmail API를 활용합니다. WP Mail SMTP를 설정하려면 Gmail API 키가 필요하므로, 먼저 Gmail API 사용자 인증 정보 설정부터 진행하겠습니다.
2. Gmail API 와 WP Mail SMTP 설정
① Gmail API 설정하기
Gmail API를 설정하기 위해 아래 링크를 클릭하여 Google Cloud Console로 이동합니다.
저는 이미 GCC에 몇 개의 프로젝트를 생성하여 사용하고 있기 때문에 서비스에 대한 동의 내용이 나오지 않습니다. 그러나 구글에 로그인한 상태에서 GCC에 처음 접속하면 국가 선택과 서비스 이용 약관 동의 화면이 나타나며, 모든 약관에 동의해야 서비스를 사용할 수 있습니다.
서비스 이용에 대한 동의가 완료되면 GCC 페이지로 이동합니다. 여기서 ①번 부분을 클릭하여 ‘프로젝트 선택’ 화면을 연 후, ②번 위치에 있는 ‘새 프로젝트’를 클릭합니다.
다음 화면에서 ‘프로젝트 이름’에 원하는 이름을 입력한 후 ‘만들기’ 버튼을 클릭합니다.
새 프로젝트 생성이 완료되면 아래와 같이 ‘알림’ 창이 나옵니다. 여기서 ‘프로젝트 선택’을 클릭하거나, 상단에 있는 빨간색 테두리 부분을 클릭하여 ‘프로젝트 선택’ 창을 열고 방금 생성한 프로젝트를 선택해도 됩니다.
저는 ‘zisikbug-mailer’로 새 프로젝트를 생성했으므로 해당 프로젝트를 선택한 후, 아래 화면에서 ‘API 및 서비스’를 클릭합니다.
다음 화면에서 ‘라이브러리’를 클릭합니다.
라이브러리 화면에서 아래로 조금 스크롤하여 ‘Gmail API’를 찾아 클릭합니다.
Gmail API에서 ‘사용’을 클릭합니다.
다음 화면에서 ‘사용자 인증 정보 만들기’를 클릭합니다.
다음 화면에서 ‘사용자 데이터’를 선택한 후 ‘다음’ 버튼을 클릭합니다. ‘사용자 인증 정보 만들기’는 총 5단계로 조금 길지만 천천히 따라 하시면 어렵지 않게 완료할 수 있습니다.
다음 화면에서 ‘앱 이름’, ‘사용자 지원 이메일’을 입력하고 개발자 연락처 정보도 동일한 이메일 주소를 입력한 후, ‘저장 후 계속’ 버튼을 클릭합니다.
다음 화면에서는 특별히 선택하거나 입력해야 하는 것이 없기 때문에 그대로 두고 ‘저장 후 계속’ 버튼을 클릭합니다.
다음 화면에서 ‘애플리케이션 유형’을 ‘웹 애플리케이션’으로 선택하고, ‘승인된 리디렉션 URI’에서 ‘+URI 추가’를 클릭한 후, ‘URI 1’에 ‘https://connect.wpmailsmtp.com/google/‘을 입력하고 ‘만들기’ 버튼을 클릭합니다.
이제 클라이언트 ID 인증키가 아래와 같이 생성되었습니다. 클라이언트 ID는 가능하면 ‘다운로드’를 클릭하여 별도로 저장해 두시는 것이 좋습니다. ‘완료’ 버튼을 클릭합니다.
위에서 ‘완료’ 버튼을 클릭하면 Gmail AP가 생성되며, 아래와 같이 메인 화면으로 이동합니다. 여기서 ‘OAuth 동의 화면’ 버튼을 클릭합니다.
Gmail API 생성이 완료되면 초기 설정이 ‘Testing’으로 되어 있습니다. 아래 화면에서 ‘PUBLISH APP’ 버튼을 클릭하여 ‘Testing’을 ‘In production’으로 변경해야 합니다.
‘PUBLISH APP’ 버튼을 클릭하면 ‘Push to production?’이라는 창이 나타납니다. 여기서 ‘확인’ 버튼을 클릭하면, 아래 화면처럼 게시 상태가 ‘In production’으로 변경됩니다.
다음으로 Gmail API의 클라이언트 ID와 Key를 확인하도록 하겠습니다. 아래 화면에서 ‘사용자 인증 정보’를 클릭한 후 ②’OAuth 클라이언트 다운로드’를 클릭합니다.
위에서 ②OAuth 클라이언트 다운로드(아래 방향 화살표)를 클릭하면 아래 화면과 같이 ‘클라이언트 ID’와 ‘클라이언트 보안 비밀번호’를 확인하고 다운로드할 수 있습니다. ‘클라이언트 ID’와 ‘클라이언트 보안 비밀번호’는 WP Mail SMTP 플러그인 설정 시 사용해야 하므로, 노트패드에 복사해 둡니다.
지금까지 Gmail API 사용을 위한 설정을 완료하였습니다. 다음으로 WP Mail SMTP 설정을 하도록 하겠습니다.
② WP Mail SMTP 설정하기
먼저 워드프레스 관리자 화면에서 ‘플러그인’ → ‘새 플러그인 추가’를 클릭합니다. ‘키워드’에 ‘wp mail smtp’를 입력하여 검색한 후 검색 결과에서 해당 플러그인을 찾아 ‘지금 설치’ → ‘활성화’ 합니다.
WP Mail SMTP 플러그인을 설치하고 활성화한 후, ‘설정’으로 이동하여 ‘설정 마법사 실행’ 버튼을 클릭합니다.
다음 화면에서 ‘Let’s Get Started’ 버튼을 클릭합니다.
다음 화면에서 여러 가지 SMTP Mailer 옵션이 나타납니다. 우리는 구글 메일 서비스를 사용할 것이므로 ‘구글/Gmail’을 선택한 후, 화면을 아래로 스크롤하여 ‘Save and Continue’ 버튼을 클릭합니다.
다음 화면에서 ‘I Understand, Continue’ 버튼을 클릭합니다.
다음 화면에서 ‘Client ID’와 ‘Client Secret’에 위에서 노트패드에 복사해 두었던 ‘클라이언트 ID’와 ‘클라이언트 보안 비밀번호’를 붙여넣기 합니다. 화면을 조금 아래로 스크롤하여 ‘Connect to Google’ 버튼을 클릭합니다.
아래 화면에서 여러분의 구글 계정을 선택합니다.
다음 화면에서 ‘고급’을 클릭한 후, ‘wpmailsmtp.com으로 이동(안전하지 않음)’을 선택하여 WP Mail SMTP 플러그인이 Google Mail API에 액세스할 수 있도록 합니다.
다음 화면에서 ‘계속’ 버튼을 클릭하면 권한 부여가 완료됩니다.
아래 화면과 같이 권한 부여가 완료되었습니다.
화면을 조금 아래로 스크롤한 후, ‘From Name’에 메일 발신자 이름을, ‘From Email’에 발신자 이메일 주소를 입력하고 ‘Save and Continue’ 버튼을 클릭합니다.
다음 화면에서 첫 번째와 두 번째 항목을 제외한 나머지 항목은 체크를 해제한 후 ‘Save and Continue’를 클릭합니다.
다음 화면에서 모든 설정을 그대로 두고 ‘Save and Continue’ 버튼을 클릭합니다.
다음 화면에서 ‘Send a Test Email’ 버튼을 클릭하여 메일이 정상적으로 발송되는지 확인만 하면 모든 설정이 완료됩니다.
다음 화면에서 받을 사람의 이메일 주소를 입력한 후 ‘이메일 전송’ 버튼을 클릭하여 메일을 발송합니다.
아래와 같이 정상적으로 메일이 수신되었습니다. 이제 관리자 이메일 주소를 변경할 수 있게 되었습니다.
관리자 이메일 주소를 변경한 후 수신된 메일에서 승인 링크를 클릭하면, 아래와 같이 관리자 이메일 주소가 변경된 것을 확인할 수 있습니다.
관리자 이메일 주소 변경을 위해 긴 과정을 거쳤지만, 변경하고 나니 왠지 뿌듯한 느낌이 드네요.
오늘은 AWS Lightsail에서 워드프레스 관리자 이메일 주소 변경 시 메일이 오지 않는 문제 해결 방법에 대해 자세히 알아보았습니다. 관리자 이메일 변경에 이렇게 많은 시간이 걸릴 줄은 몰랐지만, 워드프레스에서 메일 발송 설정을 해두면 워드프레스나 설치된 플러그인에서 이벤트 발생 시 관리자에게 자동으로 알림 메일이 발송되기 때문에 꼭 필요한 작업이었습니다. 저와 같은 문제를 겪고 계신 분들이 있다면 이 글을 참고하여 문제를 해결해 보시기 바랍니다.