작업 이메일의 패키지 연결 사용

이메일 패키지의연결 작업을 사용하여 이메일 서버와의 연결을 설정합니다. 이메일 관련 태스크를 자동화할 때는 이 작업을 가장 먼저 이용해야 합니다.

전제 조건

OAuth 2.0를 이용하여 이메일 자동화를 위해 이메일 서버에 인증할 수 있습니다. 이메일 서비스 공급자에 따라 관련 단계를 수행합니다.
  • Outlook/Office 365
    • 클라이언트 자격증명 흐름 인증 모드를 사용하는 경우 다음 단계를 수행합니다.
      1. Microsoft Azure portal에 로그인합니다.
      2. Microsoft ID 플랫폼에 애플리케이션을 등록하여 클라이언트 ID와 테넌트 ID를 확보합니다. Register an application 항목을 참조하십시오.
      3. 클라이언트 비밀을 추가합니다.

        Add a client secret 항목을 참조하십시오.

      4. 연결하는 메일 서버에 따라 관련 단계를 수행합니다.
    • PKCE를 사용한 인증 코드 인증 모드를 사용하는 경우 다음 단계를 수행하십시오.
      1. Microsoft Azure portal에 로그인합니다.
      2. Microsoft ID 플랫폼에 애플리케이션을 등록하여 클라이언트 ID와 테넌트 ID를 확보합니다. Register an application 항목을 참조하십시오.
      3. 애플리케이션을 등록할 때 URI 리디렉션을 http://localhost:9999/callback으로 설정합니다.
      4. MAP, POP3 및 SMTP에 대해 위임된 유형으로 권한을 추가하고 애플리케이션에 Microsoft Graph에 필요한 권한을 애플리케이션에 부여합니다.
    • Control Room 관리형 인증 모드를 사용하는 경우 Configure Control Room managed OAuth for Outlook/Office365 (A-people login required) 항목을 참조하십시오.

    다음 재생 목록에 있는 비디오에서는 이메일 연결 작업에서 OAuth 2.0 인증을 구성하고 사용하는 방법에 대한 정보를 제공합니다.

    주: 사서함이 루프 작업 내에서 사용되는 경우 자동화를 수행하도록 할당된 사용자를 등록해야 합니다. 자세한 내용은 Manage users and groups assignment to an application 항목을 참조하십시오.
  • Gmail
    • PKCE를 사용한 인증 코드 인증 모드를 사용하는 경우 다음 단계를 수행하십시오.
      1. GCP(Google Cloud Platform)에서 OAuth2.0 설정을 구성하고 Automation 360을 Google Workspace 애플리케이션과 연결하는데 필요한 자격증명을 검색합니다.
      2. 프로젝트를 생성했는지 확인합니다.

        프로젝트 생성을 참조하십시오.

      3. 클라이언트 ID 및 클라이언트 비밀을 생성합니다.
        Oauth 2.0 설정하기를 참조하십시오.
        주:
        • 웹 애플리케이션 옵션을 선택합니다.
        • 승인된 리디렉션 URI http://localhost:8888/Callback을 추가합니다.
      4. 단계를 수행하여 Automation 360에 연결하는 데 사용할 사용자 이름에 대한 사용자 동의를 설정합니다.
    • Control Room 관리형 인증 모드를 사용하는 경우 다음 단계를 수행하십시오.
      중요사항: 이메일 패키지는 현재 인증 코드 흐름을 기반으로 하는 OAuth 연결에 대해서만 Control Room 관리형 옵션을 지원합니다.
      1. GCP(Google Cloud Platform)에서 OAuth2.0 설정을 구성하고 Automation 360을 Google Workspace 애플리케이션과 연결하는데 필요한 자격증명을 검색합니다.
      2. 프로젝트를 생성했는지 확인합니다.

        프로젝트 생성을 참조하십시오.

      3. 클라이언트 ID 및 클라이언트 비밀을 생성합니다.
        Oauth 2.0 설정하기를 참조하십시오.
        주:
        • 웹 애플리케이션 옵션을 선택합니다.
        • 인증된 리디렉션 URI를 추가하려면 다음 단계를 수행하십시오.
          1. Control Room에 관리자 또는 연결 관리 및 연결 보기 권한이 있는 사용자로 로그인하고 관리 > OAuth 연결로 이동합니다.
          2. 연결 생성 탭을 클릭하고 공급자 유형 필드에서 사용자 정의 옵션을 선택합니다.
          3. 콜백 URL을 복사하고 Google Cloud 콘솔에서 해당 클라이언트 애플리케이션 페이지로 되돌아갑니다.
          4. 승인된 리디렉션 URI 아래의 + URI 추가 버튼을 클릭하고 URI 필드에 URI를 붙여넣습니다.
          5. 생성을 클릭합니다.

          Control Room에서 OAuth 연결을 만드는 방법을 알아보려면 OAuth 연결 생성 항목을 참조하십시오.

      4. 단계를 수행하여 에 연결하는 데 사용할 사용자 이름에 대한 사용자 동의Automation 360를 설정합니다.
주:
  • 클라이언트 자격증명 흐름은 Gmail을 지원하지 않습니다.
  • 클라이언트 자격증명과 PKCE가 있는 인증 코드 인증 모드는 Yahoo 및 MSN 메일 서버를 지원하지 않습니다.
권장 사항: 인증 모드(클라이언트 자격증명 및 PKCE를 사용한 인증 코드)를 모두 사용하려면 별도의 두 애플리케이션에 등록해야 합니다.
주: Exchange 웹 서비스 서버에 연결할 때 다단계 인증(MFA)을 사용할 수 있는 모든 조직 수준 보안 정책을 포함하여 다단계 인증(MFA)을 비활성화해야 합니다. MFA를 완전히 비활성화하지 않으면 연결 또는 인증 오류가 발생할 수 있습니다. 그러나 여전히 MFA를 사용하려면 이 문서의 정보를 검토하십시오(성공적인 연결이 보장되지 않는다는 점에 유의하십시오).

Multi-factor authentication for Azure EWS (A-people login required)

이 작업을 통해 이메일 서버 자격증명 및 세부정보를 제공하고 이 정보를 세션 이름과 연계할 수 있습니다. 다른 이메일 작업에 동일한 이 세션 이름을 이용하면 서버 정보를 한 번만 제공하면 됩니다.

프로시저

메일 서버에 연결하려면 다음 단계에 따릅니다.

  1. 작업 팔레트의 이메일 패키지에서연결 작업을 더블 클릭하거나 끌어 옵니다.
  2. 세션 이름을 입력합니다.
  3. Outlook,이메일 서버 또는 EWS 옵션에서, Microsoft Outlook과 메일 서버 중 어느 쪽에 연결할지를 지정합니다.
    주:
    • EWS 서버에 연결하고 루프 작업을 사용하여 이메일 서버에서 모든 이메일을 검색할 경우, 이메일 제목에 다음 문자가 포함되어 있으면 봇이 실행되지 않고 오류 메시지가 표시됩니다.
      • 제어 문자
        • 범위: 0x00 - 0x08 (except 0x09 - Horizontal Tab) and 0x0B - 0x0C (except 0x0A - Line Feed and 0x0D - Carriage Return)
        • 16진수 값: 0x00-0x08, 0x0B-0x0C, 0x0E-0x1F
      • 상위 서로게이트 및 하위 서로게이트 쌍
        • 범위: 0xD800 - 0xDFFF
        • 16진수 값: 0xD800 - 0xDFFF
      • 비문자 코드 포인트
        • 범위: 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
        • 16진수 값: 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
      • 제한된 범위
        • 범위: 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF
        • 16진수 값: 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF

          해결 방법: Microsoft Outlook 또는 이메일 서버를 사용하여 이 작업을 수행할 수 있습니다. 그러나 Microsoft가 Exchange Online에 연결하는 데 사용되는 EWS API에 대한 EOL을 발표했기 때문에 Microsoft 365 Outlook 패키지를 사용할 것을 권장합니다. Exchange Online의 EWS API 지원 중단 항목을 참조하십시오.

    • Microsoft Outlook과 연결을 설정하면 이메일 메시지가 공유 사서함에서 처리됩니다. Outlook 애플리케이션에서 공유 사서함을 설정해야 합니다.
      • 이 기능은 Outlook에서만 지원됩니다.
      • 공유 사서함의 사서함 목록에서 사서함 하나만 선택할 수 있습니다.
      • 봇은 달력 초대를 이메일 객체로 선택하지 않기 때문에 Outlook에서는 회의 초대를 읽을 수 없습니다. 이 기능은 현재는 지원되지 않습니다.
    • Outlook 옵션을 선택한 경우 추가 세부정보를 제공할 필요가 없습니다.

      변수 옵션을 사용하여 연결하려는 이메일 주소를 지정할 수 있습니다.

      주: 새 Outlook 클라이언트에 연결할 수 없습니다. 그러나 클래식 Outlook 클라이언트로 전환하여 이메일 관련 작업을 자동화할 수 있습니다.
    • 이메일 서버 옵션을 선택한 경우, 다음 필드를 작성합니다.
      주: 다양한 메일 서버에 이용할 호스트 및 포트에 대한 자세한 내용은 이메일 서버 설정 항목을 참고하십시오.
      • 보안 연결 사용(SSL/TLS) 메일 서버와의 보안 연결을 이용하려면 이 옵션을 선택합니다.
      • 호스트: 메일 서버의 이름을 입력합니다.
        주: 이 필드는 대소문자를 구분하지 않습니다.
      • 포트: 서버의 포트 번호를 입력합니다.
      • 프로토콜: IMAP 또는 POP3 프로토콜을 선택합니다.
        주: Regex는 IMAP 프로토콜에 대해 지원되며, 받은 편지함 아래의 모든 하위 폴더에서 이메일을 읽습니다.
      • 인증 모드: 다음 인증 모드 중에서 선택합니다.
        • 기본: 사용자 이름 및 비밀번호를 사용합니다.
        • OAuth2 – PKCE를 사용한 인증 코드: Microsoft identity platform and OAuth 2.0 authorization code flow 항목을 참조하십시오.

          메일 서버용 PKCE 흐름과 함께 OAuth 인증 코드를 사용하도록 Azure에서 애플리케이션을 설정하는 방법에 대한 자세한 내용은 How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required) 항목을 참조하십시오.

        • OAuth2 – 클라이언트 자격증명: Microsoft identity platform and the OAuth 2.0 client credentials flow 항목을 참조하십시오.

          IMAP/POP3 메일 서버용 OAuth 2.0 클라이언트 자격증명 흐름을 사용하도록 Azure에서 애플리케이션을 설정하는 방법에 대한 자세한 내용은 How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required) 항목을 참조하십시오.

        • Control Room 관리
          Control Room 관리형 OAuth2 인증 모드를 사용하여 Gmail을 자동화하려면 Control Room에서 OAuth 연결을 구성해야 합니다. OAuth 연결 생성 항목을 참조하십시오.
          주: Control Room OAuth 관리에서는 Outlook 클라이언트가 아닌 Gmail만 지원합니다.

          다음 필드에 필요한 정보를 입력합니다.

          • 연결: 선택 버튼을 클릭하여 연결 유형을 선택합니다.
          • 공급자 유형 필드에서 사용자 정의를 선택합니다.

          • Google Workspace 앱의 Control Room에서 설정한 연결 이름을 선택합니다.

          • 토큰 유형 필드를 이용하여 다음 옵션 중 하나를 선택합니다.

            Google Workspace 애플리케이션 액세스 및 새로 고침 토큰에 대한 자세한 내용은 엔터프라이즈 애플리케이션 구성을 참조하십시오.

            • 공유: 자동화를 실행하는 모든 사용자에 대해 OAuth2 액세스 토큰이 공유되는 경우 이 옵션을 선택합니다.
              주: 이 옵션을 사용하려면 Control Room 관리자 또는 사용자(OAUTH 연결에 대해 연결 관리 및 연결 보기 옵션을 활성화한 상태)가 Control Room에서 OAuth 연결을 설정해야 한다는 점에 유의하십시오. 로그인 자격증명을 한 번만 저장하면 자동화를 실행하는 모든 사용자가 사용할 수 있는 공유 액세스 토큰을 생성할 수 있습니다.
            • 사용자별: OAuth2 액세스 토큰이 자동화를 실행하는 각 사용자에게 고유한 경우 이 옵션을 선택합니다.
              주: 이 옵션을 사용하려면 Control Room 관리자 또는 사용자(OAUTH 연결에 대해 연결 관리 및 연결 보기 옵션을 활성화한 상태)가 Control Room에서 OAuth 연결을 설정해야 한다는 점에 유의하십시오. 자동화를 실행하는 각 사용자가 로그인 자격증명을 제공하고 해당 특정 사용자만 사용할 수 있는 액세스 토큰을 생성할 수 있도록 로그인 자격증명을 저장하지 않도록 하십시오.
            • 확인을 클릭합니다.
          주: 사용자별 옵션을 사용할 경우, Google 계정에 로그인하여 사용자별 토큰을 인증하고 생성해야 합니다. 이 옵션을 사용하려면 다음 단계를 수행하십시오.
          1. Control Room에서 프로필 내 설정 > Oauth 연결로 이동합니다.
          2. 로그인하여 인증을 클릭합니다.
          3. Google 계정에 로그인하고 계속을 선택합니다.
          4. 액세스 권한이 있는 서비스를 확인하고 계속을 클릭합니다.

            연결에 성공하면 상태가 활성으로 표시됩니다.

        선택한 인증 모드에 따라 다음 필드에 해당하는 세부 정보를 지정해야 합니다.
        • 사용자 이름: 메일 서버에 액세스하기 위해 사용하고자 하는 사용자 이름을 입력합니다.

          예: john.smith@myCompanyName.com

        • 비밀번호: 제공한 사용자 이름의 비밀번호를 입력합니다.
        • 클라이언트 ID, 테넌트 ID, 리디렉션 URI 및 클라이언트 비밀 필드의 경우, Azure portal의 계정에 제공된 정보를 입력하십시오.
        • 이메일 공급자: 드롭다운 목록에서 이메일 서비스 공급자를 선택합니다.
          • Outlook/Office365

            이 옵션을 선택한 경우 테넌트 ID를 제공하십시오.

          • Gmail
        사용자 이름, 비밀번호, 테넌트 ID, 클라이언트 ID, 클라이언트 비밀 필드의 경우 자격증명, 변수 또는 안전하지 않은 문자열 탭 중에서 선택합니다.
        • 자격증명: 자격증명 저장소에 있는 사용 가능한 값을 사용합니다.
        • 변수: 값을 저장하는 사용자 정의 변수를 사용합니다.
        • 안전하지 않은 문자열: 수동으로 값을 입력합니다.
    • EWS 옵션을 선택한 경우 다음 필드를 완료합니다.
      • Exchange 버전: 다음 중 회사에서 이용하는 버전을 선택하십시오.
        • Exchange Server 2013
        • Exchange2010_SP2
        • Exchange2010_SP1
        • Exchange2010
        • Exchange2007_SP1
      • Azure 클라우드: 다음 중 회사에서 이용하는 제품을 선택하십시오.
        • Azure Global: Microsoft 365 상용 버전 고객용(login.microsoftonline.com)
        • Azure US GCC High: Microsoft 365 정부 버전 고객용(login.microsoftonline.us)
      • 선택 사항: 도메인 이름:
        • Microsoft 365 고객인 경우, 이 필드를 비워 두면 Automation Workspace는 smtp.office365.com을 이용하여 서버에 연결합니다.
        • Microsoft 365 고객이며 사용자 이름 필드에 도메인 이름을 입력한 경우, 반드시 이 필드에 smtp.office365.com을 입력해야 합니다.
        • Microsoft 365 고객이 아닌 경우 조직의 도메인 이름을 입력합니다. 그렇지 않으면, Automation Workspace은 사용자 이름 필드에 입력한 도메인 이름을 이용합니다.
      • 인증 모드: 다음 인증 모드 중에서 선택합니다.
        주: Automation 360 v.27 이상에서 인증 유형 OAuth2-무음 인증 모드는 OAuth2-ROPC로 이름이 바뀌고, OAuth2-대화형 인증 모드는 OAuth2-암시적으로 이름이 바뀝니다.

        EWS를 사용하여 공유 사서함에 연결하는 데 문제가 있는 경우에는 Unable to connect to shared mailbox using EWS error (A-People login required) 항목을 참조하십시오.

        선택한 인증 모드에 따라 다음 필드에 해당하는 세부 정보를 지정해야 합니다.
        • 사용자 이름: 메일 서버에 액세스하기 위해 사용하고자 하는 사용자 이름을 입력합니다.

          예: john.smith@myCompanyName.com

        • 비밀번호: 제공한 사용자 이름의 비밀번호를 입력합니다.
        • 클라이언트 ID, 테넌트 ID, 리디렉션 URI 및 클라이언트 비밀 필드의 경우, Azure portal의 계정에 제공된 정보를 입력하십시오.
        • 연결 테스트: 연결 테스트를 클릭하여 계정에 로그인하고, 인증을 위한 요청 권한을 수락하고, 서버와의 연결을 설정합니다.
          주:
          • 데스크톱 작업을 수행하고 연결 테스트를 클릭하면 변수(자격증명, 자격증명 변수 또는 문자열 변수)가 현재 지원되지 않습니다.
          • 데스크톱 작업을 수행하고 연결 테스트를 클릭하여 계정에 로그인하는 경우 다음 리디렉션 URI를 추가합니다. https://outlook.office365.com
        사용자 이름, 비밀번호, 테넌트 ID, 클라이언트 ID, 클라이언트 비밀 필드의 경우 자격증명, 변수 또는 안전하지 않은 문자열 탭 중에서 선택합니다.
        • 자격증명: 자격증명 저장소에 있는 사용 가능한 값을 사용합니다.
        • 변수: 값을 저장하는 사용자 정의 변수를 사용합니다.
        • 안전하지 않은 문자열: 수동으로 값을 입력합니다.
  4. 저장을 클릭합니다.