Azure OAuth를 통해 Odoo에 Microsoft Outlook 365 연결하기¶
Odoo는 Microsoft의 Microsoft 365용 Azure OAuth와 호환됩니다. 사용자 지정 도메인에서 보안 이메일을 송수신하려면 Azure 플랫폼과 Odoo 데이터베이스의 백엔드에서 몇 가지 설정만 구성하면 됩니다. 해당 설정 내용은 개인 이메일 주소 또는 사용자 지정 도메인에서 만든 주소 모두에서 작동합니다.
Microsoft Azure 포털에서 설정하기¶
새로운 애플리케이션 생성하기¶
시작하려면 Microsoft's Azure Portal <https://portal.azure.com/>`_로 이동하세요. :guilabel:`Microsoft Outlook Office 365
계정이 있는 경우에는 해당 계정으로 로그인하고, 그렇지 않은 경우 개인 Microsoft 계정`으로 로그인합니다. Azure 설정에 대한 관리 액세스 권한이 있는 사용자는 접속 후 다음과 같이 설정해야 합니다. 그런 다음 :guilabel:`Microsoft Entra ID 관리 (공식적으로는 Azure 액티브 디렉토리) 섹션으로 이동합니다.
이제 상단 메뉴에 있는 추가 (+)`를 클릭한 다음 :guilabel:`앱 등록`을 선택하세요. ‘애플리케이션 등록’ 화면에서 ‘이름’을 ‘Odoo’ 또는 확인할 수 있는 이름으로 변경합니다. :guilabel:`지원되는 계정 유형 섹션에서 :guilabel:`전체 조직 디렉토리 계정 (전체 Microsoft Entra ID 디렉토리 - 멀티 테넌트) 및 Microsoft 개인 계정 (e.g. Skype, Xbox)`을 선택합니다.
URL 리디렉션 섹션에서 플랫폼으로 웹 을 선택한 다음 URL 에 https:///<web base url>microsoft_outlook/confirm
을 입력합니다. web.base.url
은 데이터베이스에 로그인한 URL에 따라 변경될 수 있습니다.
참고
web.base.url 에 대한 문서에서는 고유한 URL을 고정하는 방법에 대해 설명하고 있습니다. Microsoft 앱에 다른 리디렉션 URL을 추가할 수도 있습니다.
생성하려면 항목에 URL을 추가한 후 애플리케이션을 등록 합니다.
API 권한¶
다음으로 API 권한`을 설정해야 합니다. Odoo에서 Microsoft 365 설정 하의 이메일을 읽고 (IMAP) 보낼 (SMTP) 수 있으려면 특정 API 권한이 필요합니다. 먼저 왼쪽 메뉴 표시줄에 있는 :guilabel:`API 권한 링크를 클릭합니다. 다음으로, :guilabel:` (+) 권한 추가` 버튼을 클릭하고 일반적으로 사용되는 Microsoft API 아래에서 Microsoft 그래프`를 선택합니다. 그 후, :guilabel:`위임된 권한 옵션을 선택합니다.
검색 창에서 다음과 같은 권한 위임 을 검색한 후 각각에 대해 권한 추가 를 클릭합니다.
SMTP.Send
IMAP.AccessAsUser.All
참고
기본적으로 사용자 읽기 권한이 추가됩니다.
사용자 및 그룹 배정하기¶
API 권한을 추가한 후 왼쪽 사이드바 메뉴 상단에 있는 애플리케이션`의 :guilabel:`전체보기 로 돌아갑니다.
이제 이 애플리케이션에 사용자를 추가합니다. 필수 정보 전체보기 표에서 로컬 디렉토리용 관리 애플리케이션 링크를 클릭하거나 표 오른쪽 하단에 있는 마지막 옵션을 클릭합니다.
왼쪽 사이드바 메뉴에서 사용자 및 그룹 을 선택합니다. 다음으로 (+) 사용자/그룹 추가 를 클릭합니다. 계정에 따라 그룹 및 사용자 모두 추가하거나 혹은 사용자 만 추가할 수 있습니다. 개인 계정에서는 사용자 만 추가할 수 있습니다.
사용자 또는 그룹 에서 선택되지 않음 를 클릭한 후 Odoo의 Microsoft 계정 에서 이메일을 보낼 사용자 또는 사용자 그룹을 추가합니다. 사용자/그룹 추가 를 클릭하고 선택 을 클릭한 다음 애플리케이션에서 배정 합니다.
자격 증명 생성¶
이제 Microsoft Azure 앱이 설정되었으므로 Odoo 설정을 위한 자격 증명을 생성해야 합니다. 여기에는 클라이언트 ID 및 클라이언트 보안 이 포함되어 있습니다. 시작하려면 앱에 있는 클라이언트 ID`를 :guilabel:`전체 보기 페이지에서 복사할 수 있습니다. 클라이언트 ID 또는 애플리케이션 ID`는 앱의 :guilabel:`주요 내용 전체 보기에 있는 표시 이름 아래에 있습니다.
다음으로 클라이언트 보안 값 을 검색해야 합니다. 이 값을 가져오려면 왼쪽 사이드바 메뉴에서 인증서 및 비밀번호 를 클릭합니다. 그런 다음 클라이언트 비밀번호 를 생성합니다. 생성하려면 (+) 새 클라이언트 비밀번호 버튼을 클릭합니다.
오른쪽 창에는 클라이언트 보안 추가 라는 버튼이 표시됩니다. 설명 아래에 Odoo 페치메일
이나 다른 확인용 이름을 입력한 다음 :guilabel:` 만료일` 을 설정합니다.
중요
첫 번째 비밀번호가 만료되면 새로운 클라이언트 비밀번호 를 생성하고 설정해야 합니다. 이 경우 서비스가 중단될 수 있으므로 유효기간을 명시하여 최대한 나중의 날짜로 설정하시기 바랍니다.
다음으로, 이 두 값을 입력한 후 추가 를 클릭합니다. 클라이언트 보안 값 및 보안 ID 가 생성됩니다. 이 페이지에서 나갈 경우 암호화되기 때문에 값 또는 클라이언트 보안 값 을 메모장에 복사해 두는 것이 중요합니다. 보안 ID 는 필요하지 않습니다.
해당 단계가 끝나면 Odoo에서 다음 항목을 설정할 준비가 완료됩니다.
클라이언트 ID (클라이언트 ID 또는 애플리케이션 ID)
클라이언트 비밀번호 (값 또는 클라이언트 보안 값)
이것으로 Microsoft Azure 포털 에 대한 설정이 완료됩니다.
Odoo에서 설정하기¶
Microsoft Outlook 자격 증명 입력¶
먼저, Odoo 데이터베이스를 열고 앱 모듈로 이동합니다. 그런 다음 검색창에서 앱 필터를 제거한 후 Outlook
을 입력합니다. 그 다음 Microsoft Outlook 모듈을 설치합니다.
다음으로 메일 및 채팅 섹션에서 맞춤형 이메일 서버 확인란에 표시가 되어 있는지 확인합니다. 그러면 Outlook 자격 증명 에 대한 새 항목이 입력됩니다.
으로 이동하여진행 상황을 저장 합니다.
그런 다음 클라이언트 ID (애플리케이션 ID) 및 클라이언트 비밀번호 (클라이언트 보안 값) 를 복사하여 해당 항목에 붙여넣은 후 설정을 :guilabel:`저장`합니다.
이메일 발신 서버 환경 설정¶
일반 설정 페이지에서 사용자 지정 이메일 서버 설정 아래에 있는 발신 이메일 서버 링크를 클릭하면 Microsoft 계정을 설정할 수 있습니다.
그런 다음 새 이메일 서버를 만든 후 Outlook 확인란에 표시합니다. 다음으로 이름 (어떤 이름이든 입력 가능)과 Microsoft Outlook 이메일 사용자 이름 을 입력합니다.
발신자 필터 항목의 비어 있으면 도메인 또는 이메일 주소 를 입력합니다.
그런 다음 Outlook 계정 연결 을 클릭합니다.
Microsoft에서 새 창이 열리고 인증 프로세스 가 완료됩니다. Odoo에서 설정되어 있는 알맞은 이메일 주소를 선택합니다.
그런 다음 예 를 클릭하여 Odoo에서 Microsoft 계정에 액세스하도록 허용합니다. 그러면 Odoo에 새로 설정된 발신 메일 서버 로 페이지가 다시 이동합니다. 환경 설정을 통해 Odoo에서 토큰 을 자동으로 로드하고 Outlook 토큰 유효 라는 태그가 초록색으로 나타납니다.
마지막으로, :guilabel:`테스트 연결`을 클릭합니다. 확인 메시지가 나타날 것입니다. Odoo 데이터베이스에서 이제 OAuth 인증을 사용하여 Microsoft Outlook을 통해 안전하게 보안 이메일을 발송할 수 있습니다.
단일 발신 메일 서버에 대한 환경 설정¶
가장 간단하게 Microsoft Azure에서 환경 설정을 하려면 단일 발신 메일을 설정하면 됩니다. 이 경우 데이터베이스 사용자에게 액세스 권한을 광범위하게 부여할 필요가 없습니다.
일반 이메일 주소는 데이터베이스 내에 있는 모든 사용자에게 이메일을 보내는 데 사용합니다. 예를 들어 알림
별칭 (notifications@example.com
) 또는 연락처
별칭 (contact@example.com
) 으로 설정할 수 있습니다. 이 주소는 서버의 보낸 사람 필터 로 설정되어야 합니다. 이 주소는 시스템 매개변수의 {mail.default.from}@{mail.catchall.domain}
키 조합과도 일치해야 합니다.
더 보기
자세한 내용은 발신자 필터 문서 를 참조하세요.
참고
시스템 매개변수 에 엑세스하려면 메뉴에서 :ref:`개발자 모드 ` 를 활성화합니다.
이 환경 설정을 적용하면 데이터베이스에서 전송되는 모든 이메일은 ‘알림’ 메일함에서 설정된 주소를 사용하여 전송됩니다. 다만 발신자 이름은 표시되지만 이메일 주소는 변경된다는 점에 유의해야 합니다.
Example
단일 발신 메일 서버에 대한 환경 설정:
발신 메일 서버 username (로그인) =
notifications@example.com
발신 메일 서버 FROM 필터 =
notifications@example.com
시스템 매개변수의
mail.catchall.domain
=example.com
시스템 매개변수의
mail.default.from
=notifications
사용자별 (다중 사용자) 환경 설정¶
일반 이메일 서버 외에도 데이터베이스 사용자용으로 개별 이메일 서버를 설정할 수 있습니다. 이 환경 설정을 사용하려면 각 개별 서버에서 반드시 이메일 주소를 FROM 필터 로 설정해야 합니다.
이 환경 설정의 경우 Microsoft Azure 의 두 가지 환경 설정 중에서 좀 더 어려운 항목으로, 이메일 서버에 연결 설정을 하려면 설정 메뉴에서 모든 사융자에게 이메일 서버 액세스 권한을 부여해야 한다는 점에서 그렇습니다.
설정¶
사용자별로 별도의 이메일 서버를 설정해야 합니다. 보낸 사람 필터`를 설정하여 서버에서 해당하는 사용자의 이메일만 전송되도록 해야 합니다. 즉, 사용자의 이메일 주소가 설정된 :guilabel:`보낸 사람 필터 와 일치하는 경우에만 이 서버를 사용할 수 있습니다.
더 보기
자세한 내용은 발신자 필터 문서 를 참조하세요.
알림`을 전송할 수 있도록 반드시 :ref:`폴백 서버 <azure_oauth/notifications> 를 설정해야 합니다. 이 서버의 FROM 필터 값은 {mail.default.from}@{mail.catchall.domain}
으로 지정하도록 합니다.
참고
시스템 매개변수 에 엑세스하려면 메뉴에서 :ref:`개발자 모드 ` 를 활성화합니다.
중요
트랜젝션 이메일 서버의 환경 설정은 대량 메일 발송용 이메일 발신 서버와 함께 작동할 수 있습니다. 대량 메일 발송용 이메일 서버에 대한 발신자 필터 는 비워 둘 수 있으나 이메일 마케팅 애플리케이션 설정에 추가해야 합니다.
더 보기
대량 메일 발송용 이메일 서버 설정에 대한 자세한 내용은 외부 SMTP 서버로 이메일 보내기 를 참조하세요.
Example
다중 사용자용 발신 메일 서버 설정:
- 사용자 #1 편지함
발신 메일 서버 #1 사용자 이름 (로그인) =
john@example.com
발신 메일 서버 #1 FROM 필터 =
john@example.com
- 사용자 #2 편지함
발신 메일 서버 #2 사용자 이름 (로그인) =
jane@example.com
발신 메일 서버 #2 FROM 필터 =
jane@example.com
- 알림용 편지함
발신 메일 서버 #3 사용자 이름 (로그인) =
notifications@example.com
발신 메일 서버 #3 FROM 필터 =
notifications@example.com
- 시스템 매개 변수
시스템 매개변수의
mail.catchall.domain
=example.com
시스템 매개변수의
mail.default.from
=notifications
이메일 수신 서버 환경 설정¶
수신 계정은 이메일 발신 계정과 유사한 방식으로 구성되어야 합니다. 기술 메뉴`내의 :guilabel:`수신 메일 서버`로 이동하여 :guilabel:`만들기`로 새로 구성을 진행하십시오. :guilabel:`Outlook Oauth 인증 옆에 있는 버튼을 확인하거나 선택한 후 Microsoft Outlook 사용자 이름`을 입력합니다. :guilabel:`Outlook 계정에 연결`을 클릭합니다. Odoo에서 :guilabel:`Outlook 토큰 유효함 메시지를 확인하실 수 있습니다. 이제 계정에 :guilabel:`테스트 및 확인`을 진행합니다. 계정에서 Odoo 데이터베이스로 이메일을 수신할 준비가 되어 있어야 합니다.