리눅스 PC에서 계정에 로그인할 때 휴대폰의 인증 앱을 찾느라 흐름이 끊길 수 있습니다. Keysmith는 KDE가 만든 일회용 인증 코드 앱으로, 등록한 계정의 2단계 인증 코드를 화면에서 확인하도록 돕습니다. 공식 Flathub 설치 경로와 계정 등록 전 확인할 점, 코드 읽는 방법, 새 기기로 옮길 때 주의할 점을 정리했습니다.
Keysmith 2단계 인증 코드 무료 다운로드·설치 안내
계정별 2단계 인증 코드를 한 화면에서 확인합니다
Keysmith는 KDE가 제공하는 2단계 인증 코드 생성 앱입니다. 온라인 계정의 비밀번호를 입력한 다음 별도 인증을 요구할 때 사용하는 시간 기반 TOTP와 횟수 기반 HOTP를 지원합니다. 이 앱을 설치하는 것만으로 모든 사이트의 2단계 인증이 켜지는 것은 아닙니다. 먼저 해당 사이트의 보안 설정에서 인증 앱을 등록해야 코드가 로그인에 쓰입니다.
공식 Flathub 화면에는 Mastodon과 ProtonMail이라는 예시 서비스 아래 계정 이름과 여섯 자리 숫자가 놓여 있습니다. 일부 코드 아래에는 남은 시간을 가늠할 수 있는 진행 막대가 보이고, 화면 아래의 더하기 단추로 계정을 추가하는 구조입니다. 이 숫자는 소개용 예시이므로 입력하거나 공유할 실제 인증 코드가 아닙니다. 실제 화면에서는 본인이 등록한 서비스와 계정 이름을 먼저 대조하세요.
KDE 공식 소개 페이지는 Linux 설치와 Flathub 이동 경로를 제공합니다. Flathub의 현재 앱 데이터는 버전 26.08.3, 개발자 KDE, 무료 배포와 GPL-3.0-or-later 라이선스를 표시합니다. KDE 소개 페이지의 릴리스 목록에도 26.08.3이 표시됩니다. 설치 전에 앱 ID org.kde.keysmith를 확인하면 비슷한 이름의 앱과 구별하기 쉽습니다.
계정을 추가할 때는 로그인하려는 서비스가 제공하는 설정 방법을 따르세요. 서비스에 따라 QR 코드나 수동 입력용 설정 키를 보여 줍니다. KDE는 Keysmith의 otpauth 주소 처리와 계정 QR 가져오기 기능을 발표했지만, 모든 서비스의 등록 화면이 같지는 않습니다. 사용 중인 서비스가 보여 주는 계정 이름과 발급자를 확인하고, 등록 확인 단계에서 새로 생성된 코드가 받아들여지는지 시험하는 것이 중요합니다.
일회용 코드는 비밀번호를 대신해 공개해도 되는 숫자가 아닙니다. 화면을 공유하거나 캡처할 때 코드와 설정 키가 보이지 않게 하고, 서비스가 제공하는 복구 코드도 별도 안전한 곳에 보관하세요. 기기를 바꾸거나 앱을 지우기 전에 해당 서비스에서 다른 인증 수단과 복구 방법이 준비됐는지 확인해야 계정 잠금을 피할 수 있습니다. 앱을 설치했다는 사실만으로 복구 수단이 생기는 것은 아닙니다.
코드가 맞지 않으면 새 코드가 표시될 때 다시 입력해 보고, 먼저 선택한 서비스와 계정이 맞는지 확인하세요. 시간 기반 코드는 기기의 시각 설정에 영향을 받을 수 있으므로 시스템 시간이 정확한지도 살펴봅니다. 여러 계정의 숫자를 한 번에 복사해 기록하는 방식은 피하고, 로그인 창에서 요구하는 계정의 현재 코드만 사용하세요. 인증 요청이 본인이 시작한 로그인인지도 확인하는 편이 좋습니다.
공식 화면에서 계정 이름과 일회용 코드를 확인합니다
공식 Flathub 예시 화면에는 계정별 여섯 자리 코드, 진행 막대와 계정 추가 단추가 보입니다. 화면의 계정과 숫자는 예시입니다.
Keysmith 2단계 인증 코드 무료 다운로드·설치 안내
| 프로그램 | Keysmith |
| 개발 | KDE |
| 확인한 버전 | Flathub 26.08.3 |
| 지원 환경 | Linux Flatpak · x86_64 / aarch64 |
| 가격 | 무료 · GPL-3.0-or-later |
| 주요 용도 | 계정별 TOTP·HOTP 일회용 코드 확인 |
KDE가 연결한 Flathub에서 Keysmith 26.08.3을 확인합니다
KDE의 Keysmith 공식 페이지에서 Linux용 Flathub 항목을 열면 개발자가 KDE이고 앱 ID가 org.kde.keysmith인지 확인할 수 있습니다. Flathub 앱 데이터는 안정 버전 26.08.3과 무료 배포를 표시합니다. KDE 소개 페이지의 릴리스 목록과 Flathub 앱 데이터가 모두 26.08.3을 표시합니다.
Flathub 목록에는 Linux x86_64와 aarch64가 표시됩니다. 사용하는 배포판에 Flatpak과 Flathub이 준비돼 있다면 공식 앱 항목에서 설치하고, 앱 목록에서 Keysmith를 엽니다. 배포판 패키지 관리자를 이용할 수도 있지만 버전이 다를 수 있습니다. 공식 앱 ID와 개발자를 확인하지 못했다면 이름만 보고 설치하지 마세요.
- KDE 공식 Keysmith 페이지가 연결하는 Flathub 항목을 엽니다.
- org.kde.keysmith, 개발자 KDE, Linux 지원과 26.08.3 버전을 대조합니다.
- 공식 항목에서 설치하고 앱 목록에서 Keysmith를 엽니다.
서비스의 2단계 인증 설정에서 계정을 등록합니다
Keysmith를 열었을 때 계정 목록이 비어 있다면 먼저 사용하려는 서비스의 보안 설정으로 이동하세요. 그 서비스가 인증 앱 등록을 지원하는지 확인하고, 안내하는 QR 코드 또는 수동 설정 정보를 준비합니다. Keysmith 화면 아래의 계정 추가 단추를 눌러 등록 흐름을 시작합니다. 화면에 잠금 해제 단계가 나오면 본인이 설정한 방법으로 진행합니다.
서비스 이름과 계정 이름을 잘못 묶으면 로그인할 때 다른 계정의 숫자를 입력하기 쉽습니다. 등록 화면에 발급자나 계정 이름을 넣는 항목이 있다면 서비스의 안내와 일치시켜 주세요. 설정 키는 코드 생성의 근거가 되는 비밀 값이므로 채팅이나 공개 문서에 붙여 넣지 마세요. 서비스가 최종 확인 코드를 요구하면 Keysmith에서 방금 추가한 계정의 현재 코드를 사용해 등록을 완료합니다.
KDE는 과거 릴리스에서 otpauth 주소의 처리 기능을 소개했고, 2025년에는 QR 코드의 otpauth 주소로 계정을 가져오는 기능도 발표했습니다. 다만 데스크톱에서 저장된 QR 이미지 파일을 직접 선택하는 기능까지 이 자료로 확인되지는 않습니다. 화면에 제공되는 방법만 사용하고, 이미지 파일 가져오기가 보이지 않는 경우 서비스가 제공하는 수동 설정 방식을 확인하세요.
- 사용할 서비스의 보안 설정에서 인증 앱 등록 화면을 엽니다.
- Keysmith에서 계정 추가 단추를 누르고 서비스가 제공한 정보를 안내에 맞게 입력합니다.
- 서비스의 확인 단계에서 새 계정의 현재 코드를 입력해 등록을 마칩니다.
로그인할 계정의 현재 코드를 읽어 입력합니다
서비스에 비밀번호를 입력하고 일회용 코드를 요청받았다면 Keysmith에서 같은 서비스와 계정 이름을 찾습니다. 공식 예시 화면처럼 계정마다 숫자가 따로 표시됩니다. 이름을 먼저 확인한 뒤 현재 숫자를 로그인 창에 입력하세요. 여러 계정이 있을 때는 첫 번째로 보이는 숫자를 그대로 쓰면 다른 계정 코드일 수 있습니다.
시간 기반 코드의 진행 막대가 끝에 가까우면 숫자가 바뀐 뒤 새 코드를 입력하는 편이 낫습니다. 숫자를 입력하는 도중 만료되면 서비스가 거절할 수 있습니다. HOTP처럼 횟수 기반 방식은 서비스와 앱이 같은 순서로 코드를 사용해야 하므로, 서비스에서 요구하지 않은 코드를 반복 생성하지 않도록 주의하세요. 계정 등록 방식은 서비스 안내를 우선합니다.
로그인 성공까지 확인하면 기본 작업이 끝납니다. 이후에는 서비스에서 같은 계정의 코드가 필요할 때 Keysmith를 열어 확인하면 됩니다. 공동 PC에서는 앱 화면을 열어 둔 채 자리를 비우지 말고, 화면 공유 중에는 코드가 보이지 않게 하세요. 사용하지 않는 계정을 지울 때도 서비스에 등록된 인증 수단을 먼저 정리해야 다음 로그인에서 막히지 않습니다.
- 로그인 창과 Keysmith 목록의 서비스·계정 이름을 대조합니다.
- 현재 표시된 일회용 코드를 입력하고, 만료가 가까우면 새 코드를 기다립니다.
- 로그인 완료를 확인하고 코드 화면을 닫습니다.
코드가 맞지 않거나 기기를 바꿀 때 확인합니다
코드가 거절되면 먼저 서비스와 계정 이름을 다시 보세요. 예전 계정이나 다른 프로필에 등록한 숫자일 수 있습니다. 시간 기반 코드라면 시스템 시각과 시간대가 정상인지 확인하고 새 코드로 다시 시도합니다. 계속 실패한다면 등록 때 제공된 설정 정보를 잘못 입력했을 가능성도 있으므로 서비스의 2단계 인증 재설정 절차를 확인하세요.
기기를 바꾸거나 Linux 환경을 새로 설치하기 전에 서비스별 복구 코드를 확보하고, 다른 인증 수단이 실제로 작동하는지 확인하세요. Keysmith의 공식 프로젝트 소개만으로 계정 백업과 복원 기능의 제공 여부를 보증할 수 없으므로 자동 이전을 전제로 하면 곤란합니다. 필요한 경우 서비스의 계정 보안 설정에서 새 기기를 등록하고 기존 등록을 정리하는 순서로 진행합니다.
인증 코드가 누구에게나 보이도록 화면 캡처를 올리거나, 설정 키를 이메일에 평문으로 보내지 마세요. 서비스가 예상치 못한 로그인 승인을 요구한다면 코드가 떠 있다는 이유만으로 입력하지 말고 접속 주소와 요청 내용을 확인하세요. 프로그램은 코드를 보여 주는 도구이고, 계정 보안과 복구 절차는 서비스 설정에 달려 있습니다.
- 거절된 코드의 서비스·계정 이름과 남은 시간을 다시 확인합니다.
- 기기 시각을 점검하고 새 코드를 한 번 더 입력합니다.
- 계속 실패하면 서비스의 복구 코드 또는 인증 수단 재설정 안내를 따릅니다.
자주 묻는 질문
Keysmith는 무료인가요?
KDE가 개발했으며 Flathub에서 무료로 배포합니다. Flathub에는 GPL-3.0-or-later 라이선스가 표시됩니다.
어떤 Linux 환경에서 설치하나요?
Flathub은 x86_64와 aarch64용 Linux Flatpak을 표시합니다. 배포판의 Flatpak·Flathub 준비 상태를 확인하세요.
Keysmith를 설치하면 2단계 인증이 바로 켜지나요?
아닙니다. 각 서비스의 보안 설정에서 인증 앱을 등록하고 확인 코드를 입력해야 합니다.
QR 코드 이미지 파일을 바로 가져올 수 있나요?
KDE는 QR의 otpauth 주소 가져오기를 발표했지만 저장된 이미지 파일 선택까지 확인된 것은 아닙니다. 앱의 현재 화면과 서비스의 수동 설정 방법을 확인하세요.
기기를 바꾸면 기존 계정이 자동으로 옮겨지나요?
자동 이전을 전제로 하지 마세요. 서비스의 복구 코드와 다른 인증 수단을 확인한 뒤 새 기기 등록 절차를 따르세요.
첫 계정을 등록하고 로그인까지 확인하세요
Keysmith를 설치했다면 먼저 한 서비스의 2단계 인증 설정에서 계정을 추가하고, 그 서비스가 요구하는 확인 코드로 등록을 마치세요. 다음 로그인에서 같은 서비스와 계정을 찾아 현재 숫자를 입력해 보면 앱의 기본 작업을 확인할 수 있습니다. 설정 키와 복구 코드는 공개하지 말고 별도로 안전하게 보관하세요.
공식 자료와 확인일
KDE Keysmith 공식 앱·릴리스 · Keysmith 공식 Flathub 배포 · Keysmith Flathub 버전 데이터 · KDE Keysmith 소스 · KDE의 계정 QR 가져오기 발표 | 2026-11-13T13:18:18.174135+00:00
Keysmith 2단계 인증 코드 무료 다운로드·설치 안내
