From 0aeb2cbbf79340038a34f56ce7964b01f57be14c Mon Sep 17 00:00:00 2001 From: AI-Dico <248385067+AI-Dico@users.noreply.github.com> Date: Mon, 19 Oct 2026 23:39:14 +0900 Subject: [PATCH] =?UTF-8?q?docs(windows):=20SSH=20=ED=82=A4=20=EC=84=B8?= =?UTF-8?q?=EC=85=98=20=EC=95=88=EB=82=B4=EB=A5=BC=20=EB=B9=84=EB=B0=80?= =?UTF-8?q?=EB=B2=88=ED=98=B8=EB=A1=9C=20=EC=8B=9C=EC=9E=91=ED=95=9C=20?= =?UTF-8?q?=ED=94=84=EB=A1=9C=EC=84=B8=EC=8A=A4=EB=A1=9C=20=EB=B0=94?= =?UTF-8?q?=EA=BE=BC=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit SSH 키 세션에서 Credential Manager 가 없을 때의 안내가 "비밀번호로 SSH 접속"을 권했는데, Microsoft 계정에서는 비밀번호가 맞아도 sshd 가 거부했다(0xC000006A). 대신 Windows 비밀번호로 시작한 프로세스 (Start-Process -Credential)에서 실행하라고 안내한다. 이 경로는 SSH 키 세션에서 kc doctor 가 항목·기기 모두 정상으로 나오는 것을 실측했다. 오류 힌트와 README 8개 언어판을 함께 고친다. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_018mXEnCmZq9pJDC84dnrvcD --- README.de.md | 5 ++++- README.es.md | 5 ++++- README.fr.md | 5 ++++- README.ja.md | 5 ++++- README.ko.md | 7 +++++-- README.md | 5 ++++- README.zh-Hans.md | 4 +++- README.zh-Hant.md | 4 +++- crates/kc-store/src/backend/keyring.rs | 3 ++- 9 files changed, 33 insertions(+), 10 deletions(-) diff --git a/README.de.md b/README.de.md index 4158029..a27763d 100644 --- a/README.de.md +++ b/README.de.md @@ -191,7 +191,10 @@ blockiert ist. Siehe die [Sicherheitsgrenzen](docs/SECURITY.md). dem Anmeldepasswort des Mac). - **Windows: `no Credential Manager logon session`.** In einer SSH-Sitzung, die sich mit einem Schlüssel angemeldet hat, gibt es keine Anmeldeinformationsverwaltung. Führe kc - in einer Desktop-Sitzung aus oder verbinde dich per SSH mit einem Passwort. + in einer Desktop-Sitzung aus oder in einem Prozess, der mit deinem Windows-Passwort + gestartet wurde (zum Beispiel mit `Start-Process -Credential` in PowerShell); er bekommt + eine vollständige Anmeldesitzung. Eine SSH-Anmeldung mit Passwort ist keine verlässliche + Lösung: Bei einem Microsoft-Konto kann Windows sie ablehnen, auch wenn das Passwort stimmt. - **Linux: Der Schlüsselbund ist nicht verfügbar.** Starte einen Secret Service (zum Beispiel gnome-keyring) und entsperre ihn; `kc doctor` sagt, welcher Teil fehlt. - **Meldungen in der falschen Sprache.** Setze `KC_LANG` (siehe Sprachen unten). diff --git a/README.es.md b/README.es.md index a65abb2..e771b47 100644 --- a/README.es.md +++ b/README.es.md @@ -188,7 +188,10 @@ trabajo pendiente o bloqueado. Consulta los [límites de seguridad](docs/SECURIT en la sesión SSH (pide la contraseña de inicio de sesión del Mac). - **Windows: `no Credential Manager logon session`.** El Administrador de credenciales no existe en una sesión SSH iniciada con una clave. Ejecuta kc desde una - sesión de escritorio o conéctate por SSH con una contraseña. + sesión de escritorio o desde un proceso iniciado con tu contraseña de Windows + (por ejemplo, `Start-Process -Credential` en PowerShell), que obtiene una sesión de + inicio completa. Conectarse por SSH con contraseña no es una solución fiable: Windows + puede rechazarla en una cuenta Microsoft aunque la contraseña sea correcta. - **Linux: el llavero no está disponible.** Inicia un Secret Service (por ejemplo gnome-keyring) y desbloquéalo; `kc doctor` indica qué parte falta. - **Mensajes en el idioma equivocado.** Define `KC_LANG` (consulta Idiomas más abajo). diff --git a/README.fr.md b/README.fr.md index 7b67172..d2711e3 100644 --- a/README.fr.md +++ b/README.fr.md @@ -189,7 +189,10 @@ signale du travail en attente ou bloqué. Voir les [limites de sécurité](docs/ dans la session SSH (il demande le mot de passe de session du Mac). - **Windows : `no Credential Manager logon session`.** Le Gestionnaire d'identification n'existe pas dans une session SSH ouverte avec une clé. Lancez kc depuis une - session de bureau, ou connectez-vous en SSH avec un mot de passe. + session de bureau, ou depuis un processus démarré avec votre mot de passe Windows + (par exemple `Start-Process -Credential` dans PowerShell), qui obtient une session + de connexion complète. Se connecter en SSH avec un mot de passe n'est pas une solution + fiable : Windows peut le refuser pour un compte Microsoft même si le mot de passe est bon. - **Linux : le trousseau n'est pas disponible.** Démarrez un Secret Service (par exemple gnome-keyring) et déverrouillez-le ; `kc doctor` indique ce qui manque. - **Messages dans la mauvaise langue.** Définissez `KC_LANG` (voir Langues ci-dessous). diff --git a/README.ja.md b/README.ja.md index e8cc970..bbd62c7 100644 --- a/README.ja.md +++ b/README.ja.md @@ -187,7 +187,10 @@ $ kc sync status # 値ではなく状態とこのデバイスの値 (Mac のログインパスワードを求められます)。 - **Windows: `no Credential Manager logon session`。** 鍵でログインした SSH セッションには資格情報マネージャーがありません。デスクトップセッションから - kc を実行するか、パスワードで SSH 接続してください。 + kc を実行するか、Windows のパスワードで起動したプロセス (たとえば PowerShell の + `Start-Process -Credential`) から実行してください。このプロセスは完全なログオン + セッションを持ちます。パスワードで SSH 接続する方法は確実ではありません。 + Microsoft アカウントでは、パスワードが正しくても Windows が拒否することがあります。 - **Linux: キーチェーンが使えない。** Secret Service (gnome-keyring など) を起動して ロックを解除してください。何が足りないかは `kc doctor` が示します。 - **メッセージが意図しない言語で表示される。** `KC_LANG` を設定してください (下の「言語」を参照)。 diff --git a/README.ko.md b/README.ko.md index 94febe6..d083d68 100644 --- a/README.ko.md +++ b/README.ko.md @@ -189,8 +189,11 @@ $ kc sync status # 값 대신 상태와 이 기기의 값 지문 표 `security unlock-keychain ~/Library/Keychains/login.keychain-db` 를 실행하세요(맥 로그인 암호를 묻습니다). - **Windows 에서 `no Credential Manager logon session` 이 나올 때.** SSH 키로 - 로그인한 세션에는 자격 증명 관리자가 없습니다. 데스크톱 세션에서 실행하거나 - 비밀번호로 SSH 접속하세요. + 로그인한 세션에는 자격 증명 관리자가 없습니다. 데스크톱 세션에서 실행하거나, + Windows 비밀번호로 시작한 프로세스(예: PowerShell 의 `Start-Process -Credential`) + 에서 실행하세요. 이 프로세스는 완전한 로그온 세션을 받습니다. SSH 를 비밀번호로 + 접속하는 방법은 확실하지 않습니다. Microsoft 계정이면 비밀번호가 맞아도 Windows 가 + 거부할 수 있습니다. - **Linux 에서 키체인을 쓸 수 없을 때.** gnome-keyring 같은 Secret Service 를 실행하고 잠금을 푸세요. 무엇이 빠졌는지는 `kc doctor` 가 알려 줍니다. - **메시지가 원하지 않는 언어로 나올 때.** `KC_LANG` 을 지정하세요(아래 언어 diff --git a/README.md b/README.md index 49c6d81..b8aced9 100644 --- a/README.md +++ b/README.md @@ -187,7 +187,10 @@ work remains. See [the security limits](docs/SECURITY.md). session (it asks for the Mac's login password). - **Windows: `no Credential Manager logon session`.** Credential Manager doesn't exist in an SSH session that logged in with a key. Run kc from a - desktop session, or connect over SSH with a password. + desktop session, or from a process started with your Windows password (for + example PowerShell's `Start-Process -Credential`), which gets a full logon + session. Logging in to SSH with a password instead isn't a reliable fix: + Windows can refuse it for a Microsoft account even when the password is right. - **Linux: the keychain is unavailable.** Start a Secret Service (for example gnome-keyring) and unlock it; `kc doctor` says which part is missing. - **Messages in the wrong language.** Set `KC_LANG` (see Languages below). diff --git a/README.zh-Hans.md b/README.zh-Hans.md index 0b40141..19d59e1 100644 --- a/README.zh-Hans.md +++ b/README.zh-Hans.md @@ -179,7 +179,9 @@ Touch ID(或系统密码)、Windows Hello 或 polkit 在本机确认。加 因此无法显示钥匙串提示。请在 Mac 本机的终端中运行 kc,或先在 SSH 会话中运行 `security unlock-keychain ~/Library/Keychains/login.keychain-db`(它会要求输入 Mac 的登录密码)。 - **Windows:`no Credential Manager logon session`。** 用密钥登录的 SSH 会话中 - 没有凭据管理器。请在桌面会话中运行 kc,或用密码通过 SSH 连接。 + 没有凭据管理器。请在桌面会话中运行 kc,或在用 Windows 密码启动的进程中运行 + (例如 PowerShell 的 `Start-Process -Credential`),这样的进程有完整的登录会话。 + 改用密码登录 SSH 并不可靠:对于 Microsoft 账户,即使密码正确,Windows 也可能拒绝。 - **Linux:钥匙串不可用。** 启动 Secret Service(例如 gnome-keyring)并解锁; `kc doctor` 会指出缺少哪一部分。 - **消息语言不对。** 设置 `KC_LANG`(见下方"语言")。当 stdout 和 stderr diff --git a/README.zh-Hant.md b/README.zh-Hant.md index e67b231..c575f58 100644 --- a/README.zh-Hant.md +++ b/README.zh-Hant.md @@ -179,7 +179,9 @@ Touch ID(或系統密碼)、Windows Hello 或 polkit 在本機確認。加 因此無法顯示鑰匙圈提示。請在 Mac 本機的終端機中執行 kc,或先在 SSH 工作階段中執行 `security unlock-keychain ~/Library/Keychains/login.keychain-db`(它會要求輸入 Mac 的登入密碼)。 - **Windows:`no Credential Manager logon session`。** 以金鑰登入的 SSH 工作階段中 - 沒有認證管理員。請在桌面工作階段中執行 kc,或以密碼透過 SSH 連線。 + 沒有認證管理員。請在桌面工作階段中執行 kc,或在以 Windows 密碼啟動的處理程序中執行 + (例如 PowerShell 的 `Start-Process -Credential`),這樣的處理程序有完整的登入工作階段。 + 改以密碼登入 SSH 並不可靠:對於 Microsoft 帳戶,即使密碼正確,Windows 也可能拒絕。 - **Linux:鑰匙圈無法使用。** 啟動 Secret Service(例如 gnome-keyring)並解鎖; `kc doctor` 會指出缺少哪個部分。 - **訊息語言不對。** 設定 `KC_LANG`(見下方「語言」)。當 stdout 與 stderr diff --git a/crates/kc-store/src/backend/keyring.rs b/crates/kc-store/src/backend/keyring.rs index 15a7fc0..20d88e4 100644 --- a/crates/kc-store/src/backend/keyring.rs +++ b/crates/kc-store/src/backend/keyring.rs @@ -481,7 +481,8 @@ mod sys { pub(super) const TIMEOUT_HINT: &str = "Windows Credential Manager did not answer; try again"; const NO_SESSION_HINT: &str = "Credential Manager isn't available in this logon session \ (ERROR_NO_SUCH_LOGON_SESSION, typical for OpenSSH key authentication). Run kc from an \ - interactive desktop session, or connect over SSH with password authentication"; + interactive desktop session, or from a process started with your Windows password \ + (for example PowerShell's Start-Process -Credential)"; const ACCESS_DENIED_HINT: &str = "Windows refused access to the credential. Run kc as the \ user who owns it, outside any sandbox or policy that restricts Credential Manager"; /// ERROR_ACCESS_DENIED