Microsoft Exchange Online 스포크
Microsoft Exchange Online 스포크는 Microsoft Exchange Online에서 달력과 메일을 생성하고 관리합니다. 사용자 및 그룹을 생성, 관리 또는 삭제하려면 Microsoft Azure AD 스포크를 사용합니다.
스토어에서 앱 요청
ServiceNow Store 웹 사이트를 방문하면 사용 가능한 모든 앱을 확인하고 스토어에 요청을 제출하는 방법에 대한 정보를 참조할 수 있습니다. 출시된 모든 앱의 누적 릴리스 정보는 ServiceNow Store 버전 기록 릴리스 정보를 참조하십시오.
Integration Hub 구독
이 스포크는 Integration Hub 구독이 필요합니다. 자세한 내용은 법무 일정 - 통합 허브 개요를 참조하십시오.
스포크 버전
Microsoft Exchange Online 스포크 v3.7.1 이 최신 버전입니다.
스포크 종속성
앱을 설치하는 데 문제가 있는 경우 다음 종속 플러그인이 설치되어 있는지 확인합니다.
- ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
- ServiceNow 통합 허브 런타임(com.glide.hub.integration.runtime)
- ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
- Complex Object (com.glide.cobject)
- ServiceNow 통합 허브 작업 템플릿 - 데이터 스트림(com.glide.hub.action_type.datastream)
- 원격 테이블(com.glide.script.vtable)
- 시스템 임포트 데이터 소스(com.glide.system_import_data_source)
- iHub 스포크 유틸리티 팩(com.snc.ihub_spoke_util_pack)
지원되는 버전
Microsoft 그래프 REST API v1.0
스포크 모듈
| 모듈 | 설명 |
|---|---|
| 이벤트 | Microsoft Exchange Online의 이벤트 목록을 표시합니다. |
| 구독 | Microsoft Exchange Online의 구독 목록을 표시합니다. |
| 웹후크 레지스트리 | Microsoft Exchange Online의 웹후크 레지스트리 목록을 표시합니다. |
| 달력 | Microsoft Exchange Online의 달력 목록을 표시합니다. |
| 달력 이벤트 데이터 변환 | 데이터 소스의 기록 목록을 표시합니다. |
스포크 플로우
| 플로우 | 설명 |
|---|---|
| 구독 갱신 | 모든 구독 기록을 조회하고 갱신이 필요한 경우 만료 시간을 기준으로 구독을 갱신합니다. 구독 상태가 '삭제 중'으로 표시된 경우 해당 기록이 삭제되고 갱신이 고려되지 않습니다. |
스포크 하위 플로우
| 범주 | 하위 플로우 | 설명 |
|---|---|---|
| 웹후크 관리 | 이벤트 구독 확인 | 지정된 이벤트 자원 또는 알림 URL 및 변경 유형이 있는 웹후크 구독이 있는지 확인합니다. |
| 구독 기록 작성 또는 업데이트 | 지정된 구독 기록이 Microsoft Exchange Online에 있는지 확인하고 구독 기록이 있으면 업데이트합니다. 구독 기록이 없으면 새 구독 기록이 만들어집니다. | |
| 자원에 대한 구독 작성 또는 업데이트 | 지정된 자원에 대한 구독을 확인합니다. 지정된 리소스에 대한 구독이 없으면 새 구독이 만들어집니다. 주: 이 하위 플로우는 플러그인이 워크플레이스 달력 동기화 이미 설치된 경우에만 사용할 수 있습니다. |
|
| 구독 삭제 | 지정된 구독이 지정된 애플리케이션과만 관련된 경우 지정된 구독을 삭제합니다. | |
| 제거된 구독 다시 만들기 | 관련 구독 기록의 상세 정보를 사용하여 제거된 웹후크 구독을 다시 만듭니다. | |
| 구독 수명주기 관리 | 웹후크 구독의 수명주기를 관리합니다. | |
| 달력 관리 | 달력 동기화 | Exchange Online 달력 이벤트 변환 데이터 테이블에서 이벤트를 검색하고 검색된 이벤트를 이벤트 테이블에 추가하여 달력을 동기화합니다 Microsoft Exchange Online . 사용자의 지정된 달력에 유효한 구독이 없는 경우 구독을 생성합니다. |
| 이벤트 기록 작성 또는 업데이트 | 특정한 기존 이벤트 기록과 업데이트를 확인하고 지정된 속성으로 업데이트합니다. 지정된 이벤트 기록이 없으면 새 이벤트 기록이 만들어집니다. | |
| 달력 일정 이벤트 삭제 | Microsoft Exchange Online에서 지정된 이벤트와 이벤트 테이블에서 관련 기록, 관련 첨부 파일, 이벤트 참석자의 관련 기록 및 이벤트에서 구독 m2m 테이블로 관련 기록을 삭제합니다. | |
| 이벤트 기록 삭제 | 이벤트 테이블 및 관련 첨부 파일에서 지정된 이벤트 기록, 이벤트 참석자의 관련 기록, 이벤트에서 구독 m2m 테이블로 관련 기록을 삭제합니다. | |
| 이벤트 수명주기 관리 | 이벤트 상세 정보를 검색하고 그에 따라 이벤트, 참석자, 이벤트의 기록을 구독 M2M 테이블로 업데이트합니다. | |
| 첨부 파일을 조회하여 이벤트 기록으로 업데이트 | Microsoft Exchange Online에서 특정 이벤트 기록의 첨부 파일을 검색하고 업데이트합니다. | |
| 달력 일정 변경 조회 및 업데이트 | 지정된 이벤트 기록의 이벤트 상세 정보를 검색하고 업데이트합니다. | |
| 이벤트 동기화 | Exchange Online 달력 이벤트 변환 데이터 테이블의 데이터를 기반으로 달력 뷰를 동기화합니다. | |
| 달력 일정 이벤트 업데이트 | Microsoft Exchange Online에 있는 이벤트 개체의 속성과 이벤트 테이블의 관련 기록을 업데이트합니다. |
- Microsoft Exchange Online 웹후크 레지스트리 테이블을 사용하여 콜백 URL을 생성하고 웹후크 구독에 대한 비밀 값(클라이언트 상태)을 저장합니다.
- 웹후크 구독이 상태 필드가 활성으로 설정된 Microsoft Exchange Online 구독 테이블에 저장되어 있는지 확인합니다.
스포크 작업
| 범주 | 작업 | 설명 |
|---|---|---|
| 달력 관리 | 첨부 파일을 달력 이벤트에 복사 | 첨부 파일을 달력 이벤트에 복사 ServiceNow 합니다 Exchange . |
| 달력 이벤트 작성 | 사용자의 기본 달력에 이벤트를 작성하고 이벤트의 시작 및 종료 시간의 시간대를 지정합니다. | |
| 재발하는 달력 이벤트 작성 | 사용자의 기본 달력에 되풀이 이벤트를 만들고 이벤트의 시작 및 종료 시간의 시간대를 지정합니다. | |
| 첨부 파일 제거 | 특정 이벤트에서 지정된 첨부 파일을 삭제합니다. | |
| 달력 이벤트 삭제 | 달력 이벤트를 삭제합니다. | |
| 모임 시간 찾기 | 지정된 시간과 위치에 대한 회의 이끌이와 참석자의 가용성을 기준으로 모임 시간과 위치를 조회합니다. | |
| 이벤트 ID로 첨부 파일 조회 | 지정한 이벤트의 모든 첨부 파일을 조회합니다. | |
| ID로 달력 검색 | 지정된 ID에 대한 달력 상세 정보를 조회합니다. | |
| 사용자 ID로 달력 이벤트 조회 | 사용자의 사서함에 있는 이벤트 객체의 목록을 조회합니다. | |
| 달력 뷰 스트림 조회 | 지정된 기간 동안 지정된 사용자 ID에 대한 회의 항목 목록을 조회합니다. | |
| 달력 스트림 조회 | 모든 사용자의 달력 상세 정보를 조회합니다. | |
| ID로 이벤트 조회 | 지정된 ID에 대한 달력 이벤트 상세 정보를 조회합니다. | |
| 일정 조회 | 일정 목록을 검색합니다. | |
| 부재중 설정 조회 | 지정된 수신자에 대한 부재중 설정의 상세 정보를 검색합니다. | |
| 시간대 조회 | 사용 가능한 모든 시간대의 세부 정보를 조회합니다. | |
| 달력 이벤트 업데이트 | 이벤트 개체의 속성을 업데이트합니다. | |
| 메일 관리 | 메시지 삭제 | 사용자의 받은 편지함 또는 사용자 지정 폴더에서 메시지를 삭제합니다. |
| 사용자 ID로 메일 폴더 조회 | 지정된 사용자 ID의 모든 메일 폴더를 검색합니다. | |
| 메일 폴더 ID로 메시지 조회 | 메일 폴더의 모든 메시지를 조회합니다. | |
| 사용자 ID로 메시지 조회 | 사용자의 받은 편지함 폴더에서 모든 메시지를 조회합니다. | |
| 메일 전송 | 메시지 제목과 메시지 본문이 있는 이메일을 지정된 수신자 목록에 보냅니다. | |
| 사서함 자동 회신 설정 | 지정된 기간 동안 사용자의 자동 회신 메시지를 설정합니다. | |
| 웹후크 관리 | ID로 구독 조회 | 지정된 ID에 대한 웹후크 구독의 상세 정보를 조회합니다. |
| 구독 스트림 조회 | 모든 웹후크 구독의 상세 정보를 조회합니다. | |
| 웹후크 구독 갱신 | 지정된 웹후크의 구독을 갱신합니다. | |
| 웹후크 구독 | 지정된 자원에 대한 웹후크 구독을 작성합니다. | |
| 웹후크 구독 취소 | 지정된 웹후크 구독을 삭제합니다. | |
| 사서함 관리 | 사서함 만들기 | 사서함과 사용자 계정을 동시에 만듭니다. |
| 사서함 삭제 | 사서함과 사용자 계정을 동시에 삭제하거나 비활성화합니다. | |
| 사서함 사용 | Microsoft Exchange Online에서 사서함을 사용하도록 설정합니다. 사서함은 보관된 상태일 수 있습니다. | |
| 사서함 조회 | 사서함 목록을 조회합니다. |
| 범주 | 작업 | 권한 유형 | 권한(최소 권한부터 최대 권한 권한까지) |
|---|---|---|---|
| 달력 관리 | 첨부 파일을 달력 이벤트에 복사 | 위임됨(회사 또는 학교 계정) | Calendars.ReadWrite |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadWrite | ||
| 애플리케이션 | Calendars.ReadWrite | ||
| 달력 이벤트 작성 | 위임됨(회사 또는 학교 계정) | Calendars.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadWrite | ||
| 애플리케이션 | Calendars.ReadWrite | ||
| 재발하는 달력 이벤트 작성 | 위임됨(회사 또는 학교 계정) | Calendars.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadWrite | ||
| 애플리케이션 | Calendars.ReadWrite | ||
| 첨부 파일 제거 | 위임됨(회사 또는 학교 계정) | Calendars.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadWrite | ||
| 애플리케이션 | Calendars.ReadWrite | ||
| 달력 이벤트 삭제 | 위임됨(회사 또는 학교 계정) | Calendars.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadWrite | ||
| 애플리케이션 | Calendars.ReadWrite | ||
| 모임 시간 찾기 | 위임됨(회사 또는 학교 계정) | 달력.읽기, 달력.읽기 쓰기 | |
| 위임됨(개인 Microsoft 계정) | 지원되지 않습니다. | ||
| 애플리케이션 | 지원되지 않습니다. | ||
| 이벤트 ID로 첨부 파일 조회 | 위임됨(회사 또는 학교 계정) | Calendars.Read | |
| 위임됨(개인 Microsoft 계정) | Calendars.Read | ||
| 애플리케이션 | Calendars.Read | ||
| ID로 달력 검색 | 위임됨(회사 또는 학교 계정) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | ||
| 애플리케이션 | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | ||
| 사용자 ID로 달력 이벤트 조회 | 위임됨(회사 또는 학교 계정) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | ||
| 애플리케이션 | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | ||
| 달력 뷰 스트림 조회 | 위임됨(회사 또는 학교 계정) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | ||
| 애플리케이션 | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | ||
| 달력 스트림 조회 | 위임됨(회사 또는 학교 계정) | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadBasic, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite | ||
| 애플리케이션 | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | ||
| ID로 이벤트 조회 | 위임됨(회사 또는 학교 계정) | Calendars.ReadBasic, 달력.읽기 | |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadBasic, 달력.읽기 | ||
| 애플리케이션 | Calendars.ReadBasic, 달력.읽기 | ||
| 일정 조회 | 위임됨(회사 또는 학교 계정) | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | 지원되지 않습니다. | ||
| 애플리케이션 | Calendars.ReadBasic, Calendars.Read, Calendars.ReadWrite | ||
| 부재중 설정 조회 | 위임됨(회사 또는 학교 계정) | Mail.Read, Mail.Read.Shared | |
| 위임됨(개인 Microsoft 계정) | 메일.읽기 | ||
| 애플리케이션 | 메일.읽기 | ||
| 시간대 조회 | 위임됨(회사 또는 학교 계정) | User.Read, User.ReadBasic.All | |
| 위임됨(개인 Microsoft 계정) | 사용자.읽기 | ||
| 애플리케이션 | 사용자.읽기.모두 | ||
| 달력 이벤트 업데이트 | 위임됨(회사 또는 학교 계정) | Calendars.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Calendars.ReadWrite | ||
| 애플리케이션 | Calendars.ReadWrite | ||
| 메일 관리 | 메시지 삭제 | 위임됨(회사 또는 학교 계정) | 메일.읽기쓰기 |
| 위임됨(개인 Microsoft 계정) | 메일.읽기쓰기 | ||
| 애플리케이션 | 메일.읽기쓰기 | ||
| 사용자 ID로 메일 폴더 조회 | 위임됨(회사 또는 학교 계정) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| 애플리케이션 | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| 메일 폴더 ID로 메시지 조회 | 위임됨(회사 또는 학교 계정) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| 애플리케이션 | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| 사용자 ID로 메시지 조회 | 위임됨(회사 또는 학교 계정) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| 애플리케이션 | Mail.ReadBasic, Mail.Read, Mail.ReadWrite | ||
| 메일 전송 | 위임됨(회사 또는 학교 계정) | 메일.보내기 | |
| 위임됨(개인 Microsoft 계정) | 메일.보내기 | ||
| 애플리케이션 | 메일.보내기 | ||
| 사서함 자동 회신 설정 | 위임됨(회사 또는 학교 계정) | MailboxSettings.ReadWrite | |
| 위임됨(개인 Microsoft 계정) | MailboxSettings.ReadWrite | ||
| 애플리케이션 | MailboxSettings.ReadWrite | ||
| 사서함 관리 | 사서함 만들기 | 이러한 작업은 powershell cmdlet을 사용하므로 API 권한이 필요하지 않습니다. | |
| 사서함 삭제 | |||
| 사서함 사용 | |||
| 사서함 조회 | |||
Microsoft 계정 요구 사항
Microsoft Exchange Online 스포크 OAuth 2.0 토큰을 생성하려면 Azure Portal을 Microsoft 사용하여 애플리케이션을 등록해야 합니다.
연결 및 자격 증명 별칭 요구 사항
Integration Hub는 별칭을 사용하여 연결 및 자격 증명 정보와 OAuth 자격 증명을 관리합니다. 별칭을 사용하면 여러 환경을 사용할 때 여러 자격 증명과 연결 정보 프로파일을 구성하지 않아도 됩니다. 연결 또는 자격 증명 정보가 변경되면 연결을 사용하는 작업을 업데이트할 필요가 없습니다.
스포크 설정에 대한 자세한 내용은 다음을 참조하십시오. Microsoft Exchange Online 스포크 설정.