curlでBasic認証付きURLにアクセスする:パスワードの指定と401の確認
作成日:2026.11.15
curlの`-u`オプションでBasic認証付きURLへアクセスする方法を、WindowsのPowerShellで紹介します。パスワードの対話入力、認証前後の応答比較、HTTPステータスと終了コードの違い、認証情報やログを扱う際の注意点をまとめます。
目次
Basic認証を設定した検証サイトへ、curlでアクセスしたいことがあります。ブラウザーではユーザー名とパスワードの入力欄が出ますが、curlでは-uオプションで指定します。
手元で確認するなら、ユーザー名だけを指定して、パスワードを対話入力する形が便利です。
curl.exe -i -u demo 'https://example.com/protected/'
今回は、この指定方法と、認証なし・認証ありの応答の比較、HTTPステータスと終了コードの確認方法をまとめます。本文はWindowsのPowerShell向けです。
Basic認証と、確認する環境
Basic認証は、ユーザー名とパスワードをHTTPのAuthorizationヘッダーで送る認証方式です。認証情報はBase64で表現されますが、Base64は暗号化ではありません。実際のサイトへ認証情報を送るときはHTTPSを使ってください。
認証情報がない、または正しくない場合、サーバーは通常401 UnauthorizedとWWW-Authenticate: Basic ...を返します。401だけでBasic認証だと決めず、ヘッダーも合わせて確認します。
今回コマンドを確認した環境は、Windows 11、PowerShell 7.6.10、curl 8.22.0です。Windows PowerShell 5.1ではcurlが別のコマンドの別名になっているため、ここでは外部プログラムを指定するcurl.exeと書きます。
$PSVersionTable.PSVersion
Get-Command curl.exe
curl.exe --version
以下のURL・ユーザー名・パスワードは説明用です。example.comに、この認証で試せるページがあるわけではありません。自分で確認してよい環境の値へ置き換えてください。
認証なしと、認証ありで応答を比べる
まずは認証情報を付けずに、同じURLへGETを送ってみます。-iは、本文と一緒にレスポンスヘッダーも表示する指定です。
curl.exe -i 'https://example.com/protected/'
Basic認証を要求された場合の、ヘッダーの例です。HTTPのバージョンやrealmの値などは環境によって異なります。
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Basic realm="Restricted Area"
次に、冒頭と同じように-u demoを付けます。demoはユーザー名で、-uは--userの短い指定です。
curl.exe -i -u demo 'https://example.com/protected/'
ユーザー名だけを渡すと、パスワードの入力が求められます。正しいパスワードで対象ページを取得できれば、例えば200 OKとページ本文が返ります。認証後にリダイレクトやアプリ側のエラーが返ることもあるため、必ず200になるとは限りません。
確認するときは、認証なしで拒否されることに加え、誤ったパスワードでも拒否され、正しいパスワードなら期待する内容を取得できることを比べるとよいかと思います。誤認証の試験は、ロックアウトなどに影響しないテスト用アカウントで行ってください。
パスワードも引数へ書く場合
構文としては、ユーザー名とパスワードをコロンでつなぐ形も使えます。次の値はダミーです。
curl.exe -i -u 'demo:dummy-password' 'https://example.com/protected/'
ただし、この書き方ではパスワードがコマンド履歴に残り、プロセスの引数から見える可能性もあります。手動の確認では、パスワードをコマンド文字列へ書かない対話入力を基本にします。無人実行では入力待ちにできないため、アクセス権を限定した認証設定ファイルや実行基盤の秘密情報管理など、渡し方を別途検討してください。
-uの値は最初のコロンでユーザー名とパスワードに分かれます。パスワードにはコロンを含められますが、ユーザー名には使えません。空白や$などを含むダミー値をPowerShellの引数に書く場合は、上のように全体をシングルクォートで囲みます。値自体にシングルクォートがある場合は、PowerShell側の引用符の処理も必要です。
なお、HTTPではBasic認証が既定なので、通常は--basicの追加は不要です。別の認証方式を指定した設定を上書きする場合などに使います。
HTTPステータスとcurlの終了コードを確認する
本文を表示せず、HTTPステータスだけを見たい場合は、次のように指定できます。
curl.exe -sS -o NUL -w 'HTTP=%{http_code}\n' -u demo 'https://example.com/protected/'
$curlExitCode = $LASTEXITCODE
"curl exit=$curlExitCode"
-sS:進捗表示を抑え、通信に失敗したときのエラーメッセージは表示する-o NUL:Windowsでレスポンス本文を破棄する-w:転送後に情報を出力する。%{http_code}がHTTPステータス、\nが改行$LASTEXITCODE:直前に実行した外部プログラムの終了コード。curlの実行直後に保存する
HTTP 401が返ったことと、curlの通信処理が失敗したことは別です。標準のcurlでは、401の応答を受け取れていれば終了コードが0になる場合があります。終了コード0だけでは認証成功と判断できません。
HTTPエラーを失敗として扱う
HTTP 400以上を失敗として扱う指定に--failがあります。エラー本文を残して調べたい場合は、curl 7.76.0以降の--fail-with-bodyを使えます。二つは同時に指定しません。
curl.exe -sS --fail-with-body --connect-timeout 5 --max-time 15 `
-o '.\basic-response.html' -w 'HTTP=%{http_code}\n' `
-u demo 'https://example.com/protected/'
$curlExitCode = $LASTEXITCODE
"curl exit=$curlExitCode"
この例では本文をbasic-response.htmlへ保存します。同名のファイルは上書きされるため、作業用フォルダーで試してください。--connect-timeoutは接続を確立するまで、--max-timeは転送全体の制限時間で、ここではそれぞれ5秒と15秒です。対話でのパスワード入力を含め、無人実行の手順としてそのまま使う例ではありません。
ローカルのダミー認証サーバーで、同じGETを送ったときの結果は次のとおりでした。認証なし・誤認証では401、正しい認証情報では200を返すサーバーで確認しています。
| 認証の条件 | 追加オプション | HTTPステータス | 終了コード | 本文 |
|---|---|---|---|---|
| 認証なし/誤った認証情報 | なし | 401 | 0 | 取得できた |
| 認証なし/誤った認証情報 | --fail | 401 | 22 | 出力されなかった |
| 認証なし/誤った認証情報 | --fail-with-body | 401 | 22 | 取得できた |
| 正しい認証情報 | 上記のいずれでも | 200 | 0 | 取得できた |
ただし、curl公式マニュアルの--failには、認証が関係する401・407などで失敗を検出しきれない場合があると注意書きがあります。上の表は今回の条件での結果です。自動判定が必要なら、終了コードとHTTPステータスの両方を確認します。
例えば「このページでは200を期待する」という確認なら、次のように分けられます。本文を破棄して、標準出力にHTTPステータスだけを受け取る例です。
$httpStatus = curl.exe -sS --connect-timeout 5 --max-time 15 `
-o NUL -w '%{http_code}' -u demo 'https://example.com/protected/'
$curlExitCode = $LASTEXITCODE
if ($curlExitCode -ne 0) {
throw "通信に失敗しました。curl exit=$curlExitCode"
}
if ($httpStatus -ne '200') {
throw "期待するHTTP 200ではありません。HTTP=$httpStatus"
}
'HTTP 200を確認しました。'
200以外を正常とするページなら、期待するステータスへ変更します。200でもログイン画面やアプリ独自のエラー本文が返ることはあるため、必要に応じて取得内容も確認してください。000と表示された場合はサーバーが返したステータスではなく、HTTP応答コードを取得できていません。
うまく取得できないときの確認先
-Iを使うとヘッダーだけを確認できますが、これはGETではなくHEADリクエストです。ブラウザーでページを取得する場合に近い応答を調べたいなら、まずは-iを付けたGETで比較します。
認証情報を付けても401になる場合は、ユーザー名・パスワードと、要求されている認証方式を確認します。403ならIP制限や権限など、404ならURLやルーティングなども確認先です。407は接続先サイトではなくプロキシの認証要求です。実際のステータスはアクセス制御の設定や評価順でも変わるため、番号だけで原因を断定しないようにします。
301・302などが返った場合は、まずLocationで転送先を確認します。この記事の例はリダイレクトを自動で追いません。認証情報を別のホストへ送る設定を、理由を確認せず追加しないでください。HTTPSの証明書エラーも、-kで検証を無効にして済ませず、接続先や証明書を確認します。
詳しい通信の様子を見たい場合は-vを使えます。
curl.exe -v -u demo 'https://example.com/protected/'
詳細ログには認証ヘッダーや接続先などが含まれることがあります。ログや画面を共有するときは、認証情報・Cookie・内部URLなどを確認して取り除いてください。Base64の文字列も、伏せる必要のない情報ではありません。
今回の表とコマンドの検証は、ループバック上のHTTPサーバーとダミー認証情報を使っています。実サイトへのHTTPS接続、Windows PowerShell 5.1、Bash、プロキシ環境での動作は検証していません。Linuxなどへ読み替える場合は実行ファイル名や本文の破棄先も変わるため、その環境で確認してください。
まずは-i -u ユーザー名で応答を見て、認証なしの場合と比べればOKです。GET・JSON POSTやレスポンス保存の基本は、PowerShellでcurlを使う記事でも説明しています。
参考資料
奈良市を拠点に、27年以上の経験を持つフリーランスWebエンジニア、阿部辰也です。
これまで、ECサイトのバックエンド開発や業務効率化システム、公共施設の予約システムなど、多彩なプロジェクトを手がけ、企業様や制作会社様のパートナーとして信頼を築いてまいりました。
【制作会社・企業様向けサポート】
Webシステムの開発やサイト改善でお困りの際は、どうぞお気軽にご相談ください。小さな疑問から大規模プロジェクトまで、最適なご提案を心を込めてさせていただきます。
ぜひ、プロフィールやWeb制作会社様向け業務案内、一般企業様向け業務案内もご覧くださいね。
Bashで複数のコマンドをまとめて実行する:丸括弧とサブシェルの使い方
2026.11.05
Bashで複数のコマンドを丸括弧でまとめて実行する方法を紹介します。変数や作業ディレクトリへの影響、波括弧との違いを確認し、curlの順次実行と出力保存、失敗時の制御を具体例で解説します。
PowerShellでcurlを使う:REST APIのGET・JSON POSTとエラーの確認
2026.11.03
WindowsのPowerShellからcurlでREST APIを試す方法を紹介します。GETのクエリ指定、JSONファイルのPOST、Bearer認証ヘッダーの付け方に加え、レスポンスの保存やHTTPステータス・終了コードによるエラーの切り分けを解説します。
PHP cURLの証明書エラー:VERIFYPEERを無効にする危険性とCAバンドルの設定方法
2026.11.02
PHPのcURLで「unable to get local issuer certificate」が出たとき、CURLOPT_SSL_VERIFYPEERをfalseにする対処が危険な理由を解説します。証明書の信頼性検証とホスト名照合の違いを整理し、WindowsでのCAバンドルの取得、curl.cainfoの設定、反映確認までを紹介します。