프로젝트 관리

프로젝트 관리 연동은 Alforse에서 시작한 작업을 Linear 또는 Jira의 이슈와 연결합니다. 품질 팀은 이를 사용해 조치 작업과 변경 통지를 다시 입력하지 않고 엔지니어링 팀에 넘기며, 이후 상태, 담당자, 메모는 양방향으로 일치하게 유지됩니다.

​

연결 방식

각 연동은 설정 → 연동에서 회사별로 켜며, 둘 다 프로젝트 관리 범주에 표시됩니다. 연결한 뒤 조치 작업 또는 변경 통지를 이슈에 연결하면 Alforse가 두 레코드를 일치하게 유지합니다. 변경 사항은 두 방향으로 전달되며, 방향마다 별도의 연결을 사용합니다. 웹훅 URL은 회사별로 고유하며 연동의 설정 안내에 복사할 수 있는 형태로 표시됩니다: /api/webhook/linear/<your company id> 또는 /api/webhook/jira/<your company id>.

​

Linear 연결

Linear는 lin_api로 시작해야 하는 API 키로 인증합니다.

​

Jira 연결

Jira는 OAuth로 연결하므로 붙여 넣을 키가 없습니다. 유일한 설정은 선택 사항인 웹훅 시크릿입니다.

​

웹훅 보안

서명 기능이 생기기 전에 설정한 연동도 계속 작동하도록 두 시크릿은 모두 선택 사항입니다. 이러한 호환성에는 대가가 있습니다. 저장된 시크릿이 없으면 Alforse는 같은 URL로 전송된 진짜 Linear 또는 Jira 요청과 위조된 요청을 구별할 수 없습니다.

​

문제 해결

​

”Linear API Key must start with ‘lin_api’”

원인: API 키의 값이 Linear 개인 API 키가 아니거나 일부 문자가 빠진 채 붙여 넣어졌습니다. 해결 방법: Linear의 Security and access에서 새 키를 생성하고 전체를 붙여 넣으십시오.

​

Jira에서 한 변경 사항이 Alforse에 나타나지 않습니다

원인: Jira 웹훅이 없거나 올바른 이벤트를 구독하지 않았습니다. 해결 방법: System → WebHooks에서 Alforse 설정 안내의 URL로 웹훅을 만들고 Issue updated와 Issue deleted를 구독하십시오.

​

시크릿을 추가한 후 웹훅 요청이 거부됩니다

원인: Alforse에 저장된 시크릿이 트래커의 시크릿과 일치하지 않아 서명이 검증되지 않습니다. 해결 방법: Linear의 웹훅 상세 페이지 또는 Jira 웹훅의 Secret 필드에서 시크릿을 복사하여 Alforse에 다시 저장하십시오.

​

관련 문서