From 6f983739de5b5c3229d2bef06004adbdd7010fe1 Mon Sep 17 00:00:00 2001 From: Ken'ichi Fukamachi Date: Sun, 16 Sep 2018 15:41:09 +0900 Subject: reviewed. alignment cosmetics. --- fml/doc/ja/tutorial/command/dataflow.sgml | 56 +++++++++++++++++++------------ 1 file changed, 34 insertions(+), 22 deletions(-) (limited to 'fml/doc/ja/tutorial/command/dataflow.sgml') diff --git a/fml/doc/ja/tutorial/command/dataflow.sgml b/fml/doc/ja/tutorial/command/dataflow.sgml index 6f3a32f7..b765e3ce 100644 --- a/fml/doc/ja/tutorial/command/dataflow.sgml +++ b/fml/doc/ja/tutorial/command/dataflow.sgml @@ -14,9 +14,10 @@ --> -すべてのコマンド(&fml8; への命令)処理は最終的に「FML::Command」クラス -経由で「FML::Command::モード::コマンド」クラスを呼び出します。GUI およ -び CUI、コマンドメールは、そこに至る前処理の段階が異なるだけです。 +すべてのコマンド(&fml8; への命令)処理は、 +最終的に「FML::Command」クラス経由で +「FML::Command::モード::コマンド」クラスを呼び出します。 +GUI および CUI、コマンドメールは、そこに至る前処理段階が異なるだけです。 @@ -32,7 +33,7 @@ -本節はコマンドメールの話です。 +本節は、コマンドメールの話です。 メールの本文が複数行あり、それが複数の命令を含むと想定します。 @@ -42,22 +43,27 @@ -空行を無視するなどの基本的な処理の後、コマンド(行の先頭の文字列)が、現 -在のコンテキストで許されるコマンドか否か？を確認します。 +空行を無視するなどの基本的な処理の後、 +コマンド(行の先頭の文字列)が、 +現在のコンテキストで許されるコマンドか否か？を確認します。 1) guide や subscribe のようにメンバー以外にも許されるコマンドであれば、 そこから直接、コマンド呼び出しルーチンへ処理が移ります。 - ここで許されるコマンドは anonymous_command_mail_allowed_commands + ここで許されるコマンドは + anonymous_command_mail_allowed_commands 変数で定義されているコマンドです。 2) あらかじめ指定されたユーザだけに許されるコマンドの場合、 - command_mail_restrictions のルールに従って他の条件を確認し、 - 許されたなら、呼び出しルーチンへ処理が移ります。 - ここで許されるコマンドは user_command_mail_allowed_commands + command_mail_restrictions + のルールに従って他の条件を確認し、 + コマンドの実行が許される場合のみ、 + コマンド呼び出しルーチンへ処理が移ります。 + ここで実行が許されるコマンドは + user_command_mail_allowed_commands で定義されているコマンドです。 @@ -69,7 +75,7 @@ 「呼び出しルーチン」では、 (コマンドに依存した)返事の送り先の確認と -(コマンドに依存する)シンタックスチェックを経て、 +(コマンドに依存する)シンタックスチェックをへて、 FML::Command クラス経由でコマンドが実行されます。 この実行は一般ユーザ権限で実行されます。 @@ -83,11 +89,15 @@ admin 注: admin コマンドは user_command_mail_allowed_commands で許されています -の実行として処理が進められ、最終的に「FML::Command::User::admin」クラ -スが呼び出されます。このクラスの中で、admin_command_mail_restrictions -変数 に基づいてリモート権限があるか？が確認され、もう一度 -「FML::Command」クラス経由で管理者権限の「FML::Command::Admin::コマン -ド」クラスが呼び出されます(つまりトランポリン・メカニズムです)。 +の実行として処理が進められ、 +最終的に「FML::Command::User::admin」クラスが呼び出されます。 +このクラスの中で、 +admin_command_mail_restrictions 変数 にもとづいて、 +このユーザはリモートコマンドを実行する権限があるか？が確認されます。 +その後、もう一度 +「FML::Command」クラス経由で、 +管理者権限の「FML::Command::Admin::コマンド」クラスが呼び出されます +(つまりトランポリン・メカニズムです)。 @@ -100,15 +110,17 @@ admin このプログラムを使える時点で管理者権限(ＭＬのサーバにリモートで入り、 -ユーザ fml に su できる権限)があるはずです。よって、特別な制限はありま -せん。FML::Command経由で「FML::Command::Admin::コマンド」クラスを直接 -呼び出しています。 +ユーザ fml に su できる権限)があるはずです。 +よって、特別な制限はありません。 +FML::Command 経由で +「FML::Command::Admin::コマンド」クラスを直接呼び出しています。 -なお、サーバへリモートからログインするためには SSH で「RSA 2048 ビット -以上の鍵のみを許す、パスワード認証は認めない」といった強固な運用ルール -を課して下さい。 +なお、 +サーバへリモートからログインするためには +SSH で「RSA 2048 ビット以上の鍵のみを許す、パスワード認証は認めない」 +といった強固な運用ルールを課して下さい。 -- cgit v1.2.1