외부 콘텐츠 인덱싱 구성 Microsoft Teams

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

    • 에 OAuth 2.0 애플리케이션을 Microsoft Entra 관리자 센터 등록하여 외부 콘텐츠 커넥터가 소스 시스템에 액세스할 Microsoft Teams 수 있도록 합니다Microsoft Teams.

    시작하기 전에

    Microsoft Entra 관리자 센터에서 조직에 대해 다음과 같은 자격 증명과 권한이 필요합니다.
    • 로그인 자격 증명
    • 애플리케이션 등록 권한
    • 애플리케이션에 API 권한을 추가할 수 있는 권한
    • 애플리케이션의 API 권한에 대한 관리자 동의를 부여할 수 있는 권한
    • 애플리케이션에 대한 인증서를 업로드할 수 있는 권한

    외부 콘텐츠 커넥터에 대한 공개/개인 키 쌍을 Microsoft Teams 만들고 DER로 인코딩된 이진 X.509 형식으로 공개 키 인증서를 추출해야 합니다. 공개/개인 키 쌍 생성 및 공개 키 인증서 추출에 대한 자세한 내용은 을 참조하십시오 외부 콘텐츠 커넥터에 대한 Microsoft Teams 공개/개인 키 쌍 만들기.

    필요한 역할: 없음

    이 태스크 정보

    Microsoft Teams 외부 콘텐츠 커넥터는 REST API를 Microsoft SharePoint 사용하여 Microsoft Graph 소스 시스템에서 콘텐츠를 Microsoft Teams 검색합니다.

    커넥터가 이러한 API를 통해 소스 시스템에 액세스할 Microsoft Teams 수 있도록 하려면 에서 Microsoft Entra 관리자 센터OAuth 2.0 애플리케이션을 구성해야 합니다. 커넥터 관리자는 이 Microsoft Entra 애플리케이션에서 복사한 설정을 사용하여 소스 시스템에 적절하게 연결하도록 외부 콘텐츠 커넥터를 Microsoft Teams 구성할 Microsoft Teams 수 있습니다.

    프로시저

    1. 에서 새 애플리케이션을 등록합니다 Microsoft Entra 관리자 센터.
      1. Microsoft Entra 관리자 센터 에 https://entra.microsoft.com/로그인합니다.
        주:
        Microsoft Teams 테넌트가 Microsoft 365 GCC 또는 GCC High 클라우드 또는 Microsoft 365 DoD 클라우드에 있는 경우 대신 에 https://entra.microsoft.us/ 로그인합니다.
      2. 선택 애플리케이션 > 앱 등록.
      3. 앱 등록 페이지에서 새 등록을 선택합니다.
        새 등록 링크가 있는 앱 등록 페이지 Microsoft Entra 관리자 센터 입니다.
      4. 애플리케이션 등록 양식의 다음 필드에 내용을 입력합니다.
        필드 지시사항
        이름 OAuth 2.0 애플리케이션의 고유한 이름을 입력합니다. 예를 들어 Microsoft Teams 외부 콘텐츠 커넥터를 입력할 수 있습니다.
        지원되는 계정 유형 이 조직 디렉터리의 계정만 선택합니다(<instance-name>만 - 단일 테넌트). 여기서 <instance-name>은 인스턴스 Microsoft Entra 의 이름입니다.
        리디렉션 URI(선택 사항) 이 필드를 비워 둡니다.
        의 Microsoft Entra 관리자 센터애플리케이션 등록 대화 상자 .
      5. 등록을 선택합니다.
        새 애플리케이션의 개요 페이지가 나타납니다.
    2. 애플리케이션(클라이언트) ID 및 디렉터리(테넌트) ID 속성의 값을 안전한 위치에 기록합니다.
      애플리케이션/클라이언트 및 디렉터리/테넌트 ID 값을 표시하는 애플리케이션의 개요 페이지 Microsoft Entra 관리자 센터 입니다.
      중요사항:
      커넥터 관리자는 외부 콘텐츠 커넥터를 구성 Microsoft Teams 하기 위해 애플리케이션의 테넌트와 클라이언트 ID가 필요합니다.
    3. 외부 콘텐츠 커넥터에 Microsoft Teams 필요한 API 권한을 추가합니다.
      1. 애플리케이션 메뉴에서 관리 > API 권한.
        권한 추가 링크가 있는 Microsoft Entra 관리자 센터 애플리케이션의 API 권한 목록입니다.
      2. 권한 추가를 선택한 다음, 을 선택한 Microsoft Graph다음, 애플리케이션 권한을 선택합니다.
        타일 표시 Microsoft Graph 의 Microsoft Entra 관리자 센터 API 권한 요청 대화 상자
      3. 다음의 각 권한에 대해 권한 선택 검색 필드에 권한 이름을 입력한 다음, 권한에 대한 옵션을 찾아 선택합니다.
        • 채널.기본읽기.모두
        • 채널 구성원.읽기.모두
        • 그룹 구성원.읽기.모두
        • 사이트.읽기.모두
        • Team.ReadBasic.All
        • 팀 구성원.읽기.모두
        • 사용자.읽기.모두
      4. 권한 추가를 선택합니다.
        새 Microsoft Graph 권한이 애플리케이션의 구성된 권한 목록에 나타납니다.
      5. 권한 추가를 선택한 다음, SharePoint를 선택한 다음, 애플리케이션 권한을 선택합니다.
        SharePoint 타일을 표시하는 API 권한 요청 대화 상자.Microsoft Entra 관리자 센터
      6. 권한 선택 검색 필드에 Sites.FullControl.All을 입력한 다음 권한에 대한 옵션을 찾아 선택합니다.
      7. 권한 추가를 선택합니다.
        새 SharePoint 권한이 애플리케이션의 구성된 권한 목록에 나타납니다.
      관리자 동의가 필요한 추가 권한을 표시하는 애플리케이션의 API 권한 목록입니다Microsoft Entra 관리자 센터.
    4. 추가된 API 권한에 대한 관리자 동의를 부여합니다.
      1. <instance-name>에 대한 관리자 동의 부여를 선택합니다. 여기서 <instance-name>은 인스턴스 Microsoft Entra 의 이름입니다.
      2. 관리자 동의 부여 확인 대화 상자에서 예를 선택합니다.
        관리자 동의가 부여된 추가된 권한을 표시하는 애플리케이션의 API 권한 목록입니다Microsoft Entra 관리자 센터.
      추가된 API 권한의 상태가 <instance-name>에 대해 부여됨으로 변경됩니다. 여기서 <instance-name> 은 인스턴스 Microsoft Entra 의 이름입니다.
    5. 외부 콘텐츠 커넥터에 대한 Microsoft Teams DER로 인코딩된 이진 X.509 형식 공개 키 인증서를 업로드합니다.
      1. Microsoft Entra 애플리케이션 메뉴에서 관리 > 인증서 및 비밀.
      2. 인증서를 선택한 다음, 인증서 업로드를 선택합니다.
        인증서 업로드 링크를 표시하는 애플리케이션의 인증서 및 비밀 페이지입니다Microsoft Entra 관리자 센터.
      3. 파일 선택을 선택하고 DER로 인코딩된 이진 X.509 형식 공개 키 인증서 파일을 찾은 다음, 해당 파일에 대한 설명을 입력합니다.
        의 Microsoft Entra 관리자 센터인증서 업로드 대화 상자.
      4. 추가를 선택합니다.
        DER로 인코딩된 이진 X.509 형식 공개 키 인증서가 인증서 목록에 나타납니다.
        주:
        인증서 목록에서 열 구분 기호를 끌어 전체 지문 SHA1 해시 값을 볼 수 있습니다.
      5. 16진수 형식으로 표시된 인증서의 지문 SHA1 해시를 복사하여 안전한 위치에 기록합니다.
        업로드된 인증서에 대한 지문 SHA1 해시 값을 표시하는 애플리케이션의 인증서 및 비밀 페이지 Microsoft Entra 관리자 센터 입니다.
        중요사항:
        커넥터 관리자는 외부 콘텐츠 커넥터를 구성하려면 DER 인코딩 이진 X.509 형식 공개 키 인증서의 SHA1 지문 해시(base64 인코딩 형식)Microsoft Teams가 필요합니다.
      6. 생성된 공개/개인 키 파일 및 키 암호의 복사본을 안전한 위치에 보관합니다.
        주:
        에서 공개 키 인증서 또는 해당 암호를 Microsoft Entra 관리자 센터다운로드할 수 없습니다.

    다음에 수행할 작업

    커넥터 관리자에게 다음 항목을 제공합니다.
    • 단계에서 2기록한 OAuth 2.0 애플리케이션의 테넌트 ID 및 클라이언트 ID입니다.
    • DER 인코딩 이진 X.509 형식 공개 키 인증서의 SHA1 지문 해시(16진수 형식)는 단계를 기록했습니다.5.e

    커넥터 관리자는 인스턴스에서 검색 가능한 콘텐츠와 보안 주체를 검색하도록 외부 콘텐츠 커넥터를 Microsoft Teams 구성하려면 이러한 항목이 Microsoft Teams 필요합니다.

    외부 콘텐츠 커넥터 만들기 및 구성에 Microsoft Teams 대한 자세한 내용은 을 참조하십시오 Microsoft Teams 외부 콘텐츠 커넥터 생성.