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

# 프로젝트 관리

> Alforse를 Linear 또는 Jira에 연결하여 품질 조치 작업과 변경 통지를 엔지니어링 팀의 도구에서 이슈로 추적하고, 상태, 담당자, 메모를 양방향으로 맞춥니다.

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

## 연결 방식

각 연동은 **설정 → 연동**에서 회사별로 켜며, 둘 다 **프로젝트 관리** 범주에 표시됩니다. 연결한 뒤 조치 작업 또는 변경 통지를 이슈에 연결하면 Alforse가 두 레코드를 일치하게 유지합니다.

변경 사항은 두 방향으로 전달되며, 방향마다 별도의 연결을 사용합니다.

| 방향 | 전달 방식 | Linear | Jira |
| - | - | - | - |
| Alforse → 트래커 | Alforse가 트래커의 API를 호출 | API 키 | OAuth 인증 |
| 트래커 → Alforse | 트래커가 Alforse 웹훅 URL을 호출 | 웹훅, 서명 시크릿은 선택 사항 | 웹훅은 선택 사항, 시크릿도 선택 사항 |

웹훅 URL은 회사별로 고유하며 연동의 설정 안내에 복사할 수 있는 형태로 표시됩니다: `/api/webhook/linear/<your company id>` 또는 `/api/webhook/jira/<your company id>`.

## Linear 연결

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

### Linear에서 웹훅 만들기

Linear에서 API 설정 페이지를 엽니다. **Webhooks**에서 **New Webhook**을 선택하고 알아보기 쉬운 레이블을 지정한 다음, Alforse 설정 안내의 웹훅 URL을 **URL** 필드에 붙여 넣습니다. 이 경로로 Linear의 변경 사항이 Alforse에 도달합니다.

### 서명 시크릿 복사

웹훅을 저장하면 Linear가 상세 페이지에 **signing secret**을 표시합니다. 이를 Alforse의 **웹훅 서명 시크릿**(Webhook Signing Secret)에 붙여 넣으십시오. 이후 Alforse는 Linear가 서명했고 1분 이내에 생성된 웹훅 요청만 수락합니다.

### API 키 추가

Linear에서 **Security and access**로 이동하여 API 키를 생성합니다. 이를 Alforse의 **API 키**에 붙여 넣으십시오. `lin_api` 접두사가 없는 키는 *"Linear API Key must start with 'lin\_api'"*(Linear API 키는 'lin\_api'로 시작해야 합니다)라는 메시지와 함께 거부됩니다.

### 첫 조치 작업 연결

부적합 조치 작업을 Linear 이슈에 연결합니다. 이제 상태, 담당자, 메모가 양방향으로 동기화됩니다.

| 설정 | 필수 | 제어하는 내용 |
| - | - | - |
| **API 키** | 예 | Alforse가 Linear를 호출할 때 사용하는 키입니다. `lin_api`로 시작해야 합니다. |
| **웹훅 서명 시크릿** | 아니요 | 설정하면 Alforse는 유효한 Linear 서명이 없는 웹훅 요청을 모두 거부합니다. |

## Jira 연결

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

### Alforse 인증

**연결**을 선택하고 Atlassian 계정으로 Alforse를 인증합니다.

### Jira에서 웹훅 만들기(선택 사항)

웹훅을 사용하면 Alforse가 Jira의 변경 사항을 실시간으로 받습니다. 추가하려면 Jira의 **System → WebHooks**로 이동하여 Alforse 설정 안내의 URL로 웹훅을 만들고 **Issue updated**와 **Issue deleted**를 구독하십시오.

### 시크릿 공유

Jira 웹훅의 **Secret** 필드에 긴 임의 값을 입력하거나 Jira가 생성하도록 합니다. 같은 값을 Alforse의 **웹훅 시크릿**(Webhook Secret)에 붙여 넣으면 Alforse는 Jira가 서명한 요청만 수락합니다.

### 첫 조치 작업 연결

부적합 조치 작업을 Jira 이슈에 연결합니다. 이제 상태, 담당자, 메모가 양방향으로 동기화됩니다.

| 설정 | 필수 | 제어하는 내용 |
| - | - | - |
| **웹훅 시크릿** | 아니요 | 설정하면 Alforse는 유효한 Jira 서명이 없는 웹훅 요청을 모두 거부합니다. |

## 웹훅 보안

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

HEADS UP

**모든 웹훅에 시크릿을 설정하십시오**

서명 시크릿은 추가 항목이 아니라 설정의 일부로 취급하십시오. 웹훅 URL에는 회사 ID만 포함되어 있으므로, 시크릿이 없으면 URL을 알게 된 누구나 해당 URL로 요청을 보낼 수 있습니다.

## 문제 해결

### "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에 다시 저장하십시오.

## 관련 문서

**품질**

이러한 연동이 엔지니어링 팀에 넘기는 조치 작업의 대상인 부적합입니다.

[Open](https://docs.alforse.com/ko/docs/reference/quality.md)

**연동**

연동을 찾고 설치하고 구성하는 방법입니다.

[Open](https://docs.alforse.com/ko/docs/integrations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.