ActiveSambaLdap 0.0.7

data/README.ja

@@ -0,0 +1,361 @@
+= README.ja
+
+$Id: README.ja 160 2009-07-11 00:43:32Z kou $
+
+== 名前
+
+ActiveSambaLdap
+
+== 説明
+
+ActiveSambaLdapはSamba用LDAPエントリを管理するための
+ActiveRecord風なライブラリです．また，smbldap-toolsのような
+管理用コマンドラインツールも提供します．
+
+== 作者
+
+Kouhei Sutou <tt><kou@clear-code.com></tt>
+
+== ライセンス
+
+Ruby's.
+
+== 依存ライブラリ
+
+* ActiveLdap >= 1.1.0
+
+== インストール
+
+  % sudo gem install activesambaldap
+
+== メーリングリスト
+
+asl-devel-ja@rubyforge.org
+
+http://rubyforge.org/mailman/listinfo/asl-devel-ja/
+
+== リファレンスマニュアル
+
+http://asl.rubyforge.org/activesambaldap/
+
+== 使用法
+
+=== Railsと使う
+
+まず，Rails用プラグインをインストールします．以下のURLは
+trunk用ですので，環境にあわせて変更してください．
+
+  % script/plugin install svn://rubyforge.org/var/svn/asl/trunk/rails/plugin/active_samba_ldap
+
+次に，Rails用ActiveSambaLdap環境を構築します．
+
+  % script/generate scaffold_active_samba_ldap
+
+config/ldap.ymlが生成されるので，環境にあわせて編集します．
+指定できるオプションは，以下の「設定ファイルのオプション」の
+項を参考にしてください．
+
+==== 初期化
+
+はじめに，Samba + LDAP環境を初期化する必要があります．
+script/serverなどでRailsを起動し，
+http://localhost:3000/sambaにアクセスしてください．
+「Populate Samba + LDAP environment」というリンクがあるので，
+それを使ってSamba + LDAP環境を初期化します．
+
+あとは，ActiveRecordを利用した開発と同じように，
+User/Computer/Groupクラスなどを使用して開発してください．
+
+=== コマンドラインから使う
+
+asl-*というコマンドを使います．asl-samba-*はsmb.confに設定す
+るためのコマンドで，ターミナルから使うことはありません．
+
+==== 設定
+
+まず，あなたの環境にあわせて設定ファイルを編集します．デフォ
+ルトで読み込まれるファイルは--helpオプションをつけて起動する
+と確認できます．asl-*のどのコマンドでも表示されます．例えば，
+asl-populateを使うとこうなります．
+
+  % asl-populate --help
+  ...
+        --config=CONFIG              Specify configuration file
+                                     Default configuration files:
+                                       /etc/activesambaldap/config.yaml
+                                       /etc/activesambaldap/bind.yaml
+                                       /home/kou/.activesambaldap.conf
+                                       /home/kou/.activesambaldap.bind
+  ...
+
+設定ファイルは上から順に読み込まれていきます．設定内容は後の
+ファイルで上書きされます．上記の例だと，以下の順序で読み込ま
+れていきます．
+
+* /etc/activesambaldap/config.yaml
+* /etc/activesambaldap/bind.yaml
+* /home/kou/.activesambaldap.conf
+* /home/kou/.activesambaldap.bind
+
+config.yamlや*.confの後にbind.yamlや*.bindを読み込んでいるの
+はセキュリティ上の配慮です．ホスト名などの見られてもよい情報
+はconfig.yamlや*.confに書き，認証情報など見られてはまずい情
+報はbind.yamlや*.bindに書き，適切なパーミッションを設定する
+とよいでしょう．
+
+==== 設定ファイルの書式
+
+YAMLで記述します．三つのセクションからなります．
+
+  update:
+    # LDAPエントリを更新する時の設定
+    ...
+
+  reference:
+    # LDAPエントリを参照する時の設定
+    ...
+
+  common:
+    # 更新時／参照時で共有の設定
+    ...
+
+例えば，以下のようになります．
+
+  common:
+    sid: S-1-5-21-915876905-2926214379-2876160357
+    base: dc=samba,dc=local,dc=net
+    host: localhost
+    method: :tls
+
+  update:
+    bind_dn: cn=admin,dc=local,dc=net
+    password: admin
+
+  reference:
+    allow_anonymous: true
+
+passwordはbind.yamlや*.bindに記述するとよいでしょう．
+
+baseは必ず設定してください．また，sidも設定しておくとよいで
+しょう．sidの値は以下のコマンドで確認できます．
+
+  % sudo net getlocalsid
+
+sidを設定しておかないと，毎回net getlocalsidをするため，効率
+が悪くなります．
+
+==== 設定ファイルのオプション
+
+設定可能なオプションは以下の通りです．
+
+[_base_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_host_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_port_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_scope_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_bind_dn_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_password_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_method_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+[_allow_anonymous_]
+   ActiveLdap::Base.setup_connectionのオプションと同じ．
+
+[_sid_]
+   SambaサーバのSID(Security Identifier)．
+[_smb_conf_]
+   Sambaの設定ファイルsmb.confがあるパス．
+[_samba_domain_]
+   Sambaサーバのドメイン
+[_samba_netbios_name_]
+   SambaサーバのNetBIOS名
+
+[_password_hash_type_]
+   LDAP上のパスワードをハッシュ化する時に使用するアルゴリズ
+   ム．指定できるの
+   は+:crypt+, +:md5+, +:smd5+, +:sha+, +:ssha+です。
+
+   LDAP上のパスワードはSambaの認証時ではなく，UNIX上のユーザ
+   の認証時に利用されます．
+
+   デフォルト: +:ssha+
+
+[_users_suffix_]
+   LDAP上のユーザエントリを格納するツリー．baseからの相対パ
+   スを指定する．
+
+   例: <tt>"ou=Users"</tt>
+
+[_groups_suffix_]
+   LDAP上のグループエントリを格納するツリー．baseからの相対パ
+   スを指定する．
+
+   例: <tt>"ou=Groups"</tt>
+
+[_computers_suffix_]
+   LDAP上のコンピュータエントリを格納するツリー．baseからの相対パ
+   スを指定する．
+
+   例: <tt>"ou=Computers"</tt>
+
+[_idmap_suffix_]
+   LDAP上のidmapエントリを格納するツリー．baseからの相対パ
+   スを指定する．
+
+   例: <tt>"ou=Idmap"</tt>
+
+[_start_uid_]
+   新しいユーザを作ったときに，はじめに使用するUID(User
+   Identifier)．以降のUIDは1ずつ増えていく．
+
+   デフォルト: +10000+
+
+[_start_gid_]
+   新しいユーザを作ったときに，はじめに使用するGID(Group
+   Identifier)．以降のGIDは1ずつ増えていく．
+
+   デフォルト: +10000+
+
+[_user_login_shell_]
+   新しく作成したユーザのログインシェル．
+
+   デフォルト: <tt>"/bin/false"</tt>
+
+[_user_home_directory_]
+   新しく作成したユーザのホームディレクトリ．%Uはユーザ名に
+   置換される．
+
+   デフォルト: <tt>"/home/%U"</tt>
+
+[_user_home_directory_mode_]
+   ユーザのホームディレクトリを作成する際に設定するパーミッ
+   ション用のモード．
+
+   デフォルト: +0755+（8進数）
+
+[_user_gecos_]
+   ユーザのGECOSフィールドの値．%Uはユーザ名に置換される．
+
+[_user_home_unc_]
+   Windowsから見たときのユーザのホームへのパス．
+   UNC(Universal Naming Convention)で記述する．%Uはユーザ名
+   に置換される．
+
+   デフォルト: <tt>"\\\\SambaサーバのNetBIOS名\\%U"</tt>
+
+[_user_profile_]
+   ユーザプロファイルへのパス．
+   UNC(Universal Naming Convention)で記述する．%Uはユーザ名
+   に置換される．
+
+   デフォルト: <tt>"\\\\SambaサーバのNetBIOS名\\profiles\\%U"</tt>
+
+[_user_home_drive_]
+   ユーザのホームを割り当てるドライブ名．
+
+   デフォルト: <tt>"H:"</tt>
+
+[_user_logon_script_]
+   ユーザがログオンしたときに実行するスクリプトファイル名．
+
+   デフォルト: <tt>"logon.bat"</tt>
+
+[_skeleton_directory_]
+   ユーザのホームディレクトリを作成する時に雛型とするディレ
+   クトリ．
+
+   デフォルト: <tt>"/etc/skel"</tt>
+
+[_default_user_gid_]
+   デフォルトでユーザが所属するグループ．
+
+   デフォルト: <tt>"Domain Users"</tt>グループ
+
+[_default_computer_gid_]
+   デフォルトでコンピュータが所属するグループ．
+
+   デフォルト: <tt>"Domain Computers"</tt>グループ
+
+==== 初期化
+
+asl-*を用いてSamba + LDAP環境を管理する前に，一度だけ
+asl-populateを起動してLDAPサーバに基本的なエントリを追加しま
+す．
+
+  % sudo asl-populate
+
+もし，root権限が無くても実行できるのであれば以下のようにする
+とよいでしょう．（root権限チェックは必要ないかもしれない）
+
+  % fakeroot asl-populate
+
+==== 管理
+
+コマンドラインからはasl-user*, asl-group*, asl-populate,
+asl-purge, asl-passwordを使って管理してください．各コマンド
+の使いかたは--helpオプションを参考にしてください．
+
+==== smb.confの設定
+
+Srvtools[http://support.microsoft.com/kb/173673/]を使って
+Windowsからユーザ管理を行いたい場合は，また，Sambaをドメイン
+コントローラとして動作させたい場合は，以下のようにsmb.confを
+設定します．ここでは，asl-samba-*を使います．
+
+（ドメインコントローラとして動作させるけど，Srvtools でユー
+ザ管理を行わない場合はadd machine script以外のなんとかscript
+は設定しなくてもよい気がする．）
+
+  passdb backend = ldapsam:ldap://127.0.0.0
+  ldap admin dn = cn=admin,dc=local,dc=net
+  ldap suffix = dc=samba,dc=local,dc=net
+  ldap user suffix = ou=Users
+  ldap group suffix = ou=Groups
+  ldap machine suffix = ou=Computers
+  ldap idmap suffix = ou=Idmap
+  ldap passwd sync = yes
+
+  admin users = "@Domain Admins"
+  add user script = /.../asl-samba-useradd "%u"
+  delete user script = /.../asl-samba-userdel "%u"
+  add group script = /.../asl-samba-groupadd "%g"
+  delete group script = /.../asl-samba-groupdel "%g"
+  add user to group script = /.../asl-samba-groupmod "%g" --add-members "%u"
+  delete user from group script = /.../asl-samba-groupmod "%g" --delete-members "%u"
+  set primary group script = /.../asl-samba-usermod "%u" --gid "%g"
+  add machine script = /.../asl-samba-computeradd "%u"
+
+Sambaを起動する前に，以下を実行してldap admin dnで指定した
+LDAP管理ユーザのパスワードを設定しておく必要があります．
+
+  % sudo /usr/bin/smbpasswd -W
+
+== トラブルシューティング
+
+=== グループ一覧がでない
+
+以下のコマンドでグループ一覧を表示する事ができます。
+
+  % net rpc group list --user=USER_NAME
+
+もし、asl-populateした後なのに上記のコマンドでひとつもグルー
+プがでない場合は以下のことを確認してください。
+
+* samba.schemaが古くないか
+
+  sambaSIDのエントリに以下の設定がない場合は古い
+  samba.schemaである可能性があります。最新のものに更新して
+  ください。
+
+    SUBSTR caseExactIA5SubstringsMatch
+
+== 感謝
+
+* Henrik Krög: バグを報告してくれました。
+* Olivier DIRRENBERGER: バグを報告してくれました。
+* Francesco Malvezzi: バグを報告してくれました。
+* Kazuhiro NISHIYAMA: バグを報告してくれました。

data/Rakefile

@@ -0,0 +1,168 @@
+# -*- ruby -*-
+
+require 'find'
+require 'fileutils'
+
+base_dir = File.expand_path(File.dirname(__FILE__))
+truncate_base_dir = Proc.new do |x|
+  x.gsub(/^#{Regexp.escape(base_dir + File::SEPARATOR)}/, '')
+end
+
+_binding = binding
+file = "#{base_dir}/lib/active_samba_ldap.rb"
+eval(File.read(file), _binding, file)
+eval('require_gem_if_need.call("hoe")', _binding)
+required_active_ldap_version = eval('required_active_ldap_version', _binding)
+
+manifest = File.join(base_dir, "Manifest.txt")
+manifest_contents = []
+base_dir_included_components = %w(README.ja README.en NEWS.ja NEWS.en setup.rb
+                                  Rakefile)
+excluded_components = %w(.svn .test-result .config Manifest.txt config.yml doc
+                         pkg html config.yaml)
+excluded_suffixes = %w(.help)
+Find.find(base_dir) do |target|
+  target = truncate_base_dir[target]
+  components = target.split(File::SEPARATOR)
+  if components.size == 1 and !File.directory?(target)
+    next unless base_dir_included_components.include?(components[0])
+  end
+  Find.prune if (excluded_components - components) != excluded_components
+  next if excluded_suffixes.include?(File.extname(target))
+  manifest_contents << target if File.file?(target)
+end
+
+File.open(manifest, "w") do |f|
+  f.puts manifest_contents.sort.join("\n")
+end
+at_exit do
+  FileUtils.rm_f(manifest)
+end
+
+def cleanup_white_space(entry)
+  entry.gsub(/(\A\n+|\n+\z)/, '') + "\n"
+end
+
+# For Hoe's no user friendly default behavior. :<
+File.open("README.txt", "w") {|file| file << "= Dummy README\n== XXX\n"}
+FileUtils.cp("NEWS.en", "History.txt")
+at_exit do
+  FileUtils.rm_f("README.txt")
+  FileUtils.rm_f("History.txt")
+end
+
+ENV["VERSION"] = ActiveSambaLdap::VERSION
+project = Hoe.spec("activesambaldap") do
+  self.version = ActiveSambaLdap::VERSION
+  self.rubyforge_name = "asl"
+  self.name = "ActiveSambaLdap"
+  self.summary = "Samba+LDAP administration tools"
+  self.extra_deps << ["activeldap", required_active_ldap_version]
+  self.email = ["kou@clear-code.com"]
+  self.author = "Kouhei Sutou"
+  self.url = "http://asl.rubyforge.org/"
+
+  news_of_current_release = File.read("NEWS.en").split(/^==\s.*$/)[1]
+  self.changes = cleanup_white_space(news_of_current_release)
+
+  entries = File.read("README.en").split(/^==\s(.*)$/)
+  whats_this = cleanup_white_space(entries[entries.index("Description") + 1])
+  self.summary, self.description, = whats_this.split(/\n\n+/, 3)
+end
+
+
+rdoc_main = "README.en"
+
+rdoc_task = nil
+if ObjectSpace.each_object(Rake::RDocTask) {|rdoc_task|} != 1
+  puts "hoe may be changed"
+end
+rdoc_task.main = rdoc_main
+rdoc_task.options.delete("-d")
+rdoc_task.options << "--charset=UTF-8"
+rdoc_task.rdoc_files -= project.spec.executables
+rdoc_task.rdoc_files += project.spec.executables.collect {|x| "bin/#{x}.help"}
+rdoc_task.rdoc_files += project.spec.files.find_all {|x| /\.(en|ja)\z/ =~ x}
+rdoc_task.rdoc_files.reject! {|file| /\Atest-unit\// =~ file}
+
+rdoc_options = rdoc_task.option_list
+output_option_index = rdoc_options.index("-o")
+rdoc_options[output_option_index, 2] = nil
+project.spec.rdoc_options = rdoc_options
+project.spec.extra_rdoc_files = rdoc_task.rdoc_files
+
+project.spec.executables.each do |bin|
+  bin = "bin/#{bin}"
+  bin_help = "#{bin}.help"
+  File.open(bin_help, "w") do |f|
+    lang = ENV["LANG"]
+    ENV["LANG"] = "C"
+    f.puts(`#{RUBY} -I #{File.join(base_dir, 'lib')} #{bin} --help`)
+    ENV["LANG"] = lang
+  end
+  at_exit do
+    FileUtils.rm_f(bin_help)
+  end
+end
+
+task :docs do
+  css_file = "doc/rdoc.css"
+  css = File.read(css_file)
+  reset_spacing = Regexp.escape("*{ padding: 0; margin: 0; }")
+  customized_css = css.sub(/#{reset_spacing}/, '')
+  if css != customized_css
+    File.open(css_file, "w") do |output|
+      output.print(customized_css)
+    end
+  end
+end
+
+desc 'Tag the repository for release.'
+task :tag do
+  version = ActiveSambaLdap::VERSION
+  message = "Released ActiveSambaLdap #{version}!"
+  base = "svn+ssh://#{ENV['USER']}@rubyforge.org/var/svn/asl/"
+  sh 'svn', 'copy', '-m', message, "#{base}trunk", "#{base}tags/#{version}"
+end
+
+desc "Distribute new release."
+task :dist => [:publish_docs, :release, :tag, :announce]
+
+desc "Update *.po/*.pot files and create *.mo from *.po files"
+task :gettext => ["gettext:po:update", "gettext:mo:create"]
+
+namespace :gettext do
+  desc "Setup environment for GetText"
+  task :environment do
+    require "gettext/utils"
+  end
+
+  namespace :po do
+    desc "Update po/pot files (GetText)"
+    task :update => "gettext:environment" do
+      module GetText::RGetText
+        class << self
+          alias_method :generate_pot_original, :generate_pot
+          def generate_pot(ary)
+            ary = ary.collect {|key, *other| [key.gsub(/\\/, "\\\\\\"), *other]}
+            generate_pot_original(ary)
+          end
+        end
+      end
+      files = Dir.glob("{lib,rails}/**/*.rb")
+      files += Dir.glob("bin/asl*")
+      GetText.update_pofiles("active-samba-ldap",
+                             files,
+                             "Ruby/ActiveSambaLdap #{ActiveSambaLdap::VERSION}")
+    end
+  end
+
+  namespace :mo do
+    desc "Create *.mo from *.po (GetText)"
+    task :create => "gettext:environment" do
+      GetText.create_mofiles(false)
+    end
+  end
+end
+
+task(:gem).prerequisites.unshift("gettext:mo:create")