SSH 키 보관함

보관함에는 서버에 접속할 때 쓰는 내 SSH 키가 들어 있어요. 키는 기기를 떠나기 전에 그 기기에서 암호화되고, 보관함은 내 기기만 각 기기의 잠금 해제 방식으로 열 수 있어요. tTerm에는 암호화된 키와 각 키의 공개 키, 지문만 보관돼요. tTerm은 보관함을 열 수도, 키를 읽을 수도 없어요. 보관함은 설정 → SSH 키에 있어요.

서버가 내 키로 열리는 방식

Mac용 tTerm에서 내 키 방식으로 옮겼거나, ssh 다음에 나오는 배너에서 내 키 저장을 누른 서버는 내 키로 열려요. 자세한 내용은 클라우드로 옮기기를 보세요. 그런 서버에서 터미널을 열면, tTerm은 보관함이 열려 있는 내 기기, 즉 브라우저나 Mac용 tTerm에 로그인 서명을 요청해요. 기기는 그 키로 SSH 로그인에만 서명하고, 키는 기기 밖으로 나가지 않아요. tTerm은 서명을 쓰기 전에 키의 공개 키로 서명을 확인해요.

보관함 만들기

브라우저에서

설정 → SSH 키에서 파일에서 키 추가를 누르고 개인 키, 즉 .pub이 붙지 않은 파일을 고르세요. 키에 암호 문구가 있으면 입력하고 키 열기를 누르세요. 암호 문구는 이 브라우저에서 키를 여는 데만 쓰이고 어디로도 전송되지 않아요. 키 이름을 정하고 다음을 누르세요.

보관함에 내 키 저장 창에서 Mac이라면 Touch ID로 보관함 만들기, Windows라면 Windows Hello로 보관함 만들기, 그 밖의 기기라면 패스키로 보관함 만들기를 누르세요. 보관함 패스키를 저장할 수 없는 브라우저에는 보관함 만들기가 나와요. 그런 브라우저에서는 복구 코드나 Mac의 승인으로 매번 한 세션 동안만 보관함이 열려요.

Mac용 tTerm에서

보관함은 처음 키를 저장할 때 만들어져요. ‘클라우드로 옮기기’로 저장하거나, ssh 다음에 나오는 배너에서 내 키 저장을 누를 때예요. 보관함에 내 키 저장 창에서 Touch ID로 보관함 만들기를 누르고 Touch ID나 Mac 암호로 확인하세요.

복구 코드

보관함이 만들어지면 바로 tTerm이 복구 코드를 보여 줘요. 글자와 숫자 24개를 4개씩 6묶음으로 나눈 코드예요. 이 코드는 한 번만 보여요. 복사하거나 파일로 저장해서, 보관함을 여는 기기와 떨어진 안전한 곳에 보관하세요. 그 기기를 모두 잃어버리면 이 코드가 키를 되찾는 유일한 방법이에요. tTerm은 키를 대신 복구해 줄 수 없어요. 코드를 보관했다고 체크해야 완료를 누를 수 있어요.

다른 브라우저에서 열기

보관함을 처음 여는 브라우저에서는 이 브라우저에서 키 열기 창에서 보관함을 열어요. 이 창은 설정 → SSH 키에서 열기를 누르거나, 내 키로 열리는 서버를 열면 나타나요.

• Mac용 tTerm에서 승인하기. Mac용 tTerm에서 보관함을 열 수 있으면 창에 그 Mac이 나와요. 여기서 보관함을 열도록 요청하기를 누르세요. Mac에는 어떤 브라우저가 요청하는지, 그 브라우저가 언제 어느 주소에서 로그인했는지 보여 주는 창이 떠요. 두 화면에 6자리 숫자가 나와요. 숫자가 같을 때만 Touch ID로 허용을 누르세요. 제가 아니에요를 누르면 그 브라우저의 로그인이 끝나고, 설정 → 기기에서 그 밖에 확인할 것을 볼 수 있어요. 요청은 5분 동안 유효해요.
• 복구 코드 사용하기. 복구 코드에 코드를 입력하고 열기를 누르세요.

패스키를 저장할 수 있는 브라우저라면, 그다음 tTerm이 패스키를 저장할지 물어요. 저장하면 다음부터는 이 컴퓨터의 잠금 해제 방식으로 보관함이 열려요. Touch ID로 저장(또는 Windows Hello나 패스키로 저장)을 누르거나, 내 컴퓨터가 아니라면 이번만을 누르세요.

브라우저에서 만든 보관함은 Mac용 tTerm에서 처음 한 번은 복구 코드로 열어요. 설정 → SSH 키에서 복구 코드로 열기를 누르세요. 그다음부터는 그 Mac에서 Touch ID나 Mac 암호로 열려요.

다시 잠기는 때

• 브라우저에서 – 8시간 동안 아무 활동이 없을 때, tTerm Web을 닫거나 새로 고칠 때, 로그아웃할 때, 설정 → SSH 키에서 잠그기를 누를 때 잠겨요.
• Mac용 tTerm에서 – tTerm이 실행되는 동안 잠그기를 누르거나 로그아웃할 때까지 열려 있어요. 로그아웃하면 이 Mac은 보관함을 직접 열 수 없게 돼요. 다시 로그인한 뒤에는 복구 코드로 한 번 열어야 해요.

설정 → SSH 키

맨 위에는 이곳에서 보관함이 열려 있는지, 어떻게 열었는지, 언제 다시 잠기는지가 나와요. 키마다 한 줄이 있어요. 이름, 종류, 짧은 지문이 나오고, 여는 서버 뒤에 그 키로 여는 서버가 나오거나 아직 이 키로 여는 서버가 없어요가 나와요. Mac에서 저장했는지 파일에서 추가했는지와 그 날짜, 마지막으로 사용한 때 또는 아직 사용 안 함도 나와요.

• 제거를 누르면 확인을 거친 뒤 키가 보관함에서 빠지고, tTerm은 암호화된 사본을 삭제해요. 그 키로 열리던 서버는 tTerm에 남지만 더 이상 열리지 않아요. 키 원본은 원래 있던 곳, 즉 내 Mac이나 키 파일에 그대로 남아요.
• 새 복구 코드 만들기를 누르면 새 코드가 한 번 표시되고, 이전 코드는 더 이상 쓸 수 없어요. 키와 기기는 그대로예요. 이때 Touch ID나 이 브라우저의 패스키로 확인하는데, 보관함 패스키가 없는 브라우저에서는 현재 복구 코드를 물어요. 현재 코드를 잃어버렸나요? Mac용 tTerm에서 새 코드를 만드세요.
• 파일에서 키 추가는 브라우저에만 있어요. Mac용 tTerm에서는 ‘클라우드로 옮기기’와 ssh 다음에 나오는 배너로 키를 저장해요.

키 목록 아래에는 보관함이 열리는 곳이 나와요. 보관함을 직접 열 수 있는 Mac과 브라우저가 하나하나 나오고, 그런 곳이 없으면 이렇게 나와요: 보관함은 복구 코드로만 열려요.

저장할 수 있는 키

Ed25519, ECDSA P-256과 P-384, RSA 키예요. DSA와 ECDSA P-521 키는 저장할 수 없고, 보안 키에 들어 있어서 밖으로 꺼낼 수 없는 키(sk-…)도 저장할 수 없어요. 이런 키를 쓰는 서버는 Mac을 경유해 열려요.

브라우저는 OpenSSH 자체 형식의 키(암호 문구가 있어도 돼요)나 암호 문구가 없는 PEM 형식의 키(PKCS#8, PKCS#1)를 읽어요. 파일 하나에 키 하나만 있어야 해요. 암호 문구가 있는 PEM 파일은 먼저 ssh-keygen -p -f 뒤에 파일을 지정해 OpenSSH 형식으로 바꾸세요. Mac용 tTerm은 OpenSSH 형식의 키를 읽어요.

어떤 브라우저는 Ed25519 키로 서명하지 못해요. 그런 브라우저에서는 설정 → SSH 키에 그렇다고 나오고, 이런 키를 쓰는 서버는 최신 브라우저나 Mac용 tTerm에서 열려요.

보관함을 기다리는 서버

보관함이 열려 있는 기기가 하나도 없으면, 내 키를 쓰는 서버의 터미널은 보관함이 열릴 때까지 얼마든지 기다리며 web-01 서버는 내 키로 열려요라고 표시해요.

• 패스키를 저장한 브라우저에서는 Touch ID로 열기, Windows Hello로 열기, 패스키로 열기 중 하나를 누르세요.
• 다른 브라우저에서는 내 Mac 이름이 들어간 …에서 승인이나 복구 코드 사용을 누르세요.
• Mac용 tTerm에서는 Touch ID로 열기를 누르세요. 아직 보관함을 직접 열 수 없는 Mac이라면 복구 코드 사용을 누르세요.

보관함이 열리면 터미널에 내 키로 web-01 서버에 로그인하는 중… 문구가 나온 뒤 저절로 열려요.