CAP (capability)

• 0.0.1  履歴
• 1.0.0 CAP とは
• 2.0.0 cap の使い方
• 2.1.0 望ましい姿
• 2.2.0 問題の起源
• 3.0.0 su ver.1.2
• 3.1.0 su ver.1.2
• 3.2.0 UNIX
• 3.3.0 Plan 9
• 3.4.0 私は誰?
• 3.4.1  プロセスの owner
• 3.4.2  ファイルの owner
• 3.5.0 認証の基本的な考え方
• 3.5.1  プロセスの認証
• 3.5.2  ファイルの認証
• 3.6.0 実験
• 3.6.1  認証のいらない Plan 9 端末
• 3.6.2  認証サーバでは
• 3.6.3  認証の必要な Plan 9 端末
• 3.6.4  CPU サーバでは
• 3.7.0 チェックポイント
• 3.8.0 まとめ
• 3.9.0 ユーザ none について
• 3.10.0 エラーメッセージ
• 3.10.1  パスワードを与えていないときに発生するエラー
• 3.10.2  パスワードを与えたときに発生するエラー
• 4.0.0 おわりに

履歴

• 2004/11/07 改訂と訂正(ユーザ none について)
  
• 2004/11/04 追加と訂正
  
• 2004/11/02 訂正
  
• 2004/10/29 訂正
  
• 2004/10/25 追加
  
• 2004/10/23
  H2: CAP とは
  Plan 9 第4版になっていくつかの新しい技術が Plan 9 に導入された。それらの代表的なものは
  
• venti
  
• fossil
  
• secstore
  
• cap
  

cap の使い方

/*
*
*	usage: su user
*
*	This program illustrate how to use
*		/dev/caphash
*		/dev/capuse
*
*	This program must be run by hostowner
*
*	[1] TRY in fscons: open -AW
*	- hostowner can become any user without authentication
*	- user need not be registered in /adm/users
*	- user need not be registered in /mnt/factotum/ctl
*	[2] TRY on cpu server with regular open mode of fscons (no -APW)
*	- hostowner can become any real user without authentication
*	- user need be registered in /adm/users
*	- user need not be registered in /mnt/factotum/ctl
*
*	Ref:
*	- cap(3)
*	- sechash(2)
*	- /sys/src/cmd/cpu.c
*/
#include <u.h>
#include <libc.h>
#include <mp.h>
#include <libsec.h>
#include <auth.h>
#define ERRLEN 256

static int
waitfor(int pid, char *msg)
{
	Waitmsg *w;
	while((w = wait()) != nil){
		if(w->pid == pid){
			strncpy(msg, w->msg, ERRMAX);
			free(w);
			return 0;
		}
		free(w);
	}
	return -1;
}


void main(int argc, char *argv[])
{	int fd, i, n, pid, status;
	char *user, *newuser, *key;
	uchar hash[SHA1dlen];
	AuthInfo ai;
	char buf[256];
	char msg[ERRLEN];

	USED(argc); USED(argv);
	argv++;
	if(*argv == nil)
		sysfatal("usage: su user");

	newuser = *argv; // a user you want to be
	user = getuser(); // this user must be host owner

	switch(pid = rfork(RFNOTEG|RFPROC|RFFDG|RFNAMEG)) {/* assign = */
	case -1:
		sysfatal("fork");
	case 0: /* child process */
		break;
	default:
		close(0);
		close(1);
		close(2);
		status = waitfor(pid, msg);
		if(status < 0)
			sysfatal("waitfor: %r");
		exits(nil);
	}

	/* key must be a null terminated string */
	srand(truerand());
	for(i = 0; i < 10; i++)
		sprint(buf+2*i, "%2.2ux", rand());
	key = strdup(buf);

	snprint(buf, sizeof buf, "%s@%s", user, newuser);
	hmac_sha1((uchar*)buf, strlen(buf), (uchar*)key, strlen(key), hash, nil);

	/*	only hostowner can write to /dev/caphash  */
	fd = open("/dev/caphash", OWRITE);
	if(fd < 0)
		sysfatal("unable to open /dev/caphash: %r\n");
	n = write(fd, hash, sizeof hash);
	if(n < 0)
		sysfatal("unable to write /dev/caphash: %r\n");
	close(fd);

	ai.cuid = newuser;
	snprint(buf, sizeof buf, "%s@%s@%s", user, newuser, key);
	ai.cap = buf;
	/*	- auth_chuid writes ai.cap internally to /dev/cap	*
	*		look /sys/src/libauth/auth_chuid.c			*
	* 	- you must call auth_chuid within 1 min			*
	*	after you write to caphash 						*/
	if(auth_chuid(&ai, nil) < 0)
		sysfatal("could't become the user:%r");

	putenv("prompt", "su# ");
	execl("/bin/rc", "rc", "-i", nil);
}

望ましい姿

問題の起源

	cat /mnt/factotum/ctl

su ver.1.2

• 2004/11/04 訂正
  
• 2004/11/02 改訂
  
• 2004/10/29 追加
  

su ver.1.2

	adom=aichi-u.ac.jp
	su -p xxxxx alice

UNIX

Plan 9

私は誰?

プロセスの owner

	ps | grep ps

ファイルの owner

認証の基本的な考え方

プロセスの認証

ファイルの認証

実験

認証のいらない Plan 9 端末

	su alice

認証サーバでは

	su alice

	su -p xxxxx alice

認証の必要な Plan 9 端末

	su alice

	su -p xxxxxx alice

CPU サーバでは

	su alice

	su -p xxxxxx alice

チェックポイント

• /adm/users にファイルサーバ毎に登録されているか?
  
• /adm/users で noworld グループに組み込まれていないか?
  
• 認証サーバの /lib/ndb/auth で認証が拒否されていないか?
  adm と sys は標準設定では拒否されている。
  
• バスワードを与えられているか?
  認証サーバの /mnt/keys/$user/key で確認
  
• ホームディレクトリを持っているか?
  

	disk/kfscmd users

	users -r /active/adm/users

まとめ

ユーザ none について

• 2004/11/07 訂正
  
• 2004/11/04 追加
  

none の扱いは Plan 9 の歴史の中でいろいろな変遷を辿って来たと思う。詳しくは "ユーザ none" を見よ。

エラーメッセージ

パスワードを与えていないときに発生するエラー

	su alice

• mkcap;permission denied
  ホストオーナが su を実行していない
  

パスワードを与えたときに発生するエラー

	su -p xxxxx alice

• no adom env
  環境変数 adom が設定されていない
  
• passwd: remote: cr-fail authentication failed allice
  パスワードが間違っている、あるいはパスワードが登録されていない
  
• execl: permission denied
  alice は noworld ユーザである、あるいは /lib/ndb/auth で認証が禁止されている
  
• execl: '/bin/rc' does not exist
  alice は /usr/alice/lib/profile を持たない
  

おわりに