> ## Documentation Index
> Fetch the complete documentation index at: https://docs.casebender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 팀

> CaseBender 팀과 구성원, 분류, 에스컬레이션 및 알림 채널을 생성하고 관리합니다.

## 개요

팀은 조직 내에서 분석가, 소유권, 에스컬레이션 및 알림을 구성합니다. **설정 → 계정 → 팀**을 엽니다.

목록에 표시되는 범위는 역할에 따라 달라집니다.

* 최고 관리자는 인스턴스 전체의 팀을 볼 수 있습니다.
* 조직 관리자는 현재 조직의 팀을 볼 수 있습니다.
* 다른 사용자는 자신이 속한 팀을 볼 수 있습니다.

## 팀 생성

팀을 생성하려면 팀 생성 권한이 있는 관리자 역할이 필요합니다.

<Steps>
  <Step title="팀 열기">
    **설정 → 계정 → 팀**으로 이동합니다.
  </Step>

  <Step title="생성 시작">
    **팀 생성**을 선택합니다.
  </Step>

  <Step title="기본 설정 구성">
    팀 이름과 선택 사항인 설명을 입력합니다. 생성 양식에서 팀 이름은 2자 이상 50자 이하로 입력해야 합니다.

    최고 관리자는 조직을 선택합니다. 조직 관리자가 생성한 팀은 현재 조직에 속합니다.
  </Step>

  <Step title="분류 구성">
    팀의 기능과 티어를 선택합니다. 팀이 에스컬레이션 체인에 참여하는 경우 에스컬레이션 팀도 선택할 수 있습니다.
  </Step>

  <Step title="연락처 정보 추가">
    선택적으로 이메일 주소, Slack 채널 또는 Microsoft Teams 채널 참조를 입력합니다.
  </Step>

  <Step title="팀 생성">
    양식을 제출한 다음 팀 세부 정보 페이지를 열어 구성원을 관리하고 알림 채널 구성을 완료합니다.
  </Step>
</Steps>

## 팀 관리

팀 목록에서 **관리** 또는 **보기**를 선택합니다. 표시되는 작업은 권한에 따라 달라집니다.

### 기본 설정

팀 관리 권한이 있는 관리자는 다음 항목을 업데이트할 수 있습니다.

* 이름 및 설명
* 팀 기능 및 티어
* 에스컬레이션 팀
* 이메일 주소
* Slack 및 Microsoft Teams 채널 참조
* 사용 가능한 기타 팀 기본값

### 분류

라우팅, 보고 및 에스컬레이션 동작을 SOC 전반에서 명확하게 이해할 수 있도록 기능 및 티어 값을 일관되게 사용하세요.

에스컬레이션 팀을 지정할 때는 다음 사항을 따르세요.

* 대상 팀이 필요한 대응 범위를 갖추고 있는지 확인하세요.
* 순환 에스컬레이션 관계를 피하세요.
* 조직 변경 후 에스컬레이션 소유권을 검토하세요.

## 구성원 및 역할 관리

팀 세부 정보 페이지에는 활성 구성원과 대기 중인 구성원이 표시됩니다. 권한이 있는 관리자는 다음 작업을 수행할 수 있습니다.

* 팀에 구성원 초대
* 팀 범위 역할 할당 또는 변경
* 팀에서 구성원 제거

역할 할당은 구성원이 할당된 범위 내에서 수행할 수 있는 작업에 영향을 줍니다. 상승된 역할을 부여하기 전에 [액세스 제어](/en/security/access-control)를 참조하세요.

## 팀 알림 구성

팀을 열고 **알림** 탭을 선택합니다. 팀 알림은 각 사용자의 개인 알림 기본 설정과 별개입니다.

### Slack

Slack 전송에는 다음을 사용할 수 있습니다.

* 권한이 부여된 Slack 워크스페이스 및 채널
* 지원되는 수신 웹후크 구성

Slack OAuth를 사용하려면 CaseBender 배포 환경에 Slack 클라이언트 자격 증명과 공개 애플리케이션 URL이 구성되어 있어야 합니다. 이러한 사전 요구 사항이 충족되지 않은 경우 플랫폼 관리자에게 문의하세요.

### Microsoft Teams

지원되는 Microsoft Teams 웹후크 URL을 입력하고 원하는 이벤트 유형을 활성화합니다.

### 이메일

이메일 알림을 사용하려면 팀의 **기본** 설정에 유효한 팀 이메일 주소가 있고 발신 이메일 통합이 구성되어 있어야 합니다.

### 이벤트 제어

구성된 채널에 따라 팀은 다음과 관련된 이벤트의 알림을 활성화할 수 있습니다.

* 케이스
* 알림
* 작업
* SLA 마일스톤 및 위반
* 에스컬레이션 및 협업
* 상관 분석 결과

<Note>
  채널 설정과 이벤트 필터는 각각 독립적으로 평가됩니다. 이벤트를 활성화해도 대상 채널이 구성되고 활성화되어 있지 않으면 메시지가 전송되지 않습니다.
</Note>

## 팀 삭제

팀 관리 권한이 있는 사용자는 팀 세부 정보 페이지에서 팀을 삭제할 수 있습니다.

<Warning>
  현재 관리 흐름에서 팀 삭제는 영구적입니다. 삭제를 확인하기 전에 진행 중인 작업을 재할당하고, 팀을 대상으로 하는 통합을 제거하며, 보존해야 하는 레코드를 보관하세요.
</Warning>

삭제 후 CaseBender는 팀 목록으로 돌아갑니다.

## 액세스 및 권한

* 인증된 모든 사용자는 팀 섹션을 열 수 있습니다.
* 관리자는 역할에 따라 팀을 생성, 편집 및 삭제할 수 있습니다.
* 관리자가 아닌 사용자에게는 허용된 범위에 있는 팀을 읽기 전용으로 볼 수 있는 환경이 제공됩니다.
* 최고 관리자가 아닌 사용자가 현재 조직 외부의 팀을 열면 팀 세부 정보 페이지에 **액세스 거부됨**이 표시됩니다.
* 사용자의 역할에 팀 관리 권한이 있는 경우에만 관리 및 알림 제어 항목이 표시됩니다.

## 운영 권장 사항

### 소유권 설정

* 명확한 기능과 티어를 지정하세요.
* 모니터링되는 팀 이메일 또는 협업 채널을 유지하세요.
* 근무 시간 외 대응 또는 전문 지원을 위한 유효한 에스컬레이션 팀을 지정하세요.

### 구성원 관리

* 구성원의 담당 업무에 필요한 역할만 부여하세요.
* 더 이상 필요하지 않은 구성원 자격은 즉시 제거하세요.
* 액세스 검토 시 활성 및 대기 중인 구성원 자격을 검토하세요.

### 알림 테스트

* 자격 증명 또는 웹후크를 변경한 후 각 대상을 검증하세요.
* 웹후크 URL을 비밀로 유지하세요.
* 중요한 SLA 및 에스컬레이션 이벤트가 대응 인력이 확인하는 채널에 도달하는지 확인하세요.

## 문제 해결

### 팀 생성이 표시되지 않음

역할에 팀 생성 권한이 없거나 팀을 생성할 조직 컨텍스트가 없습니다.

### 팀을 볼 수 있지만 편집할 수 없음

팀 관리 권한 없이 읽기 액세스 권한만 있습니다. 조직 관리자 또는 최고 관리자에게 문의하세요.

### Slack 권한 부여를 시작할 수 없음

플랫폼 관리자에게 Slack 클라이언트 ID, 클라이언트 보안 비밀 및 공개 CaseBender URL을 확인해 달라고 요청하세요.

### 이메일 알림이 전송되지 않음

팀에 이메일 주소가 있고 인스턴스에 발신 이메일이 구성되어 있는지 확인하세요.

## API 액세스

자동화를 위해 범위로 제어되는 팀 엔드포인트가 제공됩니다.

* [팀 목록 조회](/en/api-reference/endpoint/teams/list)
* [팀 조회](/en/api-reference/endpoint/teams/get-by-id)
* [팀 생성](/en/api-reference/endpoint/teams/create)
* [팀 업데이트](/en/api-reference/endpoint/teams/update)
* [사용자 추가](/en/api-reference/endpoint/teams/add-user)
* [사용자 제거](/en/api-reference/endpoint/teams/remove-user)

## 관련 가이드

* [조직](./organizations.mdx)
* [구성원](./members.mdx)
* [알림](./notifications.mdx)
