--- title: "인증 문제" slug: "cloudoutboundmailer-troubleshoot-auth" updated: 2026-07-23T09:02:24Z published: 2026-07-23T09:02:24Z canonical: "guide-fin.ncloud-docs.com/cloudoutboundmailer-troubleshoot-auth" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 인증 문제 Cloud Outbound Mailer를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오. ## DKIM 인증 문제 해결 가이드 이 가이드는 Cloud Outbound Mailer의 DKIM 인증 관련 문제를 진단하고 해결하는 방법을 안내합니다. --- ## 목차 1. [DKIM 인증 실패 체크리스트](/docs/cloudoutboundmailer-troubleshoot-auth#%EC%B2%B4%ED%81%AC%EB%A6%AC%EC%8A%A4%ED%8A%B8) 2. [증상별 문제 해결](/docs/cloudoutboundmailer-troubleshoot-auth#%EC%A6%9D%EC%83%81%EB%B3%84%EB%AC%B8%EC%A0%9C%ED%95%B4%EA%B2%B0) - [DKIM 인증이 실패하는 경우](/docs/cloudoutboundmailer-troubleshoot-auth#DKIM%EC%9D%B8%EC%A6%9D%EC%8B%A4%ED%8C%A8) - [DKIM 서명값은 조회되나 인증이 실패하는 경우](/docs/cloudoutboundmailer-troubleshoot-auth#%EC%84%9C%EB%AA%85%EA%B0%92%EC%A1%B0%ED%9A%8C%EB%90%98%EB%82%98%EC%8B%A4%ED%8C%A8) - [메일 발송 시 성공/실패가 반복되는 경우](/docs/cloudoutboundmailer-troubleshoot-auth#%EC%84%B1%EA%B3%B5%EC%8B%A4%ED%8C%A8%EB%B0%98%EB%B3%B5) 3. [상세 확인 방법](/docs/cloudoutboundmailer-troubleshoot-auth#%EC%83%81%EC%84%B8%ED%99%95%EC%9D%B8%EB%B0%A9%EB%B2%95) --- ## DKIM 인증 실패 체크리스트 DKIM 인증 문제 발생 시 다음 항목들을 순서대로 확인하세요. - **1단계: 선행 조건 확인** - 도메인 인증이 완료되었는가? - SPF 레코드가 정상 조회되는가? - **2단계: DKIM 레코드 등록 확인** - TXT 레코드가 올바른 호스트에 등록되었는가? (`{selector}._domainkey.{domain}`) - DKIM 서명값이 멀티라인 형태로 분할 등록되었는가? - **3단계: Selector 확인** - 환경과 리전에 맞는 Selector를 사용하고 있는가? - **4단계: 레코드 조회 확인** - nslookup으로 레코드가 정상 조회되는가? - 조회 결과가 멀티라인 형태인가? (별개 레코드가 아닌지) - **5단계: 콘솔 설정 확인** - DKIM 인증이 완료되었는가? - [사용] 버튼을 클릭하여 활성화했는가? --- ## 증상별 문제 해결 ### DKIM 인증이 실패하는 경우 **증상** - DKIM 인증이 되지 않습니다. - DKIM 인증 실패로 메일 발송이 실패합니다. **원인** - Selector가 잘못 설정되었습니다. - DKIM 서명 값이 올바르게 등록되지 않았습니다. - 도메인 또는 SPF 인증 레코드가 누락되었습니다. **해결 방법** 다음 사항들을 순서대로 확인해 주십시오. **1. 도메인 및 SPF 인증 확인** DKIM 인증의 선행 조건으로 도메인 및 SPF 인증을 위한 레코드가 등록되어 있어야 합니다. [도메인 확인](/docs/cloudoutboundmailer-domain#%EB%8F%84%EB%A9%94%EC%9D%B8-%ED%99%95%EC%9D%B8)을 참조하여, 도메인 인증 토큰 값 및 SPF 레코드가 조회되는지 먼저 확인해 주십시오. **2. TXT 레코드 등록 확인** 등록한 도메인의 `{selector}._domainkey` 호스트에 DKIM 서명 값을 TXT 레코드로 등록해야 합니다. 예: 도메인이 `example.com`이고 Selector가 `ncpcomfin`인 경우 - 호스트: `ncpcomfin._domainkey.example.com` 주의 - DKIM 서명 값은 392자입니다. - DNS TXT 레코드에는 255자까지 입력 가능하므로, 큰따옴표로 묶어 여러 구문으로 분할 등록해야 합니다. - Global DNS의 경우, TXT 레코드가 255자를 초과하면 자동으로 줄바꿈이 적용되므로 서명값을 그대로 등록할 수 있습니다. 자세한 내용은 Global DNS를 참조해 주십시오. - 이용 중인 DNS 서비스 업체에서 255자 이상의 TXT 레코드 등록 기능을 지원하지 않는다면 해당 업체에 지원을 요청해 주십시오. - Cloud Outbound Mailer 서비스는 높은 수준의 보안을 유지하기 위해 2,048bit의 DKIM 서명만을 지원하고 있습니다. DKIM 키는 2,048bit를 사용해 주십시오. **3. Selector 확인** 환경 및 리전에 따라 Selector가 달라집니다. Selector를 확인하는 방법은 [DKIM 인증](/docs/cloudoutboundmailer-domain#dkim-%EC%9D%B8%EC%A6%9D)을 참조해 주십시오. | 환경 | 리전 | Selector | | --- | --- | --- | | 민간 | 한국(KR) | `ncpcompubkr` | | 민간 | 일본(JP) | `ncpcompubjpn` | | 민간 | 싱가포르(SG) | `ncpcompubsgn` | | 금융 | 한국(KR) | `ncpcomfin` | | 공공 | 한국(KR) | `ncpcomgov` | **4. 레코드 조회 확인** 다음 명령어를 입력하여 DKIM 서명 값이 올바르게 등록되었는지 확인해 주십시오. ``` # nslookup 사용 $ nslookup -q=txt ncpcomfin._domainkey.example.com # 또는 dig 사용 $ dig txt ncpcomfin._domainkey.example.com ``` **올바른 등록 (멀티라인 형태)** ``` ncpcomfin._domainkey.example.com text = "v=DKIM1;k=rsa;p=MIIB..." "..." ``` 결과가 두 개의 문자열 블록으로 이루어진 **단일 레코드**의 멀티라인 형태로 조회되어야 합니다. **잘못된 등록 (별개 레코드)** ``` ncpcomfin._domainkey.example.com text = "v=DKIM1;k=rsa;p=MIIB..." ncpcomfin._domainkey.example.com text = "..." ``` 위와 같이 **별개의 레코드**로 분리되어 등록된 경우, DKIM 인증에 실패하거나 성공/실패가 반복될 수 있습니다. 멀티라인 형태로 재등록해야 합니다. TXT 레코드 분할 등록 방법은 사용 중인 도메인 서비스 업체에 문의해 주십시오. **5. DKIM 인증 설정 확인** 콘솔에서 DKIM 인증 여부 및 사용 여부를 확인해 주십시오. 인증을 완료한 후 **[사용] 버튼을 클릭**하여 사용 설정까지 완료해야 메일 발송 시 DKIM 인증이 정상적으로 이뤄집니다. 자세한 내용은 [DKIM 인증](/docs/cloudoutboundmailer-domain#dkim-%EC%9D%B8%EC%A6%9D)을 참조해 주십시오. 주의 - 인증 완료 후 [사용] 버튼을 클릭하여 활성화하였다면, [사용 중지] 버튼으로 변경되고, "사용 중" 문구가 표기됩니다. - 인증이 완료된 레코드를 수정하거나 삭제하면 이후 메일 발송 시 인증에 실패할 수 있습니다. 따라서 인증을 위해 등록한 레코드는 변경 없이 그대로 유지해 주십시오. --- ### DKIM 서명값은 조회되나 인증이 실패하는 경우 **증상** - DKIM 서명값이 정상적으로 조회됩니다. - 그러나 DKIM 인증 시도 시 실패합니다. **원인** - 도메인 또는 SPF 인증을 위한 레코드가 잘못 등록되어 있거나 누락되었습니다. - DNS 레코드 변경 사항이 전파되는 중일 수 있습니다. **해결 방법** DKIM 인증을 정상적으로 수행하려면 도메인 및 SPF 인증을 위한 레코드가 모두 등록되어 있어야 합니다. [도메인 확인](/docs/cloudoutboundmailer-domain#%EB%8F%84%EB%A9%94%EC%9D%B8-%ED%99%95%EC%9D%B8)을 참조하여, 도메인 인증 토큰 값 및 SPF 레코드가 조회되는지 확인해 주십시오. **DNS 레코드 전파 대기** 레코드를 올바르게 등록하였으나 인증에 실패하는 경우, DNS 레코드 변경 사항이 전파되기까지 시간이 소요될 수 있습니다. 일정 시간(보통 수 분에서 최대 24시간)이 경과한 후 다시 인증을 시도해 주십시오. 주의 - **DNS 서버별 전파 시간 차이**: 조회하는 DNS 서버에 따라 전파되는 시간이 다를 수 있습니다. 사용자가 직접 조회 시 올바른 레코드가 반환되더라도, 내부 인증 서버에는 아직 전파되지 않아 인증이 실패할 수 있습니다. - **TTL(Time To Live) 캐시**: 이전 레코드 등록 시 TTL을 길게 설정한 경우, 기존 레코드가 캐시되어 조회될 수 있습니다. 이 경우 TTL이 경과된 이후에 새 레코드가 정상 조회됩니다. - **레코드 갱신**: 내부적으로 별도의 레코드 강제 갱신 작업은 지원하지 않습니다. 레코드 등록 시 적절한 TTL 값(예: 300초~3600초) 설정을 권장합니다. --- ### 메일 발송 시 성공/실패가 반복되는 경우 **증상** - DKIM 인증을 완료했습니다. - 메일 발송 시 발송 결과에 성공/실패가 반복됩니다. **원인** - DKIM 서명값이 별개의 레코드로 등록되어 있으면 성공과 실패를 반복할 수 있습니다. - DNS 레코드 조회 결과는 순서가 보장되지 않기 때문에 반환되는 순서에 따라 DKIM 인증 결과가 성공/실패로 달라질 수 있습니다. **해결 방법** [도메인 확인](/docs/cloudoutboundmailer-domain#%EB%8F%84%EB%A9%94%EC%9D%B8-%ED%99%95%EC%9D%B8)을 참조하여 DKIM 서명값이 정상적으로 등록되었는지 확인해 주십시오. **레코드 조회 및 확인** ``` $ nslookup -q=txt ncpcomfin._domainkey.example.com ``` **올바른 형태 (단일 레코드의 멀티라인)** ``` ncpcomfin._domainkey.example.com text = "v=DKIM1;k=rsa;p=MIIB..." "..." ``` **잘못된 형태 (별개의 레코드로 분리)** ``` ncpcomfin._domainkey.example.com text = "v=DKIM1;k=rsa;p=MIIB..." ncpcomfin._domainkey.example.com text = "..." ``` 별개의 레코드로 등록된 경우, DNS 조회 시 순서가 보장되지 않아 성공/실패가 반복됩니다. 반드시 단일 레코드의 멀티라인 형태로 재등록해야 합니다. TXT 레코드 분할 등록 방법은 사용 중인 도메인 서비스 업체에 문의해 주십시오. --- ## 상세 확인 방법 ### DNS 레코드 조회 방법 ``` # TXT 레코드 조회 $ nslookup -q=txt ncpcomfin._domainkey.example.com $ nslookup -q=txt example.com ``` ### 콘솔에서 확인 1. Cloud Outbound Mailer 콘솔 접속 2. **도메인 관리** 메뉴 선택 3. 해당 도메인의 **DKIM 인증 상태** 확인 4. 인증 완료 후 **[사용]** 버튼 활성화 여부 확인 주의 인증 완료 후 [사용] 버튼을 클릭하여 활성화하였다면, [사용 중지] 버튼으로 변경되고, "사용 중" 문구가 표기됩니다. ## SPF 인증 실패 SPF 인증이 정상적으로 이루어지지 않습니다. #### 원인 도메인의 TXT 레코드에 SPF 정보가 올바르게 등록되지 않았거나 형식에 문제가 있습니다. #### 해결 방법 등록한 도메인의 TXT 레코드를 점검하는 방법은 다음과 같습니다. 1. 도메인에 등록한 SPF 레코드를 조회하기 위해 다음 명령어를 입력해 주십시오. ``` nslookup -q=txt example.com ``` 2. 다음과 같이 하나의 문자열 블록으로 SPF 레코드가 조회되는지 확인해 주십시오. ``` example.com text = "v=spf1 include:email.fin-ncloud.com ~all" ``` - 조회 결과에 큰따옴표로 감싸진 한 줄의 문자열로 SPF가 등록되어 있어야 합니다. 참고 이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.