HTTP AUTHENTICATE

4D v16.3

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(...)

参照

HTTP SET OPTION