Getting permission denied (public key) on GitLabの解決方法【2025年最新版】

エラーの概要・症状

GitLabを利用している際に、「Getting permission denied (public key)」というエラーメッセージが表示され、リポジトリへのアクセスが拒否される場合があります。このエラーは、主にSSHキーの設定に関連しています。具体的には、GitLabに設定されたSSH公開鍵が正しく機能していないか、認証に失敗していることが原因です。

このエラーが発生すると、リポジトリをクローンしたり、プッシュしたりすることができず、開発作業が滞ってしまいます。特にチームでの開発環境では、早急な対応が求められます。ユーザーはエラーの原因を探るために、SSHキーの再生成や設定ファイルの確認などを行う必要があります。

このエラーが発生する原因

「Getting permission denied (public key)」エラーが発生する原因は主に以下の通りです：

1. SSHキーの未生成または設定不良: SSHキーが生成されていない、またはGitLabに登録されていない場合、接続は拒否されます。SSHキーは、リモートリポジトリへの安全な接続を確立するために必要です。

• 解決策: SSHキーを生成し、GitLabの設定に追加することが必要です。

1. SSHエージェントにキーが追加されていない: SSHエージェントは、SSH接続のための認証情報を管理します。キーがエージェントに追加されていない場合、認証に失敗することがあります。

• 解決策: SSHエージェントにキーを追加する必要があります。

1. SSH設定ファイルの誤設定: ~/.ssh/configファイルが正しく設定されていない場合、GitLabへの接続が失敗することがあります。特に、複数のSSHキーを使用している場合、正しいキーが指定されていなければなりません。

• 解決策: SSH設定ファイルを確認し、適切な設定を行う必要があります。

1. ファイル権限の問題: SSHキーのファイル権限が不適切な場合、SSH接続が拒否されることがあります。特にWindows環境では、ファイルの権限設定が適切でないとエラーが発生します。

• 解決策: SSHキーの権限を確認し、必要に応じて修正する必要があります。

解決方法1（最も効果的）

手順1-1: SSHキーの生成

まず、SSHキーを生成します。以下の手順に従ってください。

1. Git Bashを管理者として起動します。

2. 以下のコマンドを入力してSSHキーを生成します。

   ssh-keygen

1. 保存先のディレクトリを聞かれたら、Enterキーを押してデフォルトの場所（通常は~/.ssh/id_rsa）に保存します。

2. パスフレーズを設定するか、何も入力せずにEnterキーを押してスキップします。

手順1-2: 公開鍵をGitLabに追加

次に、生成した公開鍵をGitLabに追加します。