HTTP AUTHENTICATE
HTTP AUTHENTICATE ( name ; password {; authMethod} {; *} )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| name | テキスト | 🡒 | ユーザー名 |
| password | テキスト | 🡒 | ユーザーパスワード |
| authMethod | 倍長整数 | 🡒 | 認証方式: 0または省略時=指定しない、1=BASIC、2=DIGEST |
| * | 演算子 | 🡒 | 指定時: プロクシ認証 |
説明
HTTP AUTHENTICATEコマンドはクライアントアプリケーションの認証を要求するサーバーへのHTTPリクエストを可能にします。
name と password引数には必要な認証情報 (ユーザー名とパスワード) を渡します。この情報はエンコードされ、HTTP RequestまたはHTTP Getを使用して送信されるHTTPリクエストに追加されます。
オプションのauthMethod引数を使用して、使用する認証メソッドを指定できます。HTTP Clientテーマの以下の定数を使用できます:
| 定数 | 型 | 値 | コメント |
|---|---|---|---|
| HTTP basic | 倍長整数 | 1 | BASIC認証メソッドを使用する |
| HTTP digest | 倍長整数 | 2 | DIGEST認証メソッドを使用する |
authMethod引数を省略するか0を渡した場合、適切なメソッドを4Dが選択します。この場合4Dは認証メソッドをネゴシエートするために追加のリクエストを送信します。
* 引数を渡すと、認証情報はHTTPプロクシに提供されることを意味します。この設定はクライアントとHTTPサーバーの間に認証を必要とするプロクシが存在する場合に必要となります。サーバー自身も認証を行い場合、二重の認証が必要となります。
デフォルトでは認証情報は一時的に保管され、カレントプロセス内においてはそれぞれのリクエスト毎に再使用されます。しかしながらHTTP SET OPTION コマンドでオプションを設定する事により各リクエスト後にこの情報をリセットする事ができます。この場合、HTTP Request または HTTP Getコマンドを呼び出す前にHTTP AUTHENTICATE コマンドを実行する必要があります。
例題
認証付きリクエストの例:
// DIGESTモード
HTTP AUTHENTICATE("httpUser";"123";2)
// プロクシ経由デフォルトモード
HTTP AUTHENTICATE("ProxyUser";"456";*)
$httpStatus:=HTTP Get(...)