# QlikView에서 OAuth 2.0을 사용하여 이메일 보내기

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에 애플리케이션을 등록하십시오:

1. Azure Portal에 로그인하고 Microsoft Entra ID > 앱 등록 > 새 등록으로 이동합니다.
2. 애플리케이션을 등록합니다.
3. 인증서 및 암호에서 클라이언트 암호를 생성하고 해당 값을 복사합니다.값은 한 번만 표시됩니다.
4. API 사용 권한에서 Microsoft Graph Mail.Send 애플리케이션 권한을 추가합니다.
5. 권한에 대해 관리자 동의를 부여합니다.
6. 애플리케이션(클라이언트) 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 인라인 제한을 초과합니다. | 파일 크기를 줄이거나 다른 전송 방법을 사용하십시오. |