Microsoft Teams 에 연결

Microsoft Teams 원격 팀이 정보를 공유하고 협업할 수 있는 공통 플랫폼을 제공하는 채팅 기반 도구입니다.

Microsoft Teams 와 IBM watsonx Orchestrate 를 연동하려면, 두 시스템이 원활하게 통신할 수 있도록 보안 연결을 설정해야 합니다. 통합 관리에 대한 일반적인 안내는 ‘사전 구축된 에이전트용 앱 연결’을 참조하세요.

중요:

기본적으로 해당 앱에서는 SSO(단일 로그인) 기능이 비활성화되어 있습니다. 이 기능을 활성화하려면 ‘애플리케이션에 대한 싱글 사인온 구성’을 참조하십시오.

연결 방법

Microsoft Teams 를 watsonx Orchestrate 에 연결하려면 다음 단계를 따르세요:

관리 > 연결 로 이동하여 해당 Microsoft Teams 연결 ID 를 검색하십시오.
일치하는 연결 ID 옆의 수정을 클릭합니다.
조직에서 사용하는 인증 방법을 선택하십시오( OAuth2.0, Multi Auth 또는 Key Value Pair ).
Microsoft Teams 전용 필드를 입력하세요. 일반적인 연결 절차에 대해서는 ‘사전 구축된 에이전트를 위한 앱 연결 ’ 페이지를 참조하십시오.
초안 및 라이브 설정 단계를 완료하십시오.
저장하고 연결을 테스트하여 성공적인 연결을 확인하십시오.

지원되는 인증 방법

Microsoft Teams watsonx Orchestrate 에서는 다음 인증 유형을 지원합니다:

OAuth2 인증 코드 : 프로덕션 연결에 권장됨
다중 인증 : OAuth2 인증 코드 방식과 OAuth2 클라이언트 자격 증명 방식을 모두 지원합니다
키-값 쌍 : API 키 기반 및 레거시 시나리오에서 지원됨

참고:

2025년 9월 이후에 생성된 에이전트의 경우, Microsoft Teams 에서는 OAuth 2.0 방식의 인증만 지원됩니다.

연결 ID

연결 설정 페이지에서 Microsoft Teams 연결을 찾을 때 다음 연결 ID를 사용하십시오. 연결 ID를 검색하고 편집을 위해 연결을 여는 방법을 이해하려면 사전 구축된 에이전트용 앱 연결을 참조하십시오.


인증 유형	연결 ID
OAuth2 인증 코드	```microsoft_oauth2_auth_code_ibm_184bdbd3```
다중 인증( OAuth2 인증 코드 및 OAuth2 클라이언트 자격 증명)	```microsoft_ibm_184bdbd3```
키/값 쌍	```microsoft_key_value_ibm_184bdbd3``` (사용 중단됨)

OAuth 2.0 연결 세부 정보

조직에서 OAuth 기반 인증을 사용하는 경우, 인증 유형을 ' OAuth2 인증 코드 '로 설정하고 다음 필드를 입력하십시오:


필드	설명
`Server URL`	예를 들어, Microsoft 서버의 기본 URL `https://graph.microsoft.com`
`Token URL`	인증 코드를 액세스 토큰으로 교환하기 위한 엔드포인트. 예: `https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/token`
`Scope`	오프라인 액세스를 지정하십시오. 요청되는 액세스 수준을 정의합니다. 다른 범위 항목을 공백으로 구분하여 포함할 수 있습니다. 예: `https://graph.microsoft.com/`
`Authorization URL`	URL 사용자가 로그인하고 접근 권한을 승인하도록 리디렉션되는 곳. 예: `https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/authorize`
`Client ID`	응용 프로그램의 고유 ID (Microsoft UI에서 사용 가능)
`Client Secret`	Microsoft에서 앱을 인증하는 데 사용되는 비밀 키

이 값들을 확인하려면 Microsoft API 설명서를 참조하십시오.

다중 인증 연결 세부 정보

인증 유형 을 ' OAuth2 인증 코드( Authorization Code) ' 또는 ' OAuth2 클라이언트 자격 증명( Client Credential) '으로 설정하고 다음 필드를 입력하십시오:

OAuth2 인증 코드


필드	설명
`server_url`	Microsoft Graphs API의 기본 URL 예: `https://graph.microsoft.com`
`token_url`	인증 코드를 액세스 토큰으로 교환하기 위한 엔드포인트. TENANT_ID를 귀하의 디렉터리(테넌트) ID로 대체하십시오. 예: `https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/token`
`scope`	offline_access 및 기타 필요한 범위를 공백으로 구분하여 지정하십시오. 범위는 요청된 접근 수준을 정의합니다. 예: `https://graph.microsoft.com/`
`authorization_url`	URL 사용자가 로그인하고 접근 권한을 승인하도록 리디렉션되는 곳. TENANT_ID를 귀하의 디렉터리(테넌트) ID로 대체하십시오. 예: `https://login.microsoftonline.com/Tenant_ID/oauth2/v2.0/authorize`
`client_id`	애플리케이션의 고유 식별자(Microsoft 포털에서 확인 가능)
`client_secret`	Microsoft에서 앱 인증을 위해 사용되는 비밀 키
`Token request field`	이것은 인증 서버가 코드나 자격 증명을 액세스 토큰으로 교환할 때 필요한 추가 매개변수를 포함하는 데 사용됩니다. 서버가 인증 코드나 리소스 ID와 같은 추가 세부 정보를 요구하는 사용자 정의 구현 시 필수적입니다.
`Auth request field`	OAuth 인증 엔드포인트의 로그인 단계에서 추가 정보를 제공하기 위해 사용됩니다. 서버가 올바른 테넌트 또는 ID 공급자를 식별하는 데 도움을 주며, 또는 `idp` 과 같은 사용자 지정 매개변수가 필요한 설정에서 필수적입니다. `tenant_id`

OAuth2 클라이언트 자격 증명


필드	설명
`Server URL`	이는 보호된 리소스를 호스팅하는 서버의 기본 URL 을 가리킵니다
`Send Credentials Via`	인증 정보가 헤더 또는 본문에 포함되어 전송되는 방식을 지정하십시오
`Token URL`	서버 URL 에 대한 토큰 URL 값을 지정하십시오. 토큰 인증( URL )은 일반적으로 애플리케이션 등록 과정에서 인증 서버(authorization server)에 의해 제공됩니다
`Client ID`	클라이언트 애플리케이션의 고유 식별자. 계정 사용자 인터페이스에서 클라이언트 ID를 가져오세요
`Client Secret`	클라이언트와 인증 서버만이 알고 있는 비밀 키
`Grant Type`	그랜트 유형은 항상 "client_credentials"입니다. 이는 클라이언트가 클라이언트 자격 증명 흐름을 사용하여 액세스 토큰을 요청하는 인증 서버를 나타냅니다
`Scope`	범위는 접근을 제한하는 방법입니다. 접근이 허용되는 특정 권한 또는 자원을 정의합니다. 예를 들어, 읽기/쓰기 프로필
`Token request field`	이것은 인증 서버가 코드나 자격 증명을 액세스 토큰으로 교환할 때 필요한 추가 매개변수를 포함하는 데 사용됩니다. 서버가 인증 코드나 리소스 ID와 같은 추가 세부 정보를 요구하는 사용자 정의 구현 시 필수적입니다

키-값 쌍 연결 세부 정보

조직에서 OAuth 기반 인증을 사용하는 경우, 인증 유형을 키-값 쌍으로 설정하고 새 필드 추가를 사용하여 다음 필드를 각각 추가하십시오:


키	설명
`client_id`	등록된 Microsoft 애플리케이션의 클라이언트 ID
`client_secret`	Microsoft 앱과 연결된 클라이언트 암호
`username`	Teams 계정 사용자 이름(일반적으로 이메일 주소)
`password`	Teams 계정용 비밀번호 또는 앱 전용 비밀번호
`authority`	예를 들어 인증을 위한 권한 URL, `https://login.microsoftonline.com`
`base_url`	예를 들어, Microsoft의 기본 URL 은, `https://login.microsoftonline.com`

이 값들을 확인하려면 Microsoft API 설명서를 참조하십시오.