Jira · Confluence 연동

## 이 연동으로 보이는 것 ### Jira - 프로젝트 목록과 이슈 - **상태별 진행률** (할 일 / 진행 중 / 완료) - **담당자별 할당 이슈 현황** - 프로젝트 화면과 업무활동 화면에 반영 ### Confluence - 문서·페이지 변경 추적 - 업무활동 화면에서 Jira 활동과 함께 집계 ## 사전 준비물 | 항목 | 어디서 | 비고 | |---|---|---| | **Base URL** | 조직의 Atlassian 주소 | `https://<조직>.atlassian.net` | | **이메일** | Atlassian 로그인 계정 | | | **API Token** | id.atlassian.com → Security | 즉시 발급 | > **Confluence 는 별도 설정이 필요 없습니다.** Jira 를 연동하면 같은 API Token 으로 자동 인증됩니다. ## 발급 절차 1. [Atlassian API 토큰 관리](https://id.atlassian.com/manage-profile/security/api-tokens) 접속 2. **Create API token** 클릭 3. 라벨 입력 (예: `Morning Insight`) → 생성 4. **토큰을 복사** — ⚠️ 이 화면을 닫으면 다시 볼 수 없습니다 ### Base URL 확인 Jira 를 쓸 때 브라우저 주소창의 앞부분입니다. ``` https://mycompany.atlassian.net ``` - **끝에 `/` 를 붙이지 마세요** - `/jira` 같은 경로를 포함하지 마세요 - 자체 호스팅(Data Center) 환경은 주소 형식이 다를 수 있습니다 ## 모닝인사이트에 입력 1. **설정 → 데이터 연동** 탭 2. **프로젝트 관리 도구 → Jira** 카드 클릭 3. 입력: - Base URL - 이메일 (Atlassian 계정) - API Token 4. **저장** → **연결 테스트** 연결 테스트가 성공하면 **계정명과 접근 가능한 프로젝트 수**가 표시됩니다. 프로젝트 수가 0 이면 계정에 프로젝트 접근 권한이 없는 것입니다. ## 프로젝트 동기화 연동 후 프로젝트 목록을 가져옵니다. 자동 수집은 **매일 05:00** 에 실행되어 활동 데이터를 집계합니다. 바로 보고 싶으면 설정 화면에서 동기화를 수동 실행할 수 있습니다. ## 확인 방법 1. 연결 테스트에서 계정명 + 프로젝트 수가 나오는지 2. **프로젝트** 화면에 프로젝트와 이슈가 나오는지 3. **업무활동** 화면에 담당자별 활동이 집계되는지 4. Confluence 문서 변경이 함께 나오는지 ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 인증 실패 | 이메일이 표시 이름이 아닌지 확인 | **로그인 이메일**을 정확히 입력 | | 인증 실패 | 비밀번호를 입력함 | 비밀번호가 아니라 **API Token** 입니다 | | 인증 실패 | Base URL 끝에 `/` 포함 | 슬래시 제거 | | 인증 실패 | 토큰 복사 시 공백 포함 | 다시 붙여넣기 | | 프로젝트 수가 0 | 계정에 프로젝트 접근 권한 없음 | Jira 관리자에게 권한 요청 | | 일부 프로젝트만 보인다 | 그 계정이 접근 가능한 범위만 조회됨 | 필요한 프로젝트 권한 추가 | | Confluence 데이터가 없다 | 계정에 Confluence 접근 권한 없음 | Confluence 권한 확인 | | 갑자기 끊김 | 토큰 폐기 또는 계정 비활성화 | 새 토큰 발급 후 재입력 | ## 운영 팁 - **개인 계정이 아닌 공용/서비스 계정**으로 연동하세요. 담당자가 퇴사하면 그 계정의 토큰이 죽어 연동이 끊깁니다 - 연동 계정이 **볼 수 있는 프로젝트만** 조회됩니다. 전사 현황을 보려면 전체 프로젝트 조회 권한이 있는 계정을 쓰세요 - 토큰은 다시 볼 수 없으니 발급 시 안전한 곳에 보관하세요 ## 제약 - 연동 계정의 **접근 권한 범위**가 곧 조회 범위입니다 - 자체 호스팅(Data Center) 환경은 별도 확인이 필요합니다 → [문의](/news/guide/contact) - Confluence 는 Jira 자격증명에 종속됩니다. Jira 연동이 끊기면 함께 끊깁니다 ## 관련 문서 - [이메일 연동 (IMAP·POP3)](/news/guide/email-imap) - [연동 상태 · 재인증 · 토큰 만료](/news/guide/integration-refresh)