Manpages

名 前

xauth − X の 認 証 フ ァ イ ル を 扱 う ユ ー テ ィ リ テ ィ

書 式

xauth [ −f authfile ] [ −vqib ] [ command arg ... ]

説 明

xauth プ ロ グ ラ ム は X サ ー バ と 接 続 す る た め の 認 証 情 報 の 編 集 と 表 示 に 使 用 す る 。 こ の プ ロ グ ラ ム は 通 常 、 あ る マ シ ン か ら 認 証 レ コ ー ド を 取 り 出 し 、 (リ モ ー ト ロ グ イ ン や 他 の ユ ー ザ へ の ア ク セ ス を 許 可 す る 場 合 の よ う に )他 の マ シ ン の 認 証 レ コ ー ド に マ ー ジ す る の に 使 用 さ れ る 。 次 に 述 べ る コ マ ン ド は xauth コ マ ン ド 行 か ら 対 話 的 に 入 力 す る か 、 ス ク リ プ ト 内 で 指 定 す る 。 こ の プ ロ グ ラ ム を generate コ マ ン ド を 使 う 時 以 外 に は X サ ー バ に 接 続 し な い 点 に 注 意 す る こ と 。 通 常 、 xauth は 最 初 に 認 証 フ ァ イ ル を 作 成 す る た め に は 使 わ れ な い 。 そ れ は xdm が 行 う 。

オ プ シ ョ ン

xauth で は 次 の オ プ シ ョ ン を 使 う こ と が で き る 。 オ プ シ ョ ン は 別 々 に 指 定 す る (例 え ば −q −i)か 、 繋 げ て 指 定 す る (例 え ば −qi)。
−f authfile こ の オ プ シ ョ ン は 使 用 す る 認 証 フ ァ イ ル の 名 前 を 指 定 す る 。 デ フ ォ ル ト で は 、 xauth は XAUTHORITY 環 境 変 数 で 指 定 さ れ た フ ァ イ ル ま た は ユ ー ザ の ホ ー ム デ ィ レ ク ト リ の .Xauthority を 使 用 す る 。

状 態 メ ッ セ ー ジ を 出 力 し な い 。 xauth の コ マ ン ド を コ マ ン ド 行 か ら 与 え た 場 合 と 、 標 準 出 力 が 端 末 に リ ダ イ レ ク ト さ れ て い な い 場 合 に は 、 こ の オ プ シ ョ ン が デ フ ォ ル ト で 有 効 と な る 。

に な り 、 色 々 な 動 作 の 結 果 (例 : レ コ ー ド を い く つ 読 み 書 き し た か )を 出 力 す る 。 xauth の コ マ ン ド が 標 準 入 力 か ら 与 え ら れ た 場 合 と 、 標 準 出 力 が 端 末 に リ ダ イ レ ク ト さ れ て い る 場 合 は 、 こ の オ プ シ ョ ン が デ フ ォ ル ト で 有 効 と な る 。

を 無 視 す る 。 通 常 、 xauth は 他 の プ ロ グ ラ ム (通 常 は xdm や 他 の xauth)に よ る ロ ッ ク が か か っ た 認 証 フ ァ イ ル の 読 み 込 み や 編 集 を 拒 否 す る 。

ク を 解 除 し よ う と す る 。 こ の オ プ シ ョ ン は 無 意 味 に な っ た ロ ッ ク を 取 り 除 く 場 合 に だ け 使 用 す る こ と 。

コ マ ン ド

次 の コ マ ン ド を 使 っ て 認 証 フ ァ イ ル を 操 作 す る こ と が で き る :

add displayname protocolname hexkey 指 定 し た デ ィ ス プ レ イ に 対 す る 認 証 エ ン ト リ ー (与 え た プ ロ ト コ ル と 鍵 デ ー タ を 使 う )を 認 証 フ ァ イ ル に 追 加 す る 。 デ ー タ は 長 さ が 偶 数 の 16 進 数 で 指 定 さ れ 、 そ れ ぞ れ の 16 進 数 は ふ た つ ず つ の ペ ア と な っ て オ ク テ ッ ト を 表 す 。 各 ペ ア の 最 初 の 桁 は オ ク テ ッ ト の 上 位 4 ビ ッ ト を 与 え 、 次 の 桁 は 下 位 の 4 ビ ッ ト を 与 え る 。 例 え ば 、 32 文 字 の 16 進 数 の 鍵 は 128 ビ ッ ト の 値 を 表 す 。 プ ロ ト コ ル 名 が 単 に ひ と つ の ピ リ オ ド で あ る 場 合 に は 、 こ れ は MIT-MAGIC-COOKIE-1 の 省 略 形 と し て 扱 わ れ る 。
generate displayname protocolname

[trusted|untrusted]" [timeout seconds] [group group-id] [data hexdata] こ の コ マ ン ド は add に 似 て い る 。 主 な 違 い は ユ ー ザ に 鍵 デ ー タ を 与 え る よ う に 求 め な い で 、 displayname で 指 定 し た サ ー バ に 接 続 し 、 SECURITY 機 能 拡 張 を 使 っ て 鍵 デ ー タ を 取 得 し 、 認 証 フ ァ イ ル に 格 納 す る 。 サ ー バ に 接 続 で き な い 場 合 や 、 SECURITY 機 能 拡 張 が 使 用 で き な い 場 合 に は 、 コ マ ン ド は 失 敗 す る 。 そ う で な い 場 合 に は 、 与 え た プ ロ ト コ ル を 使 っ て い る 指 定 し た デ ィ ス プ レ イ 用 の 認 証 エ ン ト リ ー 認 証 フ ァ イ ル に 追 加 さ れ る 。 プ ロ ト コ ル 名 が た だ ひ と つ の ピ リ オ ド で あ る 場 合 、 こ れ は MIT-MAGIC-COOKIE-1 の 省 略 形 と し て 扱 わ れ る 。

trusted オ プ シ ョ ン を 使 う と 、 こ の 認 証 を 使 用 し て 接 続 す る ク ラ イ ア ン ト は 通 常 通 り 、 デ ィ ス プ レ イ 上 で 制 限 な し に 実 行 で き る 。 untrusted を 使 用 す る と 、 こ の 認 証 を 使 っ て 接 続 す る ク ラ イ ア ン ト は 信 頼 さ れ ず 、 信 頼 さ れ た ク ラ イ ア ン ト が 持 つ デ ー タ の 窃 盗 や 改 竄 を 行 う こ と が で き な い 。 信 頼 さ れ な い ク ラ イ ア ン ト に 課 せ ら れ た 制 限 の 詳 細 に つ い て は SECURITY 機 能 拡 張 の 仕 様 を 参 照 す る こ と 。 こ の オ プ シ ョ ン の デ フ ォ ル ト 値 は untrusted で あ る 。

timeout オ プ シ ョ ン は 、 こ の 認 証 の 有 効 時 間 を 秒 単 位 で 指 定 す る 。 認 証 が こ の 期 間 以 上 使 用 さ れ な い ま ま (ク ラ イ ア ン ト が 接 続 し な い )の 場 合 、 サ ー バ は 認 証 を 削 除 し 、 そ れ 以 降 は 、 こ の 認 証 を 使 っ た 接 続 の 試 み は 失 敗 す る 。 サ ー バ に よ る 削 除 で は 、 認 証 フ ァ イ ル 内 の 認 証 エ ン ト リ ー の 削 除 は 行 わ れ な い 点 に 注 意 す る こ と 。 timeout の デ フ ォ ル ト 値 は 60 秒 で あ る 。

group オ プ シ ョ ン は 、 こ の 認 証 で 接 続 す る ク ラ イ ア ン ト の 属 す る ア プ リ ケ ー シ ョ ン グ ル ー プ を 指 定 す る 。 詳 細 に つ い て は ア プ リ ケ ー シ ョ ン グ ル ー プ 機 能 拡 張 の 仕 様 を 参 照 す る こ と 。 デ フ ォ ル ト で は ど の ア プ リ ケ ー シ ョ ン グ ル ー プ に も 属 し て い な い 。

data オ プ シ ョ ン は サ ー バ が 認 証 を 生 成 す る た め に 使 用 す る デ ー タ を 指 定 す る 。 こ れ は 認 証 フ ァ イ ル に 書 き 込 ま れ る デ ー タ と 同 じ で は な い 点 に 注 意 す る こ と 。 こ の デ ー タ の 解 釈 は 認 証 プ ロ ト コ ル に 依 存 す る 。 hexdata の 書 式 は add コ マ ン ド の 中 に 記 述 す る hexkey と 同 じ で あ る 。 デ フ ォ ル ト で は デ ー タ を 送 信 し な い 。

[n]extract filename displayname... 指 定 し た デ ィ ス プ レ イ 毎 の 認 証 エ ン ト リ ー が 指 定 し た フ ァ イ ル に 書 き 込 ま れ る 。 nextract コ マ ン ド を 使 用 す る と 、 認 証 エ ン ト リ ー は (危 険 の な い 電 子 メ ー ル の よ う な )バ イ ナ リ 形 式 で な い 送 信 に 向 い て い る 数 値 書 式 で 書 か れ る 。 取 り 出 さ れ た エ ン ト リ ー は merge と nmerge コ マ ン ド を 使 っ て 読 み 戻 す こ と が で き る 。 フ ァ イ ル 名 が ハ イ フ ン ひ と つ だ け (’-’) で あ る 場 合 は 、 エ ン ト リ ー は 標 準 出 力 に 書 き 出 さ れ る 。
[n]list [displayname...] 指 定 し た デ ィ ス プ レ イ 毎 (デ ィ ス プ レ イ 名 が 無 い 場 合 は 全 て )の 認 証 エ ン ト リ ー が 標 準 出 力 に 出 力 さ れ る 。 nlist コ マ ン ド を 使 っ た 場 合 は 、 認 証 エ ン ト リ ー は nextract コ マ ン ド の 説 明 で 示 し た 数 値 形 式 で 表 示 さ れ る 。 そ う で な い 場 合 に は 、 文 字 列 形 式 で 表 示 さ れ る 。 鍵 デ ー タ は 常 に add コ マ ン ド で 説 明 し た 16進 数 形 式 で 表 示 さ れ る 。
[n]merge [filename...] 認 証 エ ン ト リ ー が 指 定 し た フ ァ イ ル か ら 読 み 込 ま れ 、 認 証 デ ー タ ベ ー ス に マ ー ジ さ れ る 。 こ の 際 、 既 存 の エ ン ト リ ー に 一 致 す る エ ン ト リ ー は 上 書 き さ れ る 。 nmerge コ マ ン ド を 使 用 す る 場 合 は 、 extract コ マ ン ド の 項 目 で 説 明 し た 数 値 形 式 が 使 わ れ る 。 フ ァ イ ル 名 が ダ ッ シ ュ ひ と つ だ け (’-’)で あ る 場 合 、 標 準 入 力 が 以 前 に 読 み 込 ま れ て い な け れ ば 、 エ ン ト リ ー は 標 準 入 力 か ら 読 み 込 ま れ る 。
remove displayname... 指 定 し た デ ィ ス プ レ イ と マ ッ チ す る 認 証 エ ン ト リ ー は 認 証 フ ァ イ ル か ら 取 り 除 か れ る 。
source filename 指 定 し た フ ァ イ ル は 、 実 行 す る xauth コ マ ン ド を 持 つ ス ク リ プ ト と し て 扱 わ れ る 。 空 白 行 と シ ャ ー プ (#)で 始 ま る 行 は 無 視 さ れ る 。 フ ァ イ ル 名 が 単 に ダ ッ シ ュ ひ と つ だ け (’-’)で あ る 場 合 、 標 準 入 力 が 既 に 読 み 込 み 済 み で な け れ ば 、 エ ン ト リ ー は 標 準 入 力 か ら 読 み 込 ま れ る 。

コ マ ン ド の 読 み 込 み 元 を 標 準 出 力 に 出 力 す る 。

グ ラ ム は 終 了 す る 。 フ ァ イ ル の 終 り は 暗 黙 の exit コ マ ン ド と し て 扱 わ れ る 。

help [string] 与 え た 文 字 列 で 始 ま る す べ て の コ マ ン ド (省 略 し た と き は 全 コ マ ン ド )の 説 明 を 標 準 出 力 に 表 示 す る 。

デ ィ ス プ レ イ 名

add, [n]extract, [n]list, [n]merge, remove で 用 い る デ ィ ス プ レ イ 名 で は 、 環 境 変 数 DISPLAY や 共 通 の −display コ マ ン ド 行 引 き 数 と 同 じ 形 式 が 使 わ れ る 。 デ ィ ス プ レ イ 固 有 の 情 報 (ス ク リ ー ン 番 号 な ど )は 必 須 で は な く 無 視 さ れ る 。 同 一 マ シ ン 上 で の 接 続 (ロ ー カ ル ホ ス ト ソ ケ ッ ト 、 共 有 メ モ リ 、 IP ホ ス ト 名 の localhostな ど )は hostname/unix:displaynumber の 形 式 で 参 照 さ れ る の で 、 異 な る マ シ ン に 対 す る ロ ー カ ル の エ ン ト リ ー は ひ と つ の 認 証 フ ァ イ ル に 格 納 す る こ と が で き る 。

例

xauth の も っ と も 一 般 的 な 使 用 法 は 、 現 在 の デ ィ ス プ レ イ の エ ン ト リ ー を 取 り 出 し 、 こ れ を 他 の マ シ ン に コ ピ ー し て 、 リ モ ー ト マ シ ン の ユ ー ザ の 認 証 フ ァ イ ル に マ ー ジ す る こ と で あ る :

% xauth extract − $DISPLAY | rsh otherhost xauth merge − 次 の コ マ ン ド は サ ー バ : 0 に 接 続 し 、 MIT-MAGIC-COOKIE-1 プ ロ ト コ ル を 使 用 し て 認 証 を 作 成 す る 。 こ の 認 証 で 接 続 す る ク ラ イ ア ン ト は 信 頼 さ れ な い 。
% xauth generate :0 .

環 境 変 数

xauth プ ロ グ ラ ム は 次 の 環 境 変 数 を 使 用 す る :
XAUTHORITY

−f オ プ シ ョ ン を 使 用 し て い な い 場 合 に 認 証 フ ァ イ ル の 名 前 を 得 る 。

フ ァ イ ル

$HOME/.Xauthority

XAUTHORITY が 定 義 さ れ て い な い 場 合 の デ フ ォ ル ト の 認 証 フ ァ イ ル 。

バ グ

安 全 で な い ネ ッ ト ワ ー ク を 使 っ て い る ユ ー ザ は 、 マ シ ン 間 で 認 証 エ ン ト リ ー を コ ピ ー す る 際 に は 暗 号 化 さ れ た フ ァ イ ル 転 送 の 機 構 を 注 意 深 く 使 用 す る べ き で あ る 。 同 様 に 、 MIT-MAGIC-COOKIE-1 プ ロ ト コ ル は 安 全 で な い 環 境 で は あ ま り 役 に 立 た な い 。 セ キ ュ リ テ ィ 強 化 に 留 意 し て い る サ イ ト で は 、 Kerberos の よ う な 暗 号 化 認 証 機 構 を 使 用 す る 必 要 が あ る だ ろ う 。 現 在 、 プ ロ ト コ ル 名 で は 空 白 が 使 用 で き な い 。 そ ん な ひ ね く れ た 仕 様 に し な く て も 、 ク ォ ー ト を 追 加 で き た は ず で あ る が 。

著 者

Jim Fulton, MIT X Consortium