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

# 커밋 서명

> SSH·GPG 서명과 저장소별 설정

<Info>
  **PRO 전용** — 커밋 서명은 ParalleLane Pro 기능입니다.
  Basic에서는 **서명 방식** 제목에 **PRO** 배지가 붙고, SSH나 GPG를 선택하면 업그레이드 안내가 표시됩니다.
  요금제 차이는 [요금제](/ko/quickstart#요금제)에서 확인하세요.
</Info>

SSH 또는 GPG 키로 새 커밋에 서명합니다.
전역 방식을 정한 뒤 필요한 저장소만 따로 덮어쓸 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/settings-signing-ssh.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=542e764450788f9ef4d14284d3a5891d" alt="서명 방식이 SSH로 선택되고 ~/.ssh의 서명 키를 고르는 서명 설정 화면" width="2906" height="1784" data-path="images/settings-signing-ssh.png" />
</Frame>

## 전역 서명 설정

**설정 → ParalleLane → 서명(Signing)** 에서 **서명 방식(Signing method)** 을 **안 함(Off) / SSH / GPG** 중에 고르고, 서명 키를 선택합니다.
키를 선택하는 즉시 전역 Git 서명 설정에 반영됩니다.

<Tabs>
  <Tab title="SSH">
    `~/.ssh` 에서 발견한 공개키를 고릅니다.
    공개키 경로를 `user.signingkey` 로 사용하고 `gpg.format=ssh`, `commit.gpgsign=true` 를 설정합니다.
    호스트 인증에 쓰는 SSH 계정과 같은 키를 골라도 되지만 계정에 묶여 있지는 않습니다.
  </Tab>

  <Tab title="GPG">
    설치된 GnuPG와 비밀키를 감지합니다.
    **서명 키(Signing key)** 행에 `GnuPG 2.4.7 감지됨` 처럼 감지된 버전이 초록 배지로, 없으면 **GnuPG가 설치되어 있지 않습니다** 가 표시됩니다.
    비밀키가 없으면 키 드롭다운이 비활성 상태가 됩니다.

    <Frame>
      <img src="https://mintcdn.com/railgit/1HhHpeGsA-i8McQ3/images/settings-signing-gpg.png?fit=max&auto=format&n=1HhHpeGsA-i8McQ3&q=85&s=f23f881b48c671a1bfdcab64efb17b5e" alt="서명 방식을 GPG로 바꿔 GnuPG 감지 상태와 서명 키 선택 드롭다운이 표시된 서명 설정 화면" width="2906" height="1784" data-path="images/settings-signing-gpg.png" />
    </Frame>
  </Tab>
</Tabs>

<Note>
  **안 함(Off)** 을 선택하면 ParalleLane이 관리하는 자동 서명 설정을 끕니다.
  다시 선택하면 이후 만드는 commit과 amend에 서명이 적용됩니다.
</Note>

## 저장소별로 다르게 설정하기

**설정 → 프로젝트(Projects) → 서명(Signing)** 에서 저장소의 규칙을 정합니다.

<CardGroup cols={2}>
  <Card title="전역 설정 따름" icon="globe">
    전역 방식과 키를 그대로 사용하며, 화면에 `전역: …` 요약이 표시됩니다.
  </Card>

  <Card title="이 레포만 설정" icon="folder-key">
    저장소의 로컬 Git 설정으로 방식과 키를 따로 지정합니다.
  </Card>
</CardGroup>

**전역으로 되돌리기** 를 누르면 로컬 override가 제거됩니다.
저장소에 연결된 계정이 SSH 키를 가지고 있으면 SSH 방식 선택 시 그 키가 기본 후보로 쓰입니다.

## 서명된 커밋 확인

서명 데이터가 있는 커밋을 선택하면 우측 커밋 상세의 **부모(PARENTS)** 다음에 **서명(SIGNATURE)** 행이 추가되어 `SSH로 서명됨` / `GPG로 서명됨` 이 표시됩니다.
그래프에서도 작성자 이름 왼쪽에 초록 체크 배지가 붙습니다.

<Note>
  이 표시는 커밋에 들어 있는 서명 데이터와 방식을 알려 줄 뿐, 키 신뢰도나 호스트의 Verified 상태를 판정하는 완전한 검증 결과는 아닙니다.
</Note>

<Warning>
  서명 키 파일이나 GPG 실행 파일을 옮기거나 삭제하면 이후 커밋이 실패할 수 있습니다.
  **서명(Signing)** 설정에서 키 목록과 GnuPG 상태를 다시 확인하세요.
</Warning>