개발 서버에 SSH 키 등록하고 접속 관리하기

개발 서버에 SSH 키 등록하고 접속 관리하기

 

개발자로서 서버에 안전하게 접속하는 것은 일상적인 작업 중 하나입니다.

특히 원격 서버 관리와 코드 배포 과정에서 SSH(Secure Shell) 프로토콜은 필수적인 도구로 자리잡았습니다.

이 글에서는 개발 서버에 SSH 키를 생성하고 등록하는 방법부터 접속 관리를 효율적으로 하는 방법까지 상세히 알아보겠습니다.

안전하고 편리한 서버 접속 환경을 구축하면 개발 생산성이 크게 향상됩니다.

비밀번호 입력 없이 자동 로그인이 가능해지고, 보안 수준도 높아지기 때문입니다.

특히 여러 서버를 관리하는 DevOps 엔지니어나 백엔드 개발자에게는 SSH 키 관리 능력이 필수적인 역량입니다.

SSH 프로토콜의 이해와 중요성

SSH는 Secure Shell의 약자로, 네트워크 상의 다른 컴퓨터에 로그인하거나 원격 시스템에서 명령을 실행하고 파일을 전송할 수 있게 해주는 암호화된 네트워크 프로토콜입니다. 일반 텍스트 비밀번호 대신 공개키 암호화 방식을 사용하여 강력한 보안을 제공합니다.

SSH가 중요한 이유는 다음과 같습니다:

1. 보안성: 모든 통신이 암호화되어 진행되므로 중간자 공격(man-in-the-middle attack)이나 스니핑으로부터 안전합니다.
2. 인증 메커니즘: 비밀번호 방식보다 더 안전한 공개키/개인키 인증 방식을 제공합니다.
3. 자동화 가능: 스크립트와 배포 파이프라인에서 자동화된 접속이 가능합니다.
4. 포트 포워딩: 로컬 포트를 원격 서버의 포트로 포워딩할 수 있어 보안 터널 생성이 가능합니다.

개발 환경에서는 이러한 SSH의 특성을 활용하여 지속적 통합/배포(CI/CD) 파이프라인 구축, 원격 서버 관리, 데이터베이스 접속 등 다양한 작업을 안전하게 수행할 수 있습니다.

SSH 키 생성하기: 공개키와 개인키의 이해

SSH 키 인증 시스템은 공개키(public key)와 개인키(private key)의 쌍으로 구성됩니다. 개인키는 절대 공유해서는 안 되는 비밀 정보이며, 공개키는 접속하고자 하는 모든 서버에 등록됩니다.

SSH 키 생성 명령어

리눅스나 macOS에서는 터미널을 열고 다음 명령어로 SSH 키 쌍을 생성할 수 있습니다:

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

각 옵션의 의미는 다음과 같습니다:

• -t rsa: RSA 암호화 알고리즘을 사용합니다.
• -b 4096: 4096비트 키 길이를 지정합니다(보안 강화).
• -C "your_email@example.com": 키를 식별하기 위한 주석을 추가합니다.

최근에는 Ed25519 알고리즘이 더 안전하고 효율적이라고 알려져 있어 다음과 같이 생성하는 것도 좋은 방법입니다:

ssh-keygen -t ed25519 -C "your_email@example.com"

키 생성 과정 상세 설명

명령어를 실행하면 다음과 같은 과정이 진행됩니다:

1. 키 저장 위치 지정 (기본값: ~/.ssh/id_rsa 또는 ~/.ssh/id_ed25519)특별한 이유가 없다면 기본 위치를 사용하는 것이 좋습니다.
2. Enter file in which to save the key (/Users/yourusername/.ssh/id_ed25519):
3. 비밀번호(passphrase) 설정비밀번호를 설정하면 개인키 사용 시 추가 보안 계층이 생깁니다. 로컬 장치가 탈취되더라도 개인키 사용을 위해서는 비밀번호가 필요합니다.
4. Enter passphrase (empty for no passphrase): Enter same passphrase again:
5. 키 생성 완료
6. Your identification has been saved in /Users/yourusername/.ssh/id_ed25519 Your public key has been saved in /Users/yourusername/.ssh/id_ed25519.pub

이제 두 개의 파일이 생성됩니다:

• id_ed25519 (또는 id_rsa): 개인키 파일로, 절대 공유해서는 안 됩니다.
• id_ed25519.pub (또는 id_rsa.pub): 공개키 파일로, 서버에 등록할 키입니다.

서버에 SSH 공개키 등록하기

생성한 SSH 공개키를 서버에 등록하면 비밀번호 없이 접속할 수 있게 됩니다. 등록 방법은 여러 가지가 있습니다.

방법 1: ssh-copy-id 명령어 사용하기

가장 간단한 방법은 ssh-copy-id 명령어를 사용하는 것입니다:

ssh-copy-id username@remote_host

이 명령은 로컬의 ~/.ssh/id_*.pub 공개키를 원격 서버의 ~/.ssh/authorized_keys 파일에 자동으로 추가합니다. 처음 실행 시에는 서버 계정의 비밀번호를 입력해야 합니다.

특정 키 파일을 지정하려면 다음과 같이 사용합니다:

ssh-copy-id -i ~/.ssh/custom_key.pub username@remote_host

방법 2: 수동으로 공개키 등록하기

ssh-copy-id가 사용 불가능한 환경이라면 수동으로 등록할 수 있습니다:

1. 먼저 공개키 내용을 확인합니다:
2. cat ~/.ssh/id_ed25519.pub
3. 출력된 내용을 복사합니다.
4. SSH로 서버에 접속합니다 (아직 비밀번호 필요):
5. ssh username@remote_host
6. 서버에 .ssh 디렉토리가 없다면 생성합니다:
7. mkdir -p ~/.ssh chmod 700 ~/.ssh
8. authorized_keys 파일에 공개키를 추가합니다:
9. echo '복사한_공개키_내용' >> ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys

방법 3: 클라우드 서비스 사용 시 키 등록

AWS, GCP, Azure 등의 클라우드 서비스를 사용한다면 웹 콘솔에서 SSH 키를 등록할 수 있습니다:

• AWS EC2: 인스턴스 생성 시 키 페어를 선택하거나 생성할 수 있습니다.
• GCP Compute Engine: 메타데이터 섹션에서 SSH 키를 등록할 수 있습니다.
• Azure Virtual Machines: 가상 머신 설정에서 SSH 공개키를 등록할 수 있습니다.

SSH 구성 파일로 접속 관리하기

여러 서버에 자주 접속한다면 매번 긴 명령어를 입력하는 것은 비효율적입니다. SSH 구성 파일을 사용하면 별칭과 설정을 저장하여 효율적으로 접속을 관리할 수 있습니다.

SSH 구성 파일 위치와 기본 구조

SSH 클라이언트 구성 파일은 ~/.ssh/config에 위치합니다. 파일이 없다면 직접 생성할 수 있습니다:

touch ~/.ssh/config
chmod 600 ~/.ssh/config

구성 파일의 기본 구조는 다음과 같습니다:

Host 별칭
    HostName 실제_호스트명_또는_IP
    User 사용자이름
    Port 포트번호
    IdentityFile ~/.ssh/특정_개인키_경로
    # 기타 옵션들...

구체적인 설정 예시

여러 서버 설정을 구성 파일에 추가하는 예시입니다:

# 개발 서버
Host dev
    HostName dev.example.com
    User developer
    Port 22
    IdentityFile ~/.ssh/id_ed25519
    ForwardAgent yes

# 스테이징 서버
Host staging
    HostName 203.0.113.10
    User deployer
    Port 2222
    IdentityFile ~/.ssh/staging_key

# 프로덕션 서버 (점프 호스트 경유)
Host prod
    HostName prod-internal.example.com
    User admin
    ProxyJump jumphost.example.com
    IdentityFile ~/.ssh/prod_key
    ServerAliveInterval 60

이제 다음과 같이 간단하게 접속할 수 있습니다:

ssh dev    # 개발 서버에 접속
ssh staging  # 스테이징 서버에 접속
ssh prod   # 프로덕션 서버에 접속

유용한 SSH 구성 옵션들

자주 사용되는 SSH 구성 옵션에 대해 알아보겠습니다:

• ForwardAgent yes: SSH 에이전트 포워딩을 활성화합니다. 로컬의 SSH 키를 원격 서버에서도 사용할 수 있게 합니다.
• ProxyJump: 점프 호스트를 통해 내부 네트워크의 서버에 접속할 때 사용합니다.
• ServerAliveInterval: 지정된 초 간격으로 서버에 메시지를 보내 연결을 유지합니다.
• ServerAliveCountMax: 서버로부터 응답이 없을 때 연결을 종료하기 전에 허용할 메시지 수입니다.
• AddKeysToAgent yes: 비밀번호로 보호된 키를 SSH 에이전트에 자동으로 추가합니다.
• Compression yes: 느린 네트워크 연결에서 데이터 압축을 활성화합니다.

SSH 보안 강화하기: 실전 팁과 주의사항

SSH 접속의 보안을 강화하기 위한 중요한 팁과 주의사항을 살펴보겠습니다.

1. 비밀번호 인증 비활성화

키 기반 인증이 설정되었다면 비밀번호 인증을 비활성화하여 무차별 대입 공격을 방지할 수 있습니다. 서버의 /etc/ssh/sshd_config 파일을 수정합니다:

PasswordAuthentication no
ChallengeResponseAuthentication no
UsePAM no

변경 후 SSH 서비스를 재시작합니다:

sudo systemctl restart sshd

2. 루트 로그인 비활성화

직접적인 루트 로그인을 비활성화하고 대신 일반 사용자로 로그인 후 필요시 sudo를 사용하는 것이 안전합니다:

PermitRootLogin no

3. SSH 포트 변경

기본 22번 포트는 자동화된 공격의 주요 대상이 됩니다. 다른 포트로 변경하면 기본적인 포트 스캔 공격을 피할 수 있습니다:

Port 22123

4. 로그인 시도 제한

Fail2Ban과 같은 도구를 사용하여 반복된 로그인 실패 시 IP를 차단할 수 있습니다:

sudo apt install fail2ban
sudo systemctl enable fail2ban
sudo systemctl start fail2ban

5. 키 비밀번호(passphrase) 사용

SSH 키 생성 시 비밀번호를 설정하면 키 파일이 노출되더라도 추가 보호 계층이 있습니다. SSH 에이전트를 사용하면 세션 동안 한 번만 비밀번호를 입력해도 됩니다:

eval $(ssh-agent)
ssh-add ~/.ssh/id_ed25519

6. 주기적인 키 순환(rotation)

보안을 위해 주기적으로 SSH 키를 교체하는 것이 좋습니다. 특히 조직에서 인력 변동이 있을 때 중요합니다.

SSH 키 관리와 백업

SSH 키는 개발자의 디지털 자산이므로 적절한 관리와 백업이 필요합니다.

여러 기기에서 동일한 키 사용하기

개발자가 여러 기기에서 작업할 경우, 동일한 SSH 키를 사용하려면:

1. 개인키를 암호화하여 안전하게 전송:
2. tar czf - ~/.ssh | gpg -c > ssh_backup.tar.gz.gpg
3. 새 기기에서 복원:
4. gpg -d ssh_backup.tar.gz.gpg | tar xzf - -C ~/

또는 기기마다 다른 키를 생성하고 필요한 서버에 모두 등록할 수도 있습니다.

SSH 키 백업 전략

SSH 키 백업을 위한 몇 가지 방법:

1. 암호화된 외부 저장소: 비밀번호로 보호된 ZIP 파일 등으로 외부 드라이브에 저장
2. 비밀 관리 도구: LastPass, 1Password 등의 보안 노트 기능 활용
3. 물리적 백업: 중요한 키는 암호화하여 USB 드라이브에 저장하고 안전한 장소에 보관

백업 시에는 반드시 개인키를 암호화하여 보호해야 합니다.

SSH 인증 에이전트 활용하기

SSH 인증 에이전트는 SSH 키를 메모리에 로드하여 필요할 때마다 비밀번호를 다시 입력하지 않도록 합니다.

SSH 에이전트 시작 및 키 추가

# SSH 에이전트 시작
eval $(ssh-agent)

# 키 추가
ssh-add ~/.ssh/id_ed25519

키에 비밀번호가 설정되어 있다면 이때 한 번만 입력하면 됩니다.

SSH 에이전트 포워딩

에이전트 포워딩을 사용하면 원격 서버에서도 로컬 SSH 키를 사용할 수 있습니다. 이는 원격 서버에서 다른 서버로 접속하거나 Git 작업을 할 때 유용합니다:

Host dev
    HostName dev.example.com
    ForwardAgent yes

보안상의 이유로 신뢰할 수 있는 서버에서만 에이전트 포워딩을 활성화하는 것이 좋습니다.

SSH 에이전트 자동 시작

리눅스에서는 .bashrc 또는 .zshrc에 다음 내용을 추가하여 자동으로 에이전트를 시작할 수 있습니다:

# SSH 에이전트 자동 시작
if [ -z "$SSH_AUTH_SOCK" ]; then
   eval $(ssh-agent -s)
   ssh-add ~/.ssh/id_ed25519 2>/dev/null
fi

SSH를 활용한 개발 워크플로우 최적화

SSH를 효과적으로 활용하면 개발 워크플로우를 크게 개선할 수 있습니다.

파일 전송 및 동기화

scp와 rsync를 사용하여 파일을 쉽게 전송할 수 있습니다:

# 단일 파일 전송
scp local_file.txt dev:~/uploads/

# 디렉토리 동기화 (변경된 파일만)
rsync -avz -e ssh ~/project/ dev:~/project/

SSH 구성 파일의 별칭을 그대로 사용할 수 있어 편리합니다.

원격 포트 포워딩

로컬에서 원격 서버의 서비스에 접근할 때 유용합니다:

# 원격 서버의 MySQL을 로컬 3307 포트로 연결
ssh -L 3307:localhost:3306 dev

이제 localhost:3307로 접속하면 원격 서버의 MySQL에 접속됩니다.

로컬 포트 포워딩

원격 서버에서 로컬 개발 서버에 접근할 때 유용합니다:

# 로컬 8080 포트를 원격 서버의 80 포트로 포워딩
ssh -R 8080:localhost:80 dev

VS Code Remote Development

VS Code의 Remote Development 확장을 사용하면 SSH를 통해 원격 서버에서 직접 코드를 편집할 수 있습니다. SSH 구성 파일의 설정을 그대로 활용할 수 있어 편리합니다.

SSH 접속 문제 해결하기

SSH 접속 시 발생할 수 있는 일반적인 문제와 해결책을 알아보겠습니다.

디버깅 모드로 접속하기

연결 문제의 원인을 파악하기 위해 디버깅 모드를 활용할 수 있습니다:

ssh -vvv username@remote_host

-v, -vv, -vvv 옵션은 상세 수준을 증가시킵니다.

일반적인 오류와 해결 방법

1. Permission denied (publickey):
   • 공개키가 서버의 authorized_keys에 올바르게 등록되어 있는지 확인
   • 개인키 파일의 권한이 600인지 확인 (chmod 600 ~/.ssh/id_ed25519)
   • SSH 에이전트에 키가 로드되어 있는지 확인 (ssh-add -l)
2. Connection refused:
   • 서버의 SSH 서비스가 실행 중인지 확인
   • 방화벽이 SSH 포트를 차단하고 있는지 확인
   • 올바른 포트를 사용하고 있는지 확인
3. Host key verification failed:
   • 서버의 호스트 키가 변경되었을 경우 발생
   • 신뢰할 수 있는 변경이라면: ssh-keygen -R hostname 명령으로 알려진 호스트 목록에서 제거 후 다시 접속
4. Bad permissions:
   • SSH 구성 파일과 키 파일의 권한이 너무 개방적인 경우 발생
   • chmod 700 ~/.ssh 및 chmod 600 ~/.ssh/* 명령으로 권한 수정

고급 SSH 활용: Git, CI/CD, 컨테이너와의 통합

SSH는 다양한 개발 도구와 통합하여 사용할 수 있습니다.

Git과 SSH 통합

Git에서 SSH를 사용하면 매번 비밀번호를 입력하지 않고도 리포지토리에 접근할 수 있습니다:

# HTTPS에서 SSH로 원격 저장소 URL 변경
git remote set-url origin git@github.com:username/repository.git

# SSH 키가 GitHub에 등록되어 있는지 테스트
ssh -T git@github.com

CI/CD 파이프라인에서 SSH 키 사용

Jenkins, GitLab CI 등의 CI/CD 도구에서 SSH 키를 사용하여 자동화된 배포를 구현할 수 있습니다:

1. CI/CD 시스템에 배포용 SSH 키 등록
2. 파이프라인 스크립트에서 SSH 명령어로 서버에 접속하여 배포 수행

예를 들어, GitLab CI에서는 다음과 같이 설정할 수 있습니다:

deploy:
  stage: deploy
  script:
    - eval $(ssh-agent -s)
    - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -
    - ssh -o StrictHostKeyChecking=no deployer@example.com "cd /var/www/app && git pull && npm install && pm2 restart app"

Docker 컨테이너와 SSH

Docker 컨테이너에서 SSH를 사용하여 외부 서비스에 접속할 때는 SSH 키를 볼륨으로 마운트하는 것이 좋습니다:

docker run -v ~/.ssh:/home/user/.ssh:ro image_name

결론: 효율적인 SSH 키 관리의 중요성

효율적인 SSH 키 관리는 개발자의 생산성과 시스템 보안에 큰 영향을 미칩니다. 이 글에서 다룬 내용을 요약하면:

1. SSH 키를 사용하면 비밀번호 없이 안전하게 서버에 접속할 수 있습니다.
2. SSH 구성 파일을 통해 여러 서버 접속을 간편하게 관리할 수 있습니다.
3. 적절한 보안 설정으로 SSH 접속의 안전성을 크게 향상시킬 수 있습니다.
4. SSH 에이전트와 포워딩을 활용하면 복잡한 개발 환경에서도 원활하게 작업할 수 있습니다.
5. Git, CI/CD, 컨테이너 등 다양한 개발 도구와 SSH를 통합하여 자동화된 워크플로우를 구축할 수 있습니다.

개발자로서 SSH 키 관리는 단순한 기술적 지식을 넘어 일상적인 개발 생산성과 보안에 직결되는 중요한 역량입니다.

이 글에서 소개한 방법들을 활용하여 더 안전하고 효율적인 개발 환경을 구축하시기 바랍니다.

마지막으로, SSH 키 관리는 주기적인 점검과 업데이트가 필요한 지속적인 프로세스라는 점을 기억하세요.

정기적으로 키를 갱신하고, 불필요한 접근 권한은 제거하며, 보안 모범 사례를 따르는 것이 중요합니다.