Oauth2를 사용하여 Microsoft Graph API를 Tulip에 연결하기

Microsoft Graph API를 통해 사용자는 Teams, Outlook, Office Suite와 같은 Microsoft 앱과 인터페이스할 수 있습니다.

목적

이 문서를 사용하여 튤립 앱을 Teams, Office Suite 및 Outlook과 같은 Microsoft 365 제품과 통합하세요.

최초 설정

개요

MS Graph API를 사용하기 위한 적절한 인증 정보를 생성하려면 다음 단계를 완료해야 합니다:

:::(Info) (중요 참고:)이러한 단계 중 일부는 Microsoft Azure에서 고급 권한이 필요합니다. 계속하기 전에 사용자에게 Entra ID 애플리케이션을 등록 및 관리할 수 있는 충분한 권한이 있는지 확인하세요!:::

1. Microsoft Azure에 새 애플리케이션을 등록합니다.
2. 애플리케이션에 대한 새 클라이언트 비밀을 만들고 권한을 선언합니다.
3. 클라이언트 시크릿 및 관련 인증 정보를 Tulip Oauth2 커넥터 구성에 복사합니다.

자세히 보기: 최초 설정

1. Microsoft Azure에서 새 애플리케이션 등록하기

1. 웹 브라우저에서 portal.azure.com으로 이동합니다.
2. 조직의 자격 증명으로 로그인합니다.
3. Microsoft Entra ID를 선택합니다.
   1. 참고: 이전에는 Azure Active Directory로 알려졌으므로 이 옵션을 찾으려면 '기타 서비스'를 선택해야 할 수 있습니다.
4. 페이지 왼쪽의 메뉴에서 앱 등록을 선택합니다.
5. 새 등록을 선택하고 이름을 입력합니다.
6. 리디렉션 URI에서 웹이 선택되어 있는지 확인하고 다음 URL을 입력합니다: https://<튤립 인스턴스>/oauth-redirect-handler(예: sample.tulip.co의 리디렉션 URI는 https://sample.tulip.co/oauth-redirect-handler)입니다 .
7. 등록을 선택하여 Azure 앱을 만듭니다.

2. 필수 정보 기록

앱을 등록하면 새 Azure 앱의 구성 페이지로 이동합니다. 나중에 사용할 수 있도록 다음 정보를 메모장 또는 텍스트 파일에 복사합니다.1. 왼쪽 메뉴에서 개요를 선택하고 1. 애플리케이션(클라이언트) ID 및 2. 디렉토리(테넌트) ID를 기록합니다.2. 왼쪽 메뉴에서 API 권한을 선택합니다. 3. 애플리케이션 권한을 선택합니다. 4. Microsoft Graph를 선택하여 Tulip이 Graph API에 대해 가질 수 있는 모든 권한을 확인합니다.5. Tulip 커넥터에 부여할 권한을 선택합니다. 전체 권한 목록은 여기{target=_blank}에서 확인할 수 있습니다. 1. 참고 1: 권장 사항으로, ctrl/cmd + f를 사용하여 사용하려는 Microsoft 앱을 검색하세요. 예를 들어, '팀'을 검색하여 채널 및 채팅과 관련된 사용 권한을 찾습니다. 2. *참고 2: 이 가이드를 사용하여 Tulip 라이브러리 커넥터를 통합하는 경우, 커넥터가 작동하는 데 필요한 권한 목록은 관련 Tulip 기술 자료 문서에서 확인할 수 있습니다.*6. 선택한 모든 권한의 API/권한 이름 (예: Files.Read.All 또는 User.Read)을 기록합니다.

3. 인증 정보 생성

1. 앱의 Azure 구성 페이지 왼쪽에 있는 관리 메뉴에서 인증서 및 암호를 선택합니다.
2. 클라이언트 암호(0)를 선택합니다.
3. 새 클라이언트 비밀을 선택하고 새 비밀의 이름을 지정합니다.
4. 표시된 값을 복사합니다.

4. 튤립 커넥터에 인증 정보 추가하기

MS Graph API와 함께 사용하려는 튤립 커넥터의 구성 설정으로 이동합니다. 커넥터의 메인 페이지에서 오프라인 - 프로덕션 및 테스트 및 개발이라고 표시된 상자를 클릭하여 이 작업을 수행할 수 있습니다.

1. 헤더 편집을 선택합니다 .
2. 인증 아래에서 다음 중 하나를 선택합니다:
   1. 앱 사용자가 통합된 Tulip 앱을 실행할 때마다 MS 365에 로그인해야 하는 경우Oauth2(운영자 )를 선택합니다.
   2. 이 구성을 설정하거나 변경할 때만 Tulip이 MS 365에 인증해야 하는 경우Oauth2(서비스 계정), 그리고 이 로그인 정보를 Tulip 인스턴스의 모든 앱에 사용하세요.
3. 나머지 옵션에 대해서는 이전에 기록한 다음 정보를 입력합니다:
   1. 인증 코드 URL: https://login.microsoftonline.com/the 2.1.b/oauth2/v2.0/authorize단계의 디렉토리(테넌트) ID
   2. 액세스 토큰 URL: https://login.microsoftonline.com/the 2.1.b/oauth2/v2.0/token단계의 디렉터리(테넌트) ID
   3. 클라이언트 ID: 2.1.a 단계의 애플리케이션(클라이언트) ID
   4. 클라이언트 비밀: 3.4단계의 값입니다.
   5. 범위: 2.6단계에서 추가된 쉼표로 구분된 권한 이름 목록(예: Files.Read.All, User.Read)
4. 테스트를 선택하여 인증 방법을 테스트합니다.
5. 뒤로를 선택하여 커넥터 구성으로 돌아갑니다.
6. 마지막으로 연결 세부 정보 입력 화면에서 다음 정보를 입력합니다:
   1. 실행 대상: 달리 알 수 없는 경우 클라우드 커넥터 호스트를 선택합니다.
   2. 호스트: graph.microsoft.com
   3. 포트: 443(또는 비워 두기)TLS
   4. TLS: 예
7. 테스트를 선택하면 구성이 완료됩니다!

5. 예제

아래 동영상을 통해 위에 작성된 내용의 예시를 확인하세요.엑셀용 커넥터 설정 동영상: