snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ko/user-guide/permissions-access/capabilities/permissions.mdx

@@ -0,0 +1,213 @@
+---
+title: 권한
+description: 역할 기반 권한을 통해 객체, 필드 및 설정에 대한 접근을 제어합니다.
+---
+
+Twenty의 권한 시스템은 세 가지 주요 영역에 대한 접근을 제어할 수 있게 해줍니다:
+
+* **객체 및 필드**: 기록 및 개별 필드를 누가 볼 수 있고, 편집하거나 삭제할 수 있는지 제어
+* **설정**: 워크스페이스 구성과 관리자 기능에 대한 접근을 관리합니다
+* **작업**: 데이터 가져오기나 이메일 보내기와 같은 일반 작업 공간 작업을 제어
+
+## 역할 생성
+
+새로운 역할 생성하기:
+
+1. **설정 → 구성원 → 역할**로 이동하세요
+2. **모든 역할**에서 **+ 역할 생성** 클릭
+3. 역할 이름 입력
+4. 기본 **권한** 탭에서 [권한을 구성합니다](#customize-permissions)
+5. **저장** 클릭하여 완료
+
+## 역할 삭제
+
+역할을 삭제하려면:
+
+1. **설정 → 구성원 → 역할**로 이동하세요
+2. 제거하려는 역할을 클릭합니다
+3. **설정** 탭 열고 **역할 삭제** 클릭
+4. 모달에서 **확인** 클릭
+
+<Note>
+역할이 삭제되면, 해당 역할이 할당된 워크스페이스 구성원은 기본 역할로 자동 재할당됩니다. **Admin** 역할을 제외한 모든 역할은 삭제할 수 있습니다. **Admin** 역할에는 항상 최소 한 명의 구성원이 할당되어 있어야 합니다.
+</Note>
+
+## 구성원에게 역할 할당
+
+### 현재 할당 보기
+
+* **설정 → 구성원 → 역할**로 이동하세요
+* 모든 역할과 각 역할에 지정된 멤버 수 확인
+* 어떤 회원이 어떤 역할을 가지고 있는지 보기
+
+### 구성원에게 역할 할당
+
+1. **설정 → 구성원 → 역할**로 이동하세요
+2. 할당할 역할 클릭
+3. **배정** 탭 열기
+4. **+ 멤버에게 할당** 클릭
+5. 목록에서 워크스페이스 구성원을 선택합니다
+6. 할당 확인
+
+### 기본 역할 설정
+
+1. **설정 → 구성원 → 역할**로 이동하세요
+2. **옵션** 섹션에서 **기본 역할**을 찾습니다
+3. 새로운 멤버가 자동으로 받을 역할 선택
+4. 새 작업 공간 회원이 가입 시 이 역할이 할당됩니다.
+
+<Note>
+기존 워크스페이스 구성원에게만 역할을 할당할 수 있습니다. To invite new members, use [Member Management](/l/ko/user-guide/settings/capabilities/member-management).
+</Note>
+
+## 권한 사용자 정의
+
+권한은 작업 공간 객체, 레코드, 설정, 작업을 포함하여 각 역할이 작업 공간 내에서 어떤 항목에 접근하거나 수정할 수 있는지를 결정합니다.
+
+### 객체 권한
+
+**객체** 섹션에서는 이 역할이 워크스페이스 전반의 레코드에 대해 수행할 수 있는 작업을 제어합니다.
+
+#### 기본 권한 설정(모든 객체)
+
+먼저, 기본적으로 **모든 객체**에 적용되는 기준 권한을 구성합니다:
+
+| 권한               | 설명                    |
+| ---------------- | --------------------- |
+| **모든 객체의 기록 보기** | 목록 및 상세 페이지에서 레코드를 조회 |
+| **모든 객체의 기록 편집** | 기존 레코드를 수정            |
+| **모든 객체의 기록 삭제** | 레코드를 소프트 삭제(복원 가능)    |
+| **모든 객체의 기록 파기** | 레코드를 영구 삭제            |
+
+이 역할의 기본 동작이 무엇이어야 하는지에 따라 선택 또는 선택 해제합니다.
+
+<Note>
+**예시 — 인턴 역할**: 인턴은 기본적으로 모든 객체를 볼 수 있지만 수정할 수는 없어야 합니다. "모든 객체에서 레코드 보기"를 활성화하고, "모든 객체에서 레코드 편집"은 선택 해제 상태로 둡니다.
+</Note>
+
+#### 객체 수준 예외 추가
+
+기본값을 설정한 후, **객체 수준** 하위 섹션을 사용해 특정 객체에 대해 기본값을 재정의하는 규칙을 추가합니다.
+
+**+ Add rule**를 클릭하고 예외를 만들 객체를 선택합니다.
+
+**인턴 역할을 위한 예시 규칙:**
+
+| 규칙                            | 효과                                    |
+| ----------------------------- | ------------------------------------- |
+| Opportunities → "레코드 보기" 비활성화 | 인턴은 Opportunities 객체를 전혀 볼 수 없습니다     |
+| People → "레코드 수정" 활성화         | 인턴은 People 레코드를 수정할 수 있습니다(다른 객체는 불가) |
+
+### 행 수준 권한
+
+<Note>
+행 수준 권한은 **Organization** 요금제(Cloud 및 Self-Hosted)에서 제공되는 **Premium 기능**입니다.
+</Note>
+
+행 수준 권한을 사용하면 동적 기준을 기반으로 역할이 볼 수 있거나 편집할 수 있는 개별 레코드를 제한할 수 있습니다. 객체 유형 전체에 적용되는 객체 권한과 달리, 행 수준 권한은 각 레코드를 개별적으로 평가합니다.
+
+**사용 예시:**
+
+* 영업 담당자는 자신에게 할당된 영업 기회만 볼 수 있습니다.
+* 관리자는 자신의 지역에 있는 모든 레코드를 볼 수 있습니다.
+* 지원 담당자는 자신에게 할당된 티켓만 볼 수 있습니다.
+
+행 수준 권한을 구성하려면 역할을 연 다음 **Objects** 탭으로 이동하여 **Row-Level** 섹션을 사용해 특정 객체에 대한 필터 조건을 정의합니다.
+
+### 필드 권한
+
+각 객체 수준 규칙 내에서 더 나아가 특정 필드에 대한 접근을 제어하기 위해 **필드 수준 권한**을 구성할 수 있습니다.
+
+| 권한        | 설명            |
+| --------- | ------------- |
+| **필드 보기** | 필드 값을 조회      |
+| **필드 수정** | 필드 값을 수정      |
+| **접근 불가** | 필드가 완전히 숨겨집니다 |
+
+**예시 — 민감한 필드 제한:**
+
+People 수정 권한이 있는 인턴 역할의 경우, 특정 필드를 제한할 수 있습니다:
+
+* People → Email → **필드 보기**만 허용(수정 불가)
+* People → Address → **접근 불가**(완전히 숨김)
+
+이렇게 하면 인턴이 People의 대부분 필드를 수정할 수 있으면서도 민감한 정보를 보호할 수 있습니다.
+
+### 권한 상속 방식
+
+권한은 일반에서 구체적으로 계단식으로 적용됩니다:
+
+1. **All Objects** → 모든 객체에 대한 기준을 설정합니다
+2. **Object-Level rules** → 특정 객체에 대해 기준을 재정의합니다
+3. **Field-Level rules** → 특정 필드에 대해 객체 설정을 재정의합니다
+
+보다 구체적인 설정이 항상 우선합니다.
+
+### 권한 무시 관리
+
+상속된 권한을 재정의하려면:
+
+1. 상속된 규칙 제거하려면 **X** 클릭
+2. 원하는 구체적인 권한을 선택합니다
+3. 변경 사항을 되돌리려면 주황색 **실행 취소** 아이콘(원형 화살표)을 클릭
+
+완료되면 **마침**, 역할 페이지로 리디렉션되면 **저장** 클릭.
+
+### 작업 공간 설정 권한
+
+워크스페이스 설정에 대한 접근은 두 가지 방식으로 제어할 수 있습니다:
+
+* **Settings All Access**를 전환하여 전체 접근을 허용합니다
+* 또는 특정 권한을 개별적으로 활성화합니다(예: API 키 생성, 워크스페이스 환경설정, 역할 할당, 데이터 모델 구성, 보안 설정, 워크플로 관리)
+
+<Note>
+**현재 제한 사항**: 워크플로를 수동으로 트리거하려면 현재 워크플로 관리 권한이 필요합니다. 이 동작은 향후 릴리스에서 변경될 수 있습니다.
+</Note>
+
+### 워크스페이스 작업 권한
+
+일반적인 워크스페이스 작업에 대한 접근을 제어합니다:
+
+* **Application All Access**를 전환하여 전체 권한을 부여합니다
+* 또는 **Send Email**, **Import CSV**, **Export CSV**와 같은 개별 작업을 활성화합니다
+
+## API 키 및 AI 에이전트에 역할 할당
+
+워크스페이스 구성원뿐 아니라 **API 키** 및 **AI 에이전트**에도 역할을 할당할 수 있습니다. 이는 자동화 프로세스와 통합을 포함하여 워크스페이스에서 "누가" 무엇을 할 수 있는지를 정확히 제어하려는 팀에 특히 유용합니다.
+
+### API 키와 AI 에이전트에 역할을 할당하는 이유
+
+* **보안**: 자동화 프로세스가 접근하거나 수정할 수 있는 범위를 제한
+* **규정 준수**: 통합이 필요한 데이터에만 접근하도록 보장
+* **제어**: 잘못 구성된 자동화로 인한 우발적 데이터 변경 방지
+* **감사 추적성**: 어떤 통합 또는 에이전트가 어떤 작업을 수행했는지 추적
+
+### API 키에 역할 할당
+
+1. **설정 → 구성원 → 역할**로 이동하세요
+2. 할당할 역할 클릭
+3. **배정** 탭 열기
+4. **API 키**에서 **+ Assign to API key**를 클릭합니다
+5. 목록에서 API 키를 선택합니다
+6. 할당 확인
+
+이제 해당 API 키는 그 역할에 정의된 모든 권한을 상속받습니다. 이 키로 수행되는 모든 API 호출은 그에 따라 제한됩니다.
+
+<Note>
+역할이 할당되지 않은 API 키는 기본 권한을 사용합니다. 보안을 강화하려면 운영 환경의 API 키에 항상 특정 역할을 할당하세요.
+</Note>
+
+### AI 에이전트에 역할 할당
+
+1. **설정 → 구성원 → 역할**로 이동하세요
+2. 할당할 역할 클릭
+3. **배정** 탭 열기
+4. **AI 에이전트**에서 **+ Assign to AI agent**를 클릭합니다
+5. 목록에서 AI 에이전트를 선택합니다
+6. 할당 확인
+
+AI 에이전트는 할당된 역할에서 허용한 데이터와 작업에만 접근하고 수행할 수 있습니다.
+
+<Note>
+워크플로 내에서 실행되는 AI 에이전트의 경우, 워크플로에 더 넓은 권한이 있더라도 에이전트가 의도된 범위를 벗어난 데이터에 접근하거나 수정할 수 없도록 보장합니다.
+</Note>

packages/twenty-docs/l/ko/user-guide/permissions-access/capabilities/sso-configuration.mdx

@@ -0,0 +1,125 @@
+---
+title: SSO 구성
+description: 안전한 엔터프라이즈 인증을 위해 Single Sign-On(SSO)을 구성하세요.
+---
+
+## SSO에 대하여
+
+Single Sign-On(SSO)을 사용하면 팀 구성원이 조직의 아이덴티티 제공자(IdP)를 통해 Twenty에 로그인할 수 있습니다. 이는 다음을 제공합니다:
+
+* **중앙집중식 액세스 제어**: 한 곳에서 액세스를 관리합니다
+* **강화된 보안**: 기존 보안 정책을 활용합니다
+* **향상된 사용자 경험**: 모든 도구에서 하나의 자격 증명만 사용합니다
+
+## 지원되는 제공자
+
+Twenty는 다음 제공자와 SSO를 지원합니다:
+
+* **SAML 2.0**: 대부분의 엔터프라이즈 아이덴티티 제공자와 호환됩니다
+* **Google Workspace**: Google을 사용하는 조직용
+* **Microsoft Entra ID** (이전 명칭: Azure AD): Microsoft 환경용
+
+## SSO 설정
+
+### 사전 준비
+
+* Organization 플랜(클라우드 및 셀프 호스팅 워크스페이스)
+* 아이덴티티 제공자에 대한 관리자 권한
+* Twenty 워크스페이스에 대한 관리자 권한
+
+### 구성 단계
+
+#### 1. SSO 설정에 액세스
+
+1. **설정 → 보안**으로 이동하세요.
+2. **SSO 구성** 섹션을 찾으세요
+3. **SSO 구성**을 클릭하세요
+
+#### 2) 제공자 선택
+
+목록에서 아이덴티티 제공자를 선택하거나, 다른 제공자의 경우 "Custom SAML"을 선택하세요.
+
+#### 3. 아이덴티티 제공자 구성
+
+아이덴티티 제공자를 다음 정보로 구성해야 합니다:
+
+* **Entity ID**: Twenty에서 제공
+* **ACS URL**: 인증용 콜백 URL
+* **Certificate**: 보안 통신용
+
+#### 4. Twenty에 제공자 상세 정보 입력
+
+* **SSO URL**: 제공자의 로그인 URL
+* **Entity ID**: 제공자의 식별자
+* **Certificate**: 제공자의 X.509 인증서
+
+#### 5. 테스트 및 활성화
+
+1. 구성을 확인하려면 **구성 테스트**를 클릭하세요
+2. 테스트가 성공하면 SSO를 활성화하세요
+3. 사용자 프로비저닝 설정을 구성하세요.
+
+## 사용자 프로비저닝
+
+### Just-in-Time(JIT) 프로비저닝
+
+* 최초 로그인 시 사용자가 자동으로 생성됩니다
+* 사용자에게 기본 역할이 자동으로 할당됩니다
+* 사용자를 수동으로 생성할 필요가 없습니다
+
+### 수동 프로비저닝
+
+* 사용자가 로그인하기 전에 초대하세요
+* 특정 역할을 사전 할당
+* 워크스페이스에 액세스할 수 있는 대상을 보다 세밀하게 제어
+
+## SSO 사용자 관리
+
+### 역할 할당
+
+SSO 사용자도 일반 사용자와 마찬가지로 역할을 할당할 수 있습니다:
+
+1. **설정 → 구성원**으로 이동하세요.
+2. 사용자를 찾으세요
+3. 필요에 따라 역할을 변경하세요
+
+### 액세스 권한 철회
+
+SSO 사용자의 액세스를 제거하려면:
+
+* 아이덴티티 제공자에서 제거하거나,
+* Twenty 워크스페이스에서 제거하세요
+
+## 모범 사례
+
+### 보안
+
+* **SSO 필수**: SSO 사용자에 대해 비밀번호 로그인을 비활성화
+* **정기 감사**: 주기적으로 액세스를 검토
+* **강력한 IdP 정책**: 아이덴티티 제공자에서 MFA를 적용
+
+### 사용자 관리
+
+* **명확한 명명**: 디렉터리에서 일관된 명명 규칙 사용
+* **그룹 매핑**: IdP 그룹을 Twenty 역할에 매핑(가능한 경우)
+* **오프보딩 프로세스**: 디프로비저닝 워크플로우에 Twenty를 포함
+
+## 문제 해결
+
+### 일반적인 문제
+
+* **인증서 오류**: 인증서가 만료되지 않았는지 확인
+* **URL 불일치**: ACS URL이 정확히 일치하는지 확인
+* **사용자를 찾을 수 없음**: JIT 프로비저닝 설정을 확인
+
+### 도움 받기
+
+문제가 발생하면 다음 정보를 포함하여 지원팀에 문의하세요:
+
+* 수신한 오류 메시지
+* 사용 중인 아이덴티티 제공자
+* 구성 세부 정보(민감한 데이터 제외)
+
+<Tip>
+조직에 SSO 구성이 필요하신가요? SSO 및 ID 설정을 전문으로 하는 [공인 Twenty 파트너를 찾아보세요](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-sso). *(Twenty와 직접 논의하길 원하시나요? [contact@twenty.com](mailto:contact@twenty.com))*
+</Tip>

packages/twenty-docs/l/ko/user-guide/permissions-access/how-tos/permissions-faq.mdx

@@ -0,0 +1,120 @@
+---
+title: 권한 FAQ
+description: 역할과 권한에 관한 자주 묻는 질문입니다.
+---
+
+## 역할
+
+<AccordionGroup>
+<Accordion title="Twenty에는 기본적으로 어떤 역할이 제공되나요?">
+Twenty에는 기본적으로 **Admin** 및 **Member** 역할이 포함되어 있습니다. 팀의 필요에 따라 추가 사용자 지정 역할을 만들 수 있습니다(예: 영업 담당자, 관리자, 읽기 전용 사용자).
+</Accordion>
+
+<Accordion title="Admin 역할을 삭제할 수 있나요?">
+아니요, Admin 역할은 삭제할 수 없습니다. Admin 역할에는 항상 최소 한 명의 구성원이 할당되어 있어야 합니다.
+</Accordion>
+
+<Accordion title="역할을 삭제하면 어떻게 되나요?">
+해당 역할이 할당된 워크스페이스 구성원은 기본 역할로 자동 재할당됩니다.
+</Accordion>
+
+<Accordion title="신규 구성원에게 기본 역할을 어떻게 설정하나요?">
+**설정 → 구성원 → 역할**로 이동하여 **Default Role** 옵션을 찾은 뒤, 신규 구성원이 가입할 때 자동으로 부여될 역할을 선택하세요.
+</Accordion>
+
+<Accordion title="한 사용자에게 여러 역할을 할당할 수 있나요?">
+아니요, 각 사용자는 한 번에 하나의 역할만 가질 수 있습니다. 권한 조합이 필요하다면 사용자 지정 역할을 생성하세요.
+</Accordion>
+</AccordionGroup>
+
+## 권한
+
+<AccordionGroup>
+<Accordion title="객체 권한과 필드 권한의 차이점은 무엇인가요?">
+* **객체 권한**: 전체 레코드에 대한 액세스를 제어합니다(예: People 레코드를 보기/편집/삭제 가능)
+* **필드 권한**: 객체 내 특정 필드에 대한 액세스를 제어합니다(예: Salary 필드는 볼 수만 있고 편집은 불가)
+
+필드 권한은 민감한 데이터에 대해 더 세밀한 제어를 가능하게 합니다.
+</Accordion>
+
+<Accordion title="권한 재정의는 어떻게 작동하나요?">
+권한은 일반에서 구체적으로 계단식으로 적용됩니다:
+1. **All Objects**는 모든 객체에 대한 기준을 설정합니다
+2. **Object-Level Permissions**는 특정 객체에 대해 전역 설정을 재정의할 수 있습니다
+3. **Field-Level Permissions**는 특정 필드에 대해 객체 설정을 재정의할 수 있습니다
+
+보다 구체적인 설정이 항상 우선합니다.
+</Accordion>
+
+<Accordion title="다양한 권한 수준은 무엇을 의미하나요?">
+객체의 경우:
+* **See Records**: 목록 및 상세 페이지에서 레코드를 조회
+* **Edit Records**: 기존 레코드 수정
+* **Delete Records**: 레코드를 소프트 삭제(복원 가능)
+* **Destroy Records**: 레코드를 영구 삭제
+
+필드의 경우:
+* **See Field**: 필드 값 조회
+* **Edit Field**: 필드 값 수정
+* **No Access**: 필드가 완전히 숨겨짐
+</Accordion>
+
+<Accordion title="특정 레코드에 대한 액세스를 제한할 수 있나요(행 수준 권한)?">
+행 수준 권한은 **Organization** 요금제에서 제공됩니다. 이를 통해 기준에 따라 특정 레코드에 대한 액세스를 제한할 수 있습니다(예: 자신의 영업 기회만 보기).
+</Accordion>
+
+<Accordion title="일부 사용자에 대해 필드를 읽기 전용으로 설정하려면 어떻게 하나요?">
+1. **설정 → 구성원 → 역할**로 이동하세요
+2. 역할을 선택합니다
+3. 해당 필드가 포함된 객체로 이동합니다
+4. 필드 권한을 **See Field**로 설정합니다(**Edit Field** 없이)
+</Accordion>
+</AccordionGroup>
+
+## 설정 및 작업
+
+<AccordionGroup>
+<Accordion title="사용할 수 있는 설정 권한은 무엇인가요?">
+다음에 대한 액세스를 제어할 수 있습니다:
+* API 키 생성
+* 워크스페이스 환경설정
+* 역할 할당
+* 데이터 모델 구성
+* 보안 설정
+* 워크플로우 관리
+
+**Settings All Access**를 사용하여 전체 액세스를 부여하거나, 특정 권한만 활성화하세요.
+</Accordion>
+
+<Accordion title="사용할 수 있는 작업 권한은 무엇인가요?">
+다음을 제어할 수 있습니다:
+* **Send Email**: Twenty에서 이메일을 보낼 수 있음
+* **Import CSV**: CSV를 통해 데이터를 가져올 수 있음
+* **Export CSV**: 데이터를 CSV로 내보낼 수 있음
+
+**Application All Access**를 사용하여 모든 작업을 허용하거나, 필요한 항목만 활성화하세요.
+</Accordion>
+</AccordionGroup>
+
+## SSO
+
+<AccordionGroup>
+<Accordion title="모든 요금제에서 SSO를 사용할 수 있나요?">
+아니요, SSO는 **Organization** 요금제에서만 제공되는 프리미엄 기능입니다.
+</Accordion>
+
+<Accordion title="어떤 아이덴티티 제공자가 지원되나요?">
+Twenty는 다음을 지원합니다:
+* **SAML 2.0**(대부분의 엔터프라이즈 아이덴티티 제공자와 호환)
+* **Google Workspace**
+* **Microsoft Entra ID**(이전 명칭: Azure AD)
+</Accordion>
+
+<Accordion title="Just-in-Time(JIT) 프로비저닝이란 무엇인가요?">
+JIT 프로비저닝을 사용하면, 사용자가 SSO로 처음 로그인할 때 Twenty에 사용자 계정이 자동으로 생성됩니다. 기본 역할이 자동으로 할당됩니다.
+</Accordion>
+
+<Accordion title="모든 사용자에게 SSO를 필수로 적용할 수 있나요?">
+예. SSO 구성이 완료되면, 아이덴티티 제공자를 통한 인증을 강제하기 위해 SSO 사용자에 대한 비밀번호 로그인을 비활성화할 수 있습니다.
+</Accordion>
+</AccordionGroup>

packages/twenty-docs/l/ko/user-guide/permissions-access/overview.mdx

@@ -0,0 +1,34 @@
+---
+title: 권한 및 액세스
+description: 워크스페이스에서 역할, 권한 및 액세스 제어를 관리합니다.
+---
+
+Twenty의 권한 시스템을 통해 워크스페이스에서 누가 데이터에 액세스하고 수정할 수 있는지 제어할 수 있습니다. 역할을 만들고 권한을 부여하며 보안 액세스를 위해 SSO를 구성하세요.
+
+## 이 섹션의 내용
+
+<CardGroup cols={2}>
+  <Card title="권한" icon="lock" href="/l/ko/user-guide/permissions-access/capabilities/permissions">
+    역할을 만들고 객체, 필드 및 설정 권한을 구성하세요.
+  </Card>
+  <Card title="SSO 구성" icon="key" href="/l/ko/user-guide/permissions-access/capabilities/sso-configuration">
+    ID 공급자와 함께 Single Sign-On(SSO)을 설정하세요.
+  </Card>
+  <Card title="자주 묻는 질문" icon="circle-question" href="/l/ko/user-guide/permissions-access/how-tos/permissions-faq">
+    역할, 권한 및 SSO에 대한 자주 묻는 질문.
+  </Card>
+</CardGroup>
+
+## 주요 기능
+
+* **역할 기반 액세스**: 특정 권한을 가진 사용자 지정 역할 생성
+* **객체 권한**: 누가 기록을 보고, 편집하거나 삭제할 수 있는지 제어
+* **필드 권한**: 민감한 필드에 대한 액세스 제한
+* **설정 권한**: 워크스페이스 구성에 대한 액세스 제어
+* **SSO 통합**: 엔터프라이즈 보안을 위해 Single Sign-On(SSO) 구성(Organization 요금제)
+
+## 빠른 링크
+
+* [역할 생성](/l/ko/user-guide/permissions-access/capabilities/permissions#create-a-role)
+* [SSO 구성](/l/ko/user-guide/permissions-access/capabilities/sso-configuration)
+* [팀 구성원 관리](/l/ko/user-guide/settings/capabilities/member-management)