Teams 앱 제출 API를 사용하여 제출된 사용자 지정 앱 게시
이 문서에서는 Teams 앱을 개발에서 배포, 검색으로 수행하는 방법에 대한 엔드 투 엔드 지침을 제공합니다. 조직의 앱 스토어에서 사용자 지정 앱을 개발, 배포 및 관리하는 방법을 간소화하기 위해 Teams가 앱 수명 주기 전반에 걸쳐 제공하는 연결된 환경에 대한 개요를 확인할 수 있습니다.
개발자가 Teams 앱 제출 API를 사용하여 검토 및 승인할 수 있도록 Microsoft Teams 관리 센터에 직접 사용자 지정 앱을 제출하는 방법, 조직의 사용자를 위한 앱을 관리하는 정책을 설정하는 방법, 사용자가 Teams에서 앱을 검색하는 방법을 포함하여 수명 주기의 각 단계를 다룹니다.
이 지침은 앱의 Teams 측면에 중점을 두고 있으며 관리자 및 IT 전문가를 위한 것입니다. Teams 앱 개발에 대한 자세한 내용은 Teams 개발자 설명서를 참조하세요.
참고
사용자 지정 Teams 앱을 게시하면 조직의 앱 스토어에 있는 사용자가 사용할 수 있습니다. 사용자 지정 앱을 게시하는 방법에는 두 가지가 있으며, 사용하는 방법은 앱을 가져오는 방법에 따라 달라집니다. 이 문서에서는 개발자가 Teams 앱 제출 API를 통해 제출하는 사용자 지정 앱을 승인하고 게시하는 방법에 중점을 둡니다. 사용자 지정 앱을 업로드하는 다른 방법은 개발자가 .zip 형식으로 앱 패키지를 보낼 때 사용됩니다. 해당 메서드에 대한 자세한 내용은 앱 패키지를 업로드하여 사용자 지정 앱 게시를 참조하세요. 승인 앱 위젯은 GCC 테넌트에서 사용할 수 없습니다.
중요
이 메서드는 현재 GCC 환경에서 사용할 수 없습니다. GCC에서 사용자 지정 앱 업로드 메서드를 사용합니다.
개발
앱 만들기
Microsoft Teams 개발자 플랫폼을 사용하면 개발자가 사용자 고유의 앱과 서비스를 쉽게 통합하여 생산성을 향상시키고, 의사 결정을 더 빠르게 내리고, 기존 콘텐츠 및 워크플로를 중심으로 공동 작업을 만들 수 있습니다. Teams 플랫폼에서 빌드된 앱은 Teams 클라이언트와 서비스 및 워크플로 간의 브리지로, 협업 플랫폼의 컨텍스트로 직접 연결됩니다. 자세한 내용은 Teams 개발자 설명서를 참조하세요.
앱 제출
앱이 프로덕션에서 사용할 준비가 되면 개발자는 teams 앱 제출 API를 사용하여 앱을 제출할 수 있습니다. 이 API는 Graph API, Visual Studio Code 같은 IDE(통합 개발 환경) 또는 Power Apps 및 Power Virtual Agents와 같은 플랫폼에서 호출할 수 있습니다. 이렇게 하면 Teams 관리 센터의 앱 관리 페이지에서 앱을 검토하고 승인할 수 있습니다.
Microsoft Graph를 기반으로 하는 Teams 앱 제출 API를 사용하면 조직이 원하는 플랫폼에서 개발할 수 있으며 Teams의 사용자 지정 앱에 대한 제출-승인 프로세스를 자동화할 수 있습니다.
다음은 Visual Studio Code 이 앱 제출 단계의 예입니다.
아직 조직의 앱 스토어에 앱을 게시하지 않는다는 점에 유의하세요. 이 단계에서는 조직의 앱 스토어에 게시하도록 승인할 수 있는 Teams 관리 센터에 앱을 제출합니다.
Graph API 사용하여 앱을 제출하는 방법에 대한 자세한 내용은 여기를 참조하세요.
알림
개발자가 검토 및 승인을 위해 새 애플리케이션을 제출할 때 알 수 있도록 알림을 켤 수 있습니다. 개발자가 앱 업데이트를 제출할 때도 알림이 표시됩니다. Teams 관리 센터에서 앱 제출 알림을 사용하도록 설정하려면 알림 & 경고 > 규칙 > 앱 제출 로 이동하고 상태를 활성 으로 변경하여 규칙을 활성화합니다. 기본적으로 이 설정은 꺼져 잇습니다. 이 설정을 켜려면 전역 관리자 또는 Teams 관리자여야 합니다.
이 설정을 켜면 관리 경고 및 알림 팀에서 앱 제출이라는 새 채널 아래에 알림 이 표시됩니다. 또는 기존 팀과 채널을 선택하여 지정된 팀 및 채널에 알림을 전달할 수 있습니다. 다음의 단계를 따릅니다:
앱 제출 규칙의 작업 에서 채널 경고 확인란을 선택합니다.
채널 선택 단추를 선택합니다.
추가할 팀을 검색합니다.
추가할 채널을 검색합니다.
적용 을 선택합니다.
참고
앱 제출 채널의 관리 경고 및 알림 팀에 알림을 받으려면 기본 채널 경고 확인란 을 선택합니다.
웹후크 확인란을 선택한 후 공용 웹후크 URL을 지정하여 외부 웹 후크 에 대한 알림을 설정할 수도 있습니다. JSON 알림 페이로드가 웹후크 URL로 전송됩니다.
앱 제출 규칙을 설정한 후 지정된 채널의 알림 카드를 검토하여 앱 세부 정보를 확인하고 세부 정보 보기를 선택하여 Teams 관리 센터에서 앱을 열 수 있습니다.
확인
Teams 관리 센터의 앱 관리 페이지(왼쪽 탐색에서 Teams 앱****관리 앱 > 으로 이동)는 조직의 모든 Teams 앱에 대한 보기를 제공합니다. 페이지 맨 위에 있는 보류 중인 승인 위젯은 사용자 지정 앱이 승인을 위해 제출되는 시기를 알 수 있습니다.
표에서 새로 제출된 앱은 제출됨 및 차단 상태의 게시 상태를 자동으로 표시합니다. 게시 상태 열을 내림차순으로 정렬하여 앱을 빠르게 찾을 수 있습니다.
앱 이름을 클릭하여 앱 세부 정보 페이지로 이동합니다. 정보 탭에서 설명, 상태, 제출자 및 앱 ID를 포함하여 앱에 대한 세부 정보를 볼 수 있습니다.
Graph API 사용하여 게시 상태를 확인하는 방법에 대한 자세한 내용은 여기를 참조 하세요.
게시
사용자가 앱을 사용할 수 있도록 할 준비가 되면 앱을 게시합니다.
Teams 관리 센터에 로그인하고 Teams 앱**관리 앱** > 으로 이동합니다.
앱 이름을 선택하여 앱 세부 정보 페이지로 이동한 다음 게시 상태 상자에서 게시 를 선택합니다.
앱을 게시한 후 게시 상태가 게시됨 으로 변경되고 상태가 허용됨으로 변경 됩니다.
설정 및 관리
앱에 대한 액세스 제어
기본적으로 조직의 모든 사용자는 조직의 앱 스토어에서 앱에 액세스할 수 있습니다. 앱을 사용할 수 있는 권한이 있는 사용자를 제한하고 제어하려면 앱 사용 권한 정책을 만들고 할당할 수 있습니다. 자세한 내용은 Teams에서 앱 권한 정책 관리를 참조하세요.
사용자가 검색할 수 있도록 앱 고정 및 설치
기본적으로 사용자가 조직의 앱 스토어로 이동하여 앱을 찾아보거나 검색해야 하는 앱을 찾습니다. 사용자가 앱에 쉽게 액세스하도록 하려면 Teams의 앱 표시줄에 앱을 고정할 수 있습니다. 이렇게 하려면 앱 설정 정책을 만들고 사용자에게 할당합니다. 자세한 내용은 Teams에서 앱 설정 정책 관리를 참조하세요.
Teams 앱 이벤트에 대한 감사 로그 검색
감사 로그를 검색하여 조직에서 Teams 앱 활동을 볼 수 있습니다. 감사 로그를 검색하고 감사 로그에 기록된 Teams 활동 목록을 확인하는 방법에 대한 자세한 내용은 Teams의 이벤트에 대한 감사 로그 검색을 참조하세요.
감사 로그를 검색하려면 먼저 보안 및 준수 센터에서 감사를 켜야 합니다. 자세한 내용은 감사 로그 검색 설정 및 해제를 참조하세요. 감사 데이터는 감사가 켜진 시점부터만 사용할 수 있습니다.
검색 및 채택
앱에 대한 권한이 있는 사용자는 조직의 앱 스토어에서 앱을 찾을 수 있습니다. 앱 페이지에서 조직 이름 에 맞게 빌드 된 앱으로 이동하여 조직의 사용자 지정 앱을 찾습니다.
앱 설정 정책을 만들고 할당한 경우 정책이 할당된 사용자에게 쉽게 액세스할 수 있도록 앱이 Teams의 앱 표시줄에 고정됩니다.
업데이트
앱을 업데이트하려면 개발자가 개발 섹션의 단계를 계속 따라야 합니다.
개발자가 게시된 사용자 지정 앱에 업데이트를 제출하면 앱 관리 페이지의 보류 중인 승인 위젯에 알림이 표시됩니다. 표에서 앱의 게시 상태는 제출된 업데이트 로 설정됩니다. 또한 앱 제출 알림을 설정한 경우 앱 제출 채널 아래의 관리 경고 및 알림 팀에 알림이 표시됩니다. 알림 카드에는 Teams 관리 센터의 앱으로 직접 연결되는 링크가 있습니다. 앱 제출 알림을 설정하는 방법에 대한 자세한 내용은 알림을 참조하세요.
앱 업데이트를 검토하고 게시하려면 다음을 수행합니다.
Teams 관리 센터의 왼쪽 탐색 영역에서 Teams 앱****관리 앱 > 으로 이동합니다.
앱 이름을 클릭하여 앱 세부 정보 페이지로 이동한 다음 업데이트 세부 정보를 검토할 수 있는 업데이트를 선택합니다.
준비가 되면 게시 를 선택하여 업데이트를 게시합니다. 이렇게 하면 기존 앱이 대체되고 버전 번호가 업데이트되며 게시 상태가 게시됨 으로 변경됩니다. 모든 앱 권한 정책 및 앱 설정 정책은 업데이트된 앱에 계속 적용됩니다.
업데이트를 거부하면 이전 버전의 앱이 게시된 상태로 유지됩니다.
다음 사항에 유의하세요.
- 앱이 승인되면 누구나 앱에 업데이트를 제출할 수 있습니다. 즉, 원래 앱을 제출한 개발자를 비롯한 다른 개발자가 앱에 업데이트를 제출할 수 있습니다.
- 개발자가 앱을 제출하고 요청이 보류 중인 경우 동일한 개발자만 앱에 업데이트를 제출할 수 있습니다. 다른 개발자는 앱이 승인된 후에만 업데이트를 제출할 수 있습니다.
Graph API 사용하여 앱을 업데이트하는 방법에 대한 자세한 내용은 여기를 참조하세요.