목차 · 찾기
위피스 설명서
Microsoft 365 계정을 Microsoft 로그인으로 연결하기
Microsoft 365(Outlook) 메일 계정을 Odoo의 보내는 서버와 받는 서버로 연결하는 순서입니다. 비밀번호를 Odoo에 적지 않고 Microsoft 로그인 화면에서 허락하는 방식(OAuth)입니다. 먼저 Microsoft Azure 포털에서 Odoo용 앱을 등록하고, 그 앱의 ID와 비밀을 Odoo 설정에 넣은 뒤 계정을 연결합니다.
시작하기 전에
- Odoo 쪽은 관리자 권한이 필요합니다. 관리자만 Outlook 메일 서버를 연결할 수 있습니다.
- Azure 쪽은 앱을 등록할 수 있는 Microsoft 365 관리자 계정이 필요합니다.
- 설정 → 일반 설정 → 이메일에서 사용자 지정 이메일 서버 사용을 켜 둡니다. 켜야 Outlook 서버 사용 칸이 보입니다. 순서는 회사 메일 계정을 연결해 Odoo에서 메일 주고받기에 있습니다.
- 회사 접속 주소를 확인합니다. 브라우저 주소창에 보이는
https://<회사 주소>부분입니다. Azure 쪽에 이 주소를 적어야 합니다.
Azure 포털에서 앱 등록하기
- Microsoft 365 관리자 계정으로 Azure 포털(portal.azure.com)에 로그인하고 Microsoft Entra ID로 들어갑니다.
- 앱 등록에서 새 앱을 등록합니다.
- 이름: 알아보기 쉽게(예:
Odoo) - 지원되는 계정 유형: 「모든 조직 디렉터리의 계정 및 개인 Microsoft 계정」
- 리디렉션 URI: 플랫폼은 「웹」, 주소는
https://<회사 주소>/microsoft_outlook/confirm
- 이름: 알아보기 쉽게(예:
- 등록한 앱의 API 권한에서 권한 추가 → Microsoft Graph → 위임된 권한을 고르고 아래 두 가지를 추가합니다.
SMTP.Send(보내기)IMAP.AccessAsUser.All(받기)
- 앱 개요 화면의 「로컬 디렉터리의 관리되는 애플리케이션」 링크로 들어가 사용자 및 그룹에 Odoo에서 쓸 메일 계정을 할당합니다.
- 인증서 및 비밀에서 새 클라이언트 암호를 만듭니다. 만료 기간은 고를 수 있는 가장 긴 값으로 정하고, 만료일을 따로 적어 둡니다.
- 아래 두 값을 복사해 둡니다. 암호 값은 이 화면을 벗어나면 다시 볼 수 없습니다.
- 앱 개요의 애플리케이션(클라이언트) ID
- 방금 만든 클라이언트 암호의 값 (암호 ID가 아닙니다)
Odoo에 앱 ID와 비밀 넣기
- 왼쪽 위 앱 메뉴에서 설정을 엽니다.
- 일반 설정 탭의 이메일 칸에서 Outlook 서버 사용을 찾습니다.
- ID에 애플리케이션(클라이언트) ID를, 비밀에 클라이언트 암호 값을 붙여 넣습니다.
- 위쪽의 저장을 누릅니다.
보내는 서버 연결하기
- 같은 화면의 이메일 칸에서 발신 메일 서버를 누르고 신규를 누릅니다.
- 이름을 적습니다(예:
Microsoft 365). - 다음으로 인증에서 Outlook OAuth 인증을 고릅니다. SMTP 서버에
smtp.outlook.com, SMTP 포트에587, 연결 암호화에 「TLS (STARTTLS), 암호화 전용」이 저절로 들어갑니다. - 사용자 이름에 연결할 메일 주소를 적습니다. 필터에서에도 같은 주소가 저절로 들어갑니다.
- Outlook 계정 연결하기를 누릅니다. 아직 저장하지 않았다면 이때 저장됩니다.
- Microsoft 로그인 화면이 열리면 4번의 계정으로 로그인하고 권한 요청에 동의합니다.
- Odoo 화면으로 돌아오면 초록색 유효한 Outlook 토큰 표시가 보입니다.
- 위쪽의 테스트 연결을 누릅니다. 성공 알림이 뜨면 끝입니다.
받는 서버 연결하기
- 설정 → 일반 설정 → 이메일에서 이메일 수신 서버를 누르고 신규를 누릅니다.
- 이름을 적고 서버 유형에서 Outlook OAuth 인증을 고릅니다. 서버 이름에
imap.outlook.com, 포트에993이 들어가고 SSL/TLS가 켜집니다. - 사용자 이름에 보내는 서버와 같은 메일 주소를 적습니다.
- 필요하면 새 레코드 만들기에서 새 메일로 만들 기록 종류를 고릅니다.
- Outlook 계정 연결하기를 누르고 같은 계정으로 로그인해 동의합니다.
- 돌아와서 시험 & 확인을 누릅니다. 상태가 「확인됨」이 되면 5분마다 읽지 않은 메일을 가져옵니다.
직원이 자기 Outlook으로 보내게 하기
관리자가 위의 ID와 비밀을 넣어 두면 직원도 자기 계정으로 보낼 수 있습니다. 직원은 오른쪽 위 자기 사진 → 내 추가 설정 → 발신 메일 서버에서 Outlook을 고르고, Microsoft 화면에서 자기 계정으로 동의합니다. 이 계정도 Azure 앱의 사용자 및 그룹에 할당되어 있어야 합니다.
알아 둘 점
- 위피스 Odoo에서는 Azure 앱을 직접 등록해야 합니다. ID와 비밀이 비어 있으면 Outlook 계정 연결하기를 눌러도 「Outlook 자격 증명을 구성하십시오.」라는 오류가 뜹니다.
- 클라이언트 암호에는 만료일이 있습니다. 만료되면 Odoo가 새 접속 토큰을 받지 못해 메일이 「전송 실패」로 남습니다. 오류 내용은 「액세스 토큰을 가져오는 중 오류가 발생했습니다.」로 시작합니다. 만료 전에 Azure에서 새 암호를 만들고 Odoo의 비밀 칸을 바꿉니다.
- 회사 접속 주소가 바뀌면 리디렉션 URI를 추가합니다. 자기 도메인으로 주소를 옮겼다면 Azure 앱의 인증 화면에
https://<새 주소>/microsoft_outlook/confirm을 더합니다. - 비밀번호 칸은 비워 두고, 연결 암호화는 바꾸지 않습니다. 둘 중 하나라도 어긋나면 저장되지 않습니다.
- 이 서버로 나가는 다른 직원의 메일은 보낸 사람 주소가 바뀔 수 있습니다. Outlook 서버는 필터에서의 주소로 보내는 메일에 먼저 쓰입니다. 다른 주소로 보내는 메일은 답장 받을 메일 도메인 정하고 스팸함 피하기의 「기본 보낸 사람」 규칙을 따릅니다. 계정 하나로 모든 직원 메일을 보낼 때는 별칭 도메인의 보내는 별칭 기본값을 그 계정 이름으로 맞춥니다.
- 직원 개인 Outlook 서버는 1분에 받는 사람 10명까지 보냅니다. 넘치는 몫은 버리지 않고 다음 분으로 미뤄 보냅니다. Outlook이 빠른 발송을 스팸으로 보기 쉬워 다른 개인 서버(1분에 30명)보다 낮게 잡혀 있습니다.
- Outlook 서버 사용 칸의 체크를 풀지 마세요. 풀고 저장하면 Outlook 연결 기능(모듈)이 지워지고, 만들어 둔 Outlook 서버는 「사용자 이름」 방식으로 바뀌어 메일이 나가지 않습니다.