QlikView에서 OAuth 2.0을 사용하여 이메일 보내기
마지막 업데이트: 2026. 10. 7.QlikView는 Microsoft 365와 함께 OAuth 2.0을 사용하여 Microsoft Graph를 통해 이메일을 보낼 수 있습니다.OAuth 2.0은 추가 메일 연결 방식입니다; 기존 SMTP 구성은 계속 사용할 수 있습니다.
OAuth 2.0을 선택하면 QlikView는 SMTP 서버에 직접 연결되지 않습니다.login.microsoftonline.com에서 액세스 토큰을 가져와 graph.microsoft.com/v1.0/users/{sender}/sendMail의 Microsoft Graph REST API를 통해 이메일을 보냅니다.
전제 조건
QlikView를 구성하기 전에 Microsoft Entra ID에 애플리케이션을 등록하십시오:
- Azure Portal에 로그인하고 Microsoft Entra ID > 앱 등록 > 새 등록으로 이동합니다.
- 애플리케이션을 등록합니다.
- 인증서 및 암호에서 클라이언트 암호를 생성하고 해당 값을 복사합니다.값은 한 번만 표시됩니다.
- API 사용 권한에서 Microsoft Graph Mail.Send 애플리케이션 권한을 추가합니다.
- 권한에 대해 관리자 동의를 부여합니다.
- 애플리케이션(클라이언트) ID 및 디렉터리(테넌트) ID를 기록합니다.
애플리케이션에는 발신자로 사용되는 사서함에 대한 Mail.Send 권한이 있어야 합니다.
보안
QlikView는 테넌트 ID, 클라이언트 ID, 클라이언트 비밀을 저장하기 전에 암호화합니다.자격 증명은 일반 텍스트로 저장되지 않습니다.
OAuth 2.0 메일 테스트
구성 페이지에서 테스트 메일 컨트롤을 사용하십시오:
- QlikView Desktop에서 사용자 기본 설정 > 메일 페이지의 테스트를 클릭합니다.
- QlikView 관리 콘솔에서 Send Test E-mail To에 주소를 입력하고 Send를 클릭합니다.
QlikView는 OAuth 2.0 토큰을 가져와 Microsoft Graph를 통해 테스트 이메일을 보냅니다.단계가 실패하면 오류 메시지를 확인하세요.
첨부 파일
QlikView에서 첨부 파일이 포함된 이메일을 보낼 때, 첨부 파일을 Base64로 인코딩된 콘텐츠로 Microsoft Graph 요청에 인라인으로 포함합니다.각 첨부 파일은 3 MB로 제한됩니다.대용량 파일의 경우 다른 전달 방법을 사용하십시오.
문제 해결
| 오류 | 원인 | 해상도 |
|---|---|---|
OAuth 2.0 Client ID, Tenant ID, and Client Secret are required.
|
하나 이상의 OAuth 필드가 비어 있습니다. | 메일 설정 페이지에서 세 필드가 모두 입력되어 있는지 확인하십시오. |
OAuth token request failed: AADSTS7000215
|
클라이언트 암호가 유효하지 않습니다. | Microsoft Entra ID에서 새 클라이언트 암호를 생성하고 QlikView를 업데이트합니다. |
OAuth token request failed: AADSTS700016
|
애플리케이션(클라이언트) ID가 올바르지 않거나 지정된 테넌트에 애플리케이션이 존재하지 않습니다. | 애플리케이션(클라이언트) ID 및 디렉터리(테넌트) ID를 확인합니다. |
Graph sendMail failed: ErrorAccessDenied
|
애플리케이션에 Mail.Send 권한이 없거나 관리자 동의가 부여되지 않았습니다. |
Mail.Send 애플리케이션 권한을 추가하고 Microsoft Entra ID에서 관리자 동의를 부여합니다. |
Graph sendMail failed: ErrorItemNotFound
|
보낸 사람 주소가 테넌트의 유효한 사서함에 해당하지 않습니다. | 보낸 사람 주소가 기존 Microsoft 365 사서함과 일치하는지 확인하세요. |
Attachment too large
|
첨부 파일이 3 MB 인라인 제한을 초과합니다. | 파일 크기를 줄이거나 다른 전송 방법을 사용하십시오. |