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 리디렉션 섹션에서 플랫폼으로 을 선택한 다음 URLhttps:///<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

참고

기본적으로 사용자 읽기 권한이 추가됩니다.

Odoo 통합에 필요한 API 권한은 Microsoft Graph에 나타나 있습니다.

사용자 및 그룹 배정하기

API 권한을 추가한 후 왼쪽 사이드바 메뉴 상단에 있는 애플리케이션`의 :guilabel:`전체보기 로 돌아갑니다.

이제 이 애플리케이션에 사용자를 추가합니다. 필수 정보 전체보기 표에서 로컬 디렉토리용 관리 애플리케이션 링크를 클릭하거나 표 오른쪽 하단에 있는 마지막 옵션을 클릭합니다.

애플리케이션 생성 후 사용자/그룹을 추가하려면 로컬 디렉토리에서 관리하는 애플리케이션 링크를 클릭합니다.

왼쪽 사이드바 메뉴에서 사용자 및 그룹 을 선택합니다. 다음으로 (+) 사용자/그룹 추가 를 클릭합니다. 계정에 따라 그룹사용자 모두 추가하거나 혹은 사용자 만 추가할 수 있습니다. 개인 계정에서는 사용자 만 추가할 수 있습니다.

사용자 또는 그룹 에서 선택되지 않음 를 클릭한 후 Odoo의 Microsoft 계정 에서 이메일을 보낼 사용자 또는 사용자 그룹을 추가합니다. 사용자/그룹 추가 를 클릭하고 선택 을 클릭한 다음 애플리케이션에서 배정 합니다.

자격 증명 생성

이제 Microsoft Azure 앱이 설정되었으므로 Odoo 설정을 위한 자격 증명을 생성해야 합니다. 여기에는 클라이언트 ID클라이언트 보안 이 포함되어 있습니다. 시작하려면 앱에 있는 클라이언트 ID`를 :guilabel:`전체 보기 페이지에서 복사할 수 있습니다. 클라이언트 ID 또는 애플리케이션 ID`는 앱의 :guilabel:`주요 내용 전체 보기에 있는 표시 이름 아래에 있습니다.

앱 전체보기에 있는 애플리케이션/클라이언트 ID

다음으로 클라이언트 보안 값 을 검색해야 합니다. 이 값을 가져오려면 왼쪽 사이드바 메뉴에서 인증서 및 비밀번호 를 클릭합니다. 그런 다음 클라이언트 비밀번호 를 생성합니다. 생성하려면 (+) 새 클라이언트 비밀번호 버튼을 클릭합니다.

오른쪽 창에는 클라이언트 보안 추가 라는 버튼이 표시됩니다. 설명 아래에 Odoo 페치메일 이나 다른 확인용 이름을 입력한 다음 :guilabel:` 만료일` 을 설정합니다.

중요

첫 번째 비밀번호가 만료되면 새로운 클라이언트 비밀번호 를 생성하고 설정해야 합니다. 이 경우 서비스가 중단될 수 있으므로 유효기간을 명시하여 최대한 나중의 날짜로 설정하시기 바랍니다.

다음으로, 이 두 값을 입력한 후 추가 를 클릭합니다. 클라이언트 보안 값보안 ID 가 생성됩니다. 이 페이지에서 나갈 경우 암호화되기 때문에 또는 클라이언트 보안 값 을 메모장에 복사해 두는 것이 중요합니다. 보안 ID 는 필요하지 않습니다.

클라이언트 보안 값 또는 앱 자격 증명 값

해당 단계가 끝나면 Odoo에서 다음 항목을 설정할 준비가 완료됩니다.

  • 클라이언트 ID (클라이언트 ID 또는 애플리케이션 ID)

  • 클라이언트 비밀번호 ( 또는 클라이언트 보안 값)

이것으로 Microsoft Azure 포털 에 대한 설정이 완료됩니다.

Odoo에서 설정하기

Microsoft Outlook 자격 증명 입력

먼저, Odoo 데이터베이스를 열고 모듈로 이동합니다. 그런 다음 검색창에서 필터를 제거한 후 Outlook 을 입력합니다. 그 다음 Microsoft Outlook 모듈을 설치합니다.

다음으로 설정 ‣ 일반 설정 으로 이동하여 메일 및 채팅 섹션에서 맞춤형 이메일 서버 확인란에 표시가 되어 있는지 확인합니다. 그러면 Outlook 자격 증명 에 대한 새 항목이 입력됩니다.

진행 상황을 저장 합니다.

그런 다음 클라이언트 ID (애플리케이션 ID) 및 클라이언트 비밀번호 (클라이언트 보안 값) 를 복사하여 해당 항목에 붙여넣은 후 설정을 :guilabel:`저장`합니다.

Odoo 일반 설정에 있는 Outlook 자격 증명

이메일 발신 서버 환경 설정

일반 설정 페이지에서 사용자 지정 이메일 서버 설정 아래에 있는 발신 이메일 서버 링크를 클릭하면 Microsoft 계정을 설정할 수 있습니다.

그런 다음 새 이메일 서버를 만든 후 Outlook 확인란에 표시합니다. 다음으로 이름 (어떤 이름이든 입력 가능)과 Microsoft Outlook 이메일 사용자 이름 을 입력합니다.

발신자 필터 항목의 비어 있으면 도메인 또는 이메일 주소 를 입력합니다.

그런 다음 Outlook 계정 연결 을 클릭합니다.

Microsoft에서 새 창이 열리고 인증 프로세스 가 완료됩니다. Odoo에서 설정되어 있는 알맞은 이메일 주소를 선택합니다.

새로 생성한 앱과 Odoo 사이에 액세스를 허용하는 권한 페이지

그런 다음 를 클릭하여 Odoo에서 Microsoft 계정에 액세스하도록 허용합니다. 그러면 Odoo에 새로 설정된 발신 메일 서버 로 페이지가 다시 이동합니다. 환경 설정을 통해 Odoo에서 토큰 을 자동으로 로드하고 Outlook 토큰 유효 라는 태그가 초록색으로 나타납니다.

유효한 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 데이터베이스로 이메일을 수신할 준비가 되어 있어야 합니다.