Bitbucketで「Invalid credentials」エラーを解決する方法

問題の原因

2022年3月以降、Bitbucketはセキュリティ強化のため、Git操作での従来のアカウントパスワードを使用した認証を廃止しました。そのため、正しいパスワードを入力しているにもかかわらず、以下のようなエラーが発生します：

fatal: Invalid credentials
Password for 'https://username@bitbucket.org':
remote: Bitbucket Cloud recently stopped supporting account passwords for Git authentication.

このエラーメッセージは、BitbucketがGit over HTTPSでの基本的な認証にアプリパスワード（App Password）の使用を必須にするセキュリティポリシーを導入したことを示しています。

解決方法：アプリパスワードの使用

アプリパスワードの作成方法

必要条件

• Bitbucketアカウントにログインできること
• リポジトリへの適切なアクセス権限

1. Bitbucketのアプリパスワード設定ページにアクセス
2. 「Create app password」をクリック
3. 必要な権限を選択（基本的なGit操作には以下を推奨）：
   • Repositories: Read と Write
   • Projects: Read（プロジェクトを使用している場合）
4. 分かりやすいラベル名を設定（例： "Git操作用"）
5. 「Create」をクリックして生成
6. 生成されたパスワードをすぐにコピーして安全な場所に保存（後から確認できません）

重要

アプリパスワードは一度しか表示されないため、必ず保存してください。失念した場合は再作成が必要です。

アプリパスワードの使用方法

既存のリポジトリで設定する場合

ターミナルで以下のコマンドを実行：

git remote set-url origin https://<ユーザー名>:<アプリパスワード>@bitbucket.org/<ユーザー名>/<リポジトリ名>.git

新規クローンする場合

git clone https://<ユーザー名>:<アプリパスワード>@bitbucket.org/<ユーザー名>/<リポジトリ名>.git

IDEで使用する場合（Android Studio, IntelliJ, VSCodeなど）

1. Git操作時に認証ダイアログが表示されたら
2. ユーザー名にはBitbucketのユーザー名を入力
3. パスワードにはアカウントのパスワードではなく、生成したアプリパスワードを入力

IDE拡張機能の利用

VSCodeではAtlassian拡張機能をインストールすると、認証プロセスが簡素化されます。

Windows Credential Managerでの設定

Windowsユーザーは資格情報マネージャーでアプリパスワードを設定できます：

1. コントロールパネル → 資格情報マネージャー → Windows資格情報
2. 「一般的な資格情報の追加」をクリック
3. 以下の情報を入力：
   • ネットワークアドレス: git:https://bitbucket.org
   • ユーザー名: Bitbucketのユーザー名
   • パスワード: 生成したアプリパスワード

代替解决方案：SSH認証の設定

アプリパスワードの代わりに、より安全なSSH認証を設定することもできます。

SSH鍵の生成と設定

# SSH鍵の生成（既存の鍵がある場合は省略可能）
ssh-keygen -t ed25519 -C "your_email@example.com"

# 公開鍵の内容を表示
cat ~/.ssh/id_ed25519.pub

1. 生成した公開鍵をBitbucketに追加：
   • Bitbucket設定 → SSH鍵 → 鍵を追加
2. リポジトリのURLをSSH形式に変更：

git remote set-url origin git@bitbucket.org:<ユーザー名>/<リポジトリ名>.git

公開コンピューターでの注意

SSH鍵方式は個人のマシンでは安全ですが、公開のコンピューターでは使用しないでください。

トラブルシューティング

よくある間違い

• ユーザー名の誤り: メールアドレスではなく、Bitbucketのユーザー名を使用してください
• 権限不足: アプリパスワード作成時、適切な権限を付与しているか確認してください
• キャッシュされた認証情報: 古い認証情報が残っている場合は削除してください

Macユーザー向け

SourceTreeを使用している場合：

cd ~/Library/Application\ Support/SourceTree
# 認証情報に関連するファイルを削除または更新

まとめ

Bitbucketの「Invalid credentials」エラーは、セキュリティポリシーの変更によるもので、以下のいずれかの方法で解決できます：

1. アプリパスワードの使用 - 最も一般的な解决方法
2. SSH認証の設定 - より安全で利便性が高い
3. IDE拡張機能の利用 - 開発環境に統合された認証

どの方法を選択する場合も、アクセス権限の適切な管理と認証情報の安全な保管を心がけてください。