Microsoft 365 커넥터 및 사용자 지정 커넥터 관리

아티클
11/05/2024
적용 대상:

Microsoft Teams

Microsoft Teams의 커넥터는 타사 서비스에서 Teams 채널로 직접 콘텐츠 및 서비스 업데이트를 제공합니다. 커넥터를 사용하면 사용자는 Azure DevOps Services, Trello, Wunderlist, GitHub 등과 같은 인기 있는 서비스에서 업데이트를 받을 수 있습니다. 커넥터는 이러한 업데이트를 채팅 스트림에 직접 게시합니다. 이 기능을 사용하면 모든 팀 구성원이 동기화 상태를 유지하고 관련 정보를 빠르게 받을 수 있습니다.

Teams 및 Microsoft 365 그룹은 커넥터를 사용합니다. Teams 및 Microsoft Exchange에서 동일한 커넥터를 사용할 수 있습니다.

팀 권한이 허용하는 경우 모든 팀 구성원이 채널에 커넥터를 추가할 수 있습니다. 커넥터가 정보를 가져오는 서비스의 업데이트는 모든 팀 구성원에게 알 수 있습니다. 추가 또는 제거할 수 있는 권한이 있는 모든 팀 구성원은 다른 멤버가 수행한 커넥터 설정을 수정할 수 있습니다.

중요

개발자는 커넥터 개발자 포털에서 새 커넥터를 등록할 수 없습니다.

커넥터 URL 업데이트

Teams 커넥터는 보안을 강화하기 위해 새 URL로 전환하고 있습니다 . 이 전환 중에 새 URL을 사용하도록 구성된 커넥터를 업데이트하라는 알림을 받을 수 있습니다. 커넥터 서비스의 중단을 방지하기 위해 커넥터를 즉시 업데이트하는 것이 좋습니다.

이 변경은 들어오는 웹후크 및 타사 커넥터와 같은 웹후크 기반 커넥터에만 필요합니다. RSS와 같은 폴링 커넥터에는 변경이 필요하지 않습니다. 2024년 12월 31일 이후에 Teams에 알림을 계속 게시하려면 커넥터의 URL을 업데이트해야 합니다.

팁

업데이트하는 URL을 적어 두는 것이 좋습니다. 업데이트된 후에는 이전 URL을 더 이상 볼 수 없습니다. 이전 URL은 새 URL로 업데이트해야 하는 여전히 시스템을 찾고 식별하는 데 유용할 수 있습니다.

URL을 업데이트하려면 다음 단계를 수행합니다.

Teams 채널에서 채널 관리 로 이동하여 커넥터 옵션에서 편집 을 선택하고 구성됨 섹션을 선택합니다. 이 페이지에서 기존 커넥터 연결을 확인합니다.
관리 옵션 아래에 표시되는 Attention required 연결만 업데이트합니다.
다음 중 하나를 수행합니다.
- 웹후크 URL이 포함된 커넥터의 경우 URL 관리 및 업데이트를 선택합니다.
- 다른 유형의 커넥터의 경우 커넥터를 제거하고 커넥터 구성을 다시 만듭니다.
이전 URL에 게시한 시스템에서 업데이트된 URL 또는 새 연결을 사용합니다. 구성 페이지에는 URL이 업데이트됨이 표시됩니다.

자세한 내용을 알아보거나 앱 개발자와 자세한 정보를 공유하려면 커넥터 사용 중단 정보를 참조하세요.

Teams에서 커넥터 활성화 또는 비활성화

Exchange Online PowerShell v2 모듈은 최신 인증을 사용하고 MFA(다단계 인증)와 함께 작동하여 Microsoft 365의 모든 Exchange 관련 PowerShell 환경에 연결합니다. 관리자는 Exchange Online PowerShell을 사용하여 전체 organization 또는 특정 그룹 사서함에 대한 커넥터를 사용하지 않도록 설정할 수 있습니다. 커넥터를 사용하지 않도록 설정하면 해당 조직 또는 사서함의 모든 사용자에게 영향을 줍니다. 일부 특정 사용자에 대해 커넥터를 사용하지 않도록 설정할 수 없습니다.

organization 설정은 그룹 설정을 재정의합니다. 예를 들어 관리자가 그룹에 대해 커넥터를 사용하도록 설정하고 organization 동일한 커넥터를 사용하지 않도록 설정하면 그룹에 대해 커넥터가 비활성화됩니다. Teams에서 커넥터를 활성화하려면 MFA가 있거나 없는 최신 인증을 사용하여 Exchange Online PowerShell에 연결합니다.

커넥터를 사용하거나 사용하지 않도록 설정하려면 Microsoft Exchange Online PowerShell에서 다음 명령을 실행합니다.

관리자 권한으로 PowerShell을 엽니다.
명령을 Import-Module ExchangeOnlineManagement 사용하여 Microsoft Exchange 모듈을 가져옵니다.
organization 커넥터를 사용하지 않도록 설정하려면 명령을 Set-OrganizationConfig -ConnectorsEnabled:$false사용합니다.
관리자 계정을 연결하려면 명령을 Connect-ExchangeOnline -UserPrincipalName UPN -ExchangeEnvironmentName O365USGovGCCHigh사용합니다. 을 사용자 계정 이름으로 대체 UPN 합니다.
Teams에 커넥터를 사용하도록 설정하려면 다음 명령을 사용합니다. 커넥터 또는 실행 가능한 메시지를 사용하지 않도록 설정하려면 다음 명령 대신 true 값을 false 로 설정합니다.
- Set-OrganizationConfig -ConnectorsEnabled:$true
- Set-OrganizationConfig -ConnectorsEnabledForTeams:$true
- Set-OrganizationConfig -ConnectorsActionableMessagesEnabled:$true

PowerShell 모듈 교환에 대한 자세한 내용은 Set-OrganizationConfig를 참조하세요. Outlook 커넥터를 활성화하거나 비활성화하려면 Microsoft Outlook에서 앱을 그룹에 연결하세요. UPN(사용자 계정 이름)에 대한 자세한 내용은 Microsoft 365의 UPN이란?을 참조하세요.

참고

이러한 변경 내용이 전파되기까지 최대 24시간이 걸립니다.

조직의 커넥터 게시

조직의 사용자가 사용자 지정 커넥터를 사용할 수 있도록 하려면 조직의 앱 카탈로그에 사용자 지정 커넥터 앱을 업로드합니다. 조직 내 사용자는 팀에서 커넥터를 설치, 구성 및 사용할 수 있습니다.

중요

GCC(Government Community Cloud), GCCH(Government Community Cloud-High) 및 DOD(국방부) 환경에서는 사용자 지정 커넥터를 사용할 수 없습니다.

팀 또는 채널에서 커넥터를 사용하려면 채널의 오른쪽 상단에서 추가 옵션 메뉴를 엽니다. 메뉴에서 커넥터를 선택한 다음 필요한 커넥터를 찾거나 검색합니다. 필요한 경우 선택한 커넥터를 구성합니다.

채널의 오른쪽 위 모서리에 있는 기타 옵션에서 Teams의 채널에 커넥터 추가를 보여 주는 스크린샷

GCC 또는 GCCH에서 커넥터 사용

커넥터는 기본적으로 GCC(정부 클라우드 커뮤니티) 및 GCCH(정부 커뮤니티 Cloud-High) 환경에서 사용하지 않도록 설정됩니다. 사용자가 GCC 또는 GCCH 환경에서 커넥터를 사용할 수 있도록 하려면 다음 단계를 수행합니다.

Teams에서 커넥터를 사용하도록 설정해야 합니다.
매개 변수를 설정하려면 Exchange Online PowerShell에 연결합니다.

Teams에서 들어오는 웹후크를 사용하려면 다음 manifest.json을 사용하여 사용자 지정 앱을 만듭니다. 사용자 지정 앱에서 아이콘을 사용하려면 지침에 따라 앱 아이콘을 만듭니다.

{
  "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.5/MicrosoftTeams.schema.json",
  "manifestVersion": "1.5",
  "id": "203a1e2c-26cc-47ca-83ae-be98f960b6b2",
  "version": "1.0.0",
  "packageName": "com.incomingwebhook.microsoft",
  "developer": {
    "name": "Microsoft Corporation",
    "websiteUrl": "https://go.microsoft.com/fwlink/?linkid=837668",
    "privacyUrl": "https://privacy.microsoft.com/privacystatement",
    "termsOfUseUrl": "https://www.microsoft.com/servicesagreement"
  },
  "description": {
    "full": "The Incoming Webhook connector enables external services to notify you about activities that you want to track.",
    "short": "Send data from a service to your Microsoft 365 group in real time. "
  },
  "icons": {
    "outline": "outline.png",
    "color": "color.png"
  },
  "connectors": [
    {
      "connectorId": "203a1e2c-26cc-47ca-83ae-be98f960b6b2",
      "scopes": ["team"]
    }
  ],
  "name": {
    "full": "Incoming Webhook",
    "short": "Incoming Webhook"
  },
  "accentColor": "#FFFFFF",
  "permissions": ["identity", "messageTeamMembers"]
}

Teams 관리 센터에서 사용자 지정 앱을 업로드합니다.

Teams에서 커넥터를 사용할 때 고려 사항

커넥터는 기본적으로 GCC(정부 클라우드 커뮤니티) 환경 및 GCCH(정부 커뮤니티 Cloud-High)에서 사용하지 않도록 설정됩니다. 커넥터를 사용하도록 설정하려면 cmdlet을 사용하여 ConnectorsEnabled 또는 ConnectorsEnabledForTeams 매개 변수 $true 를 로 SetOrganizationConfig 설정합니다. 매개 변수를 설정하려면 Exchange Online PowerShell에 연결합니다.
팀에 커넥터를 추가한 사용자가 팀을 떠나는 경우 커넥터는 계속 작동합니다.
다음 커넥터에 대한 새 연결을 구성할 수 없습니다.
- 아하!
- 에어브레이크 (동음이의)
- Aircall
- 앱 링크
- AppSignal
- 빈스토크 (은)
- Bitbucket
- 동료
- Buildkite
- 고양이
- Chatra
- CircleCI
- CodeShip
- 상수 접촉
- GetResponse
- 유령 검사기
- 홈
- Heroku
- Honeybadger
- 인터폰
- 로그 엔트리
- Mailchimp
- Microsoft Forms
- Opsgenie
- PagerDuty
- 페이퍼트레일
- 피벗 추적기
- 레이건 주
- 런스코프
- SatisMeter
- 세마포
- 보초
- 단순 인/아웃
- Stack Exchange
- SUBVERSION
- TestFairy
- Travis CI
- Trello
- 업토다운(Uptodown)
- Userlike
- Wrike
- XP-Dev
- Zendesk

다음을 통해 공유

Microsoft 365 커넥터 및 사용자 지정 커넥터 관리

커넥터 URL 업데이트

Teams에서 커넥터 활성화 또는 비활성화

조직의 커넥터 게시

GCC 또는 GCCH에서 커넥터 사용

Teams에서 커넥터를 사용할 때 고려 사항

피드백

추가 리소스

다음을 통해 공유

Microsoft 365 커넥터 및 사용자 지정 커넥터 관리

커넥터 URL 업데이트

Teams에서 커넥터 활성화 또는 비활성화

조직의 커넥터 게시

GCC 또는 GCCH에서 커넥터 사용

Teams에서 커넥터를 사용할 때 고려 사항

관련 기사

피드백

추가 리소스