HTTPサーバー

コマンド一覧

コマンド コマンドの機能
http-server authentication-method 認証方式の設定
http-server guest-username Guest ユーザーの指定
http-server ignore HTTPサーバーの無視動作設定
http-server ip access-list IPv4 アクセスリストの設定
http-server ip enable IPv4 http 機能の有効化
http-server ip https-port ポート番号 (HTTPS) の設定
http-server ip port IPv4ポート番号 (HTTP) の設定
http-server ipv6 access-list IPv6 アクセスリストの設定
http-server ipv6 enable IPv6 http 機能の有効化
http-server ipv6 https-port IPv6ポート番号 (HTTPS) の設定
http-server ipv6 port IPv6ポート番号 (HTTP) の設定
http-server max-session HTTPサーバーの同時接続セッション数の設定
http-server monitor-username 利用者ユーザーの指定
http-server protocol プロトコルの設定
http-server terminal timeout ログインタイマーの設定
http-server upload-limit アップロードファイルのサイズ設定
http-server username ユーザーの指定
o Web コンソール情報の設定
web-console Webコンソールコンフィグモード
show http-server 状態/統計情報/サーバーログの表示
clear http-server 統計情報の消去

認証方式の設定

[入力形式]
http-server authentication-method { basic | digest }
no http-server authentication-method
[パラメータ]

basic...BASIC 認証

digest...Digest 認証

[説明]
Web コンソールの認証方式を指定します。
[デフォルト値]
basic
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server authentication-method digest
no http-server authentication-method
[ノート]
なし

Guest ユーザーの指定

[入力形式]
http-server guest-username USER-NAME { password | secret-password } PASSWORD
no http-server guest-username
[パラメータ]

USER-NAME...ユーザー名

  • 16文字以内の文字列
  • 大文字/小文字は区別されます。

password...平文パスワード指定

secret-password...暗号化済みパスワード指定

PASSWORD...パスワード

  • 80文字以内の文字列(平文パスワード指定の場合)
  • 大文字/小文字は区別されます。
[説明]
Guest ページにアクセスできるユーザーを登録します。
[デフォルト値]
なし
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server guest-username guest password pass
no http-server guest-username
[ノート]
パスワードは常に暗号化されて保存されます。

設定したパスワードの強度評価結果を表示します。
(平文のパスワード指定時のみ。)

% Password strength estimation: score 0(very poor).

score 0(very poor) :非常に弱い
score 1(poor) :弱い
score 2(normal) :普通
score 3(strong) :強い
score 4(very strong):非常に強い

HTTPサーバーの無視動作設定

[入力形式]
http-server ignore connection-keep-alive
no http-server ignore connection-keep-alive
[パラメータ]
なし
[説明]
keep-alive 要求を無視します。
[デフォルト値]
無効
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server ignore connection-keep-alive
no http-server ignore connection-keep-alive
[ノート]
なし

IPv4 アクセスリストの設定

[入力形式]
http-server ip access-list ACCESSLIST-NAME
no http-server ip access-list
[パラメータ]

ACCESSLIST-NAME...アクセスリスト名

  • 15文字以内の文字列
[説明]
HTTPサーバーで使用する IPv4 アクセスリストを指定します。
[デフォルト値]
なし
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server ip access-list list1
no http-server ip access-list list1
[ノート]
コマンドを設定しない場合は、すべてのホストからのアクセスを許可します。

IPv4 http 機能の有効化

[入力形式]
http-server ip enable
no http-server ip enable
[パラメータ]
なし
[説明]
Web コンソールで使用する HTTPサーバーの IPv4 アクセスを有効にします。
[デフォルト値]
無効
[実行モード]
インタフェースコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server ip enable
no http-server ip enable
[ノート]
なし
[IX2000/IX3000シリーズ差分]
  • インタフェースコンフィグモードでのみ設定可能に変更

ポート番号 (HTTPS) の設定

[入力形式]
http-server ip https-port PORT
no http-server ip https-port
[パラメータ]

PORT...ポート番号

  • 範囲:1〜65535
[説明]
HTTPS を IPv4 で利用する際の TCP ポート番号を指定します。
[デフォルト値]
443
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server ip https-port 10443
no http-server ip https-port
[ノート]
ポート番号変更時、接続中のセッションは切断されます。

IPv4ポート番号 (HTTP) の設定

[入力形式]
http-server ip port PORT
no http-server ip port
[パラメータ]

PORT...ポート番号

  • 範囲:1〜65535
[説明]
HTTPをIPv4で利用する際のTCPポート番号を指定します。
[デフォルト値]
80
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server ip port 8080
no http-server ip port
[ノート]
ポート番号変更時、接続中のセッションは切断されます。

IPv6 アクセスリストの設定

[入力形式]
http-server ipv6 access-list ACCESSLIST-NAME
no http-server ipv6 access-list
[パラメータ]

ACCESSLIST-NAME...アクセスリスト名

  • 15文字以内の文字列
[説明]
HTTPサーバーで使用する IPv6 アクセスリストを指定します。
[デフォルト値]
なし
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server ipv6 access-list list1
no http-server ipv6 access-list list1
[ノート]
コマンドを設定しない場合は、すべてのホストからのアクセスを許可します。

IPv6 http 機能の有効化

[入力形式]
http-server ipv6 enable
no http-server ipv6 enable
[パラメータ]
なし
[説明]
Web コンソールで使用する HTTPサーバーの IPv6 アクセスを有効にします。
[デフォルト値]
無効
[実行モード]
インタフェースコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server ipv6 enable
no http-server ipv6 enable
[ノート]
なし
[IX2000/IX3000シリーズ差分]
  • インタフェースコンフィグモードでのみ設定可能に変更

IPv6ポート番号 (HTTPS) の設定

[入力形式]
http-server ipv6 https-port PORT
no http-server ipv6 https-port
[パラメータ]

PORT...ポート番号

  • 範囲:1〜65535
[説明]
HTTPSをIPv6で利用する際のTCPポート番号を指定します。
[デフォルト値]
443
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server ipv6 https-port 10443
no http-server ipv6 https-port
[ノート]
ポート番号変更時、接続中のセッションは切断されます。

IPv6ポート番号 (HTTP) の設定

[入力形式]
http-server ipv6 port PORT
no http-server ipv6 port
[パラメータ]

PORT...ポート番号

  • 範囲:1〜65535
[説明]
HTTPをIPv6で利用する際のTCPポート番号を指定します。
[デフォルト値]
80
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server ipv6 port 8080
no http-server ipv6 port
[ノート]
ポート番号変更時、接続中のセッションは切断されます。

HTTPサーバーの同時接続セッション数の設定

[入力形式]
http-server max-session SESSION-PER-HOST [ SESSION-PER-SERVER ]
no http-server max-session
[パラメータ]

SESSION-PER-HOST...ホスト毎の最大セッション数

  • 範囲:1~128

SESSION-PER-SERVER...装置の最大セッション数

  • 範囲:1~1024
  • デフォルト値:320
[説明]
HTTPサーバーの同時接続セッション数を設定します。
[デフォルト値]
SESSION-PER-HOST...5
SESSION-PER-SERVER...320
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server max-session 2 100
no http-server max-session
[ノート]
なし
[IX2000/IX3000シリーズ差分]
  • パラメータに装置の最大セッション数追加

利用者ユーザーの指定

[入力形式]
http-server monitor-username USER-NAME { password | secret-password } PASSWORD
no http-server monitor-username
[パラメータ]

USER-NAME ... ユーザー名

  • 16文字以内の文字列
  • 大文字/小文字は区別されます。

password...平文パスワード指定

secret-password...暗号化済みパスワード指定

PASSWORD...パスワード

  • 80文字以内の文字列(平文パスワード指定の場合)
  • 大文字/小文字は区別されます。
[説明]
利用者ページにアクセスできるユーザーを登録します。
[デフォルト値]
なし
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server monitor-username user password pass
no http-server monitor-username
[ノート]
設定したパスワードの強度評価結果を表示します。
(平文のパスワード指定時のみ。)

% Password strength estimation: score 0(very poor).

score 0(very poor) :非常に弱い
score 1(poor) :弱い
score 2(normal) :普通
score 3(strong) :強い
score 4(very strong):非常に強い

プロトコルの設定

[入力形式]
http-server protocol { both | http | https }
no http-server protocol
[パラメータ]

both ...http/https指定

http ...http指定

https...https指定

[説明]
HTTPサーバーのプロトコルを指定します。
[デフォルト値]
both
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server protocol https
no http-server protocol
[ノート]
本コマンドのパラメータ both および http 設定は IX-R シリーズでのみ利用できます。

ログインタイマーの設定

[入力形式]
http-server terminal timeout TIME
no http-server terminal timeout
[パラメータ]

TIME...タイマー値(分)

  • 範囲:0〜60
[説明]
Web コンソールのログインタイマーを設定します。
0 を設定することでログインタイマーを無効にできます。
[デフォルト値]
60
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server terminal timeout 3
no http-server terminal timeout
[ノート]
Web コンソールの無操作時間がこのコマンドで設定された時間経過すると、
ユーザーは自動的にログアウトされます。

アップロードファイルのサイズ設定

[入力形式]
http-server upload-limit SIZE
no http-server upload-limit
[パラメータ]

SIZE...ファイルサイズ(MB)

  • 範囲:3〜200
[説明]
ソフトウェアのアップデートでアップロード可能なファイルの最大サイズを設定します。
[デフォルト値]
150
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server upload-limit 200
no http-server upload-limit
[ノート]
なし
[IX2000/IX3000シリーズ差分]
  • 範囲の最大値を200MBに拡張

ユーザーの指定

[入力形式]
http-server username USER-NAME { password | secret-password } PASSWORD
no http-server username
[パラメータ]

USER-NAME...ユーザー名

  • 16文字以内の文字列
  • 大文字/小文字は区別されます。

password...平文パスワード指定

secret-password...暗号化済みパスワード指定

PASSWORD...パスワード

  • 80文字以内の文字列(平文パスワード指定の場合)
  • 大文字/小文字は区別されます。
[説明]
Webコンソールにログイン可能なユーザーを登録します。
[デフォルト値]
なし
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
http-server username user password pass
no http-server username
[ノート]
設定したパスワードの強度評価結果を表示します。
(平文のパスワード指定時のみ。)

% Password strength estimation: score 0(very poor).

score 0(very poor) :非常に弱い
score 1(poor) :弱い
score 2(normal) :普通
score 3(strong) :強い
score 4(very strong):非常に強い
[IX2000/IX3000シリーズ差分]
  • password省略不可

Web コンソール情報の設定

[入力形式]
o COMMAND [ PARAM ... ]
no o COMMAND [ PARAM ... ]
[パラメータ]

COMMAND...任意のコマンド

PARAM...任意のパラメータ

[説明]
Web コンソールで利用する情報を保存します。
任意の文字列をコマンドやパラメータとして登録可能です。
[デフォルト値]
なし
[実行モード]
Web コンソールコンフィグモード
[ユーザー権限]
Administrator
[入力例]
o wan1 GigaEthernet0.1
o cmd1 type 1 value 2
no o wan1
[ノート]
削除は完全一致またはスペース区切りまでの前方一致で実行します。

Webコンソールコンフィグモード

[入力形式]
web-console {system | custom} MODE
no web-console {system | custom} MODE
[パラメータ]

MODE...モード名

  • 31文字以内の文字列
  • 大文字/小文字は区別されます。
[説明]
Web コンソールコンフィグモードに移行します。
[デフォルト値]
なし
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator
[入力例]
web-console custom USER1
no web-console custom USER1
[ノート]
systemはシステムで予約している用途にのみ使用します。
新規に登録する場合はcustomを利用してください。

状態/統計情報/サーバーログの表示

[入力形式]
show http-server [ server-log { accesslog | applog | errorlog } ]
[パラメータ]

server-log...サーバーログの表示

  • accesslog ...アクセスログ
  • applog ...アプリサーバーログ
  • errorlog ...エラーログ
[説明]
HTTPサーバーの状態・統計情報・サーバーログを表示します。
[デフォルト値]
なし
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator/Operator/Monitor
[入力例]
show http-server
show http-server server-log accesslog
show http-server server-log errorlog
[ノート]
なし
[IX2000/IX3000シリーズ差分]
  • detailオプションの廃止
  • サーバーログの表示オプションの追加

統計情報の消去

[入力形式]
clear http-server { server-log { accesslog | all | applog | errorlog } | statistics }
[パラメータ]

server-log...サーバーログのクリア

  • accesslog...アクセスログのクリア
  • all...サーバーログをすべてクリア
  • applog...アプリサーバーログのクリア
  • errorlog...エラーログのクリア

statistics...統計情報のクリア

[説明]
HTTPサーバーの統計情報・サーバーログを消去し初期状態に戻します。
[デフォルト値]
なし
[実行モード]
グローバルコンフィグモード
[ユーザー権限]
Administrator/Operator/Monitor
[入力例]
clear http-server server-log accesslog
clear http-server statistics
[ノート]
なし