Linear 통합은 기술적으로 REST API를 통해 구현됩니다. 인증 및 권한 부여 목적을 위해 산업 표준인 OAuth 2.0 프로토콜을 활용합니다. 이 아키텍처의 핵심 구성 요소는 서드파티 데이터용 하위 프로세서로 사용되는 통합 API 플랫폼입니다. 이는 인증, 표준화 및 다양한 API 제공자 간의 동기화를 관리합니다.
데이터 흐름
보안 및 규정 준수를 관리하기 위해 데이터 흐름을 이해하는 것이 중요합니다.
상위 수준 시퀀스 다이어그램
Linear 카드 위젯 생성하기
Linear 카드 위젯 업데이트하기
Miro에서의 Linear 데이터
사용자가 Linear 이슈를 Miro 보드에 가져올 때, 다음 데이터가 Miro 캔버스에 통합됩니다:
- 제목
- 설명
- 담당자 (이름/이메일)
- 상태
- 우선순위
이 나열은 데이터 거버넌스에 중요하며, 어떤 민감한 데이터가 Miro 환경에 들어오는지를 확인합니다. 맞춤형 필드는 지원되지 않습니다.
데이터 보유
모든 가져온 Linear 데이터는 모든 고객 데이터에 일관되게 적용되는 Miro의 표준 데이터 보유 정책을 엄격히 준수합니다.
인증 및 권한 부여
첫 상호작용 시, Linear 통합에서 인증 절차가 시작됩니다. 각 사용자에 대해 Miro는 통합 서비스용 신원 정보를 생성하여 이후의 상호작용에 사용합니다.
일반적으로 이 통합은 Linear 관리자의 승인을 필요로 합니다.
필요한 권한 범위
| 범위 | 설명 |
|---|---|
| 컬렉션 | 이슈의 컬렉션에 접근합니다. |
| 사용자 | 배정/표시용 사용자 정보를 읽습니다. |
| 이슈 | Linear에서 이슈를 읽고, 생성하고, 수정합니다. |
Miro에 저장되는 데이터와 방법
- 인증 관련 데이터: 토큰은 여러 날 동안 Miro의 데이터베이스에 AES-256 암호화로 저장됩니다.
- 크기조정 관련 데이터: 이슈 제목은 암호화된 참조와 함께 저장됩니다.
토큰 철회
토큰 철회는 통합 설정이나 앱 탭에서 연결 끊기를 선택하여 수행할 수 있습니다. 이 작업은 Linear에 대한 액세스를 제거하고 사용자 신원 정보를 삭제합니다.
Linear 통합 설정 방법
관리자와 최종 사용자를 위한 단계로 통제된 배포를 보장합니다.
- 활성 계정 확인: Miro와 Linear 계정이 활성 상태여야 합니다.
-
팀 레벨 설치 (관리자 작업):
- 관리자는 팀 레벨에서 Linear 통합을 승인해야 합니다.
- 도구 미디어 및 통합을 통해 "Linear"를 검색하여 설치하고 연결합니다.
-
사용자 요청 및 관리자 승인:
- 엄격한 동의가 요구되는 조직의 경우, Linear 링크를 붙여넣으면 관리자 승인이 요청될 수 있습니다.
- 관리자는 Miro 또는 Linear 콘솔을 통해 승인할 수 있습니다.
-
개별 사용자 연결:
- 사용자는 Linear 위젯과 OAuth 인증을 통해 연결됩니다.
보안과 규정 준수
소스 파일에 대한 접근 제한
엄격한 보드 공유 제어를 유지하면 Linear 권한이 Miro와 일치하게 됩니다.
오류 처리
통합 기능은 써드 파티 거부 시 부드럽게 UI를 대체합니다.
Miro 데이터 처리 추가 조건(DPA)
상세한 법률 및 규정 준수 정보는 Miro의 데이터 처리 추가 조건을 참조하세요.
문제 해결 & FAQs
통합 해제 방법 (팀 레벨)
관리자는 팀 설정 앱 & 통합에서 "Linear"를 선택하고 팀용으로 제거를 클릭하여 제거할 수 있습니다.
통합 해제 방법 (개인)
사용자는 앱 & 통합으로 이동하여 Linear에 대해 "나를 위한 제거"를 선택할 수 있습니다.
관리자 권한
직접 앱을 설치할 수 있는 권한은 Miro 팀 관리자에게만 있습니다. 보드에 Linear URL을 붙여넣으면 자동 설정이 이루어집니다.
사용 가능 조건
Linear 통합은 Business 및 Enterprise 플랜에서 사용할 수 있습니다.
관리자 승인 필요
네, 팀에 접근하려면 관리자의 팀 승인 권한이 필요합니다.