piernov

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Auth with SuckerServ-v5 ======
Because Authserver isn't included anymore in SuckerServ-v5, you'll need to checkout the suckerserv-v3 repository, or use MasterLua (new Master/Auth server, not described here):
<code bash>
svn co http://suckerserv.googlecode.com/svn/branches/suckerserv-v3
cd suckerserv-v3
</code>
===== Dependencies =====
==== With MySQL (recommended) ====
If you want to use a MySQL Database, you'll need :
  * a working MySQL server, with a dedicated database and user for the authserver.
  * the MySQL-Client header (mysql.h), commonly //''libmysqlclient-dev''// package.
==== With SQLite3 ====
All requiered dependencies are shipped with SuckerServ
==== With a text database ====
No dependencies requiered
===== Compile and Install authserver's binary =====
==== Compiling Authserver ====
<code bash>
chmod +x compile.sh
./compile.sh
</code>
===== Configuration =====
==== Authserver ====
=== With SQLite3 ===
Edit the conf/authserver.conf file, and remove the # at the beginning of this line: 
<code bash>#use_sqlite_database "./db"</code>
Add a # at the beginning of this one:
<code bash>use_text_database "./log/auths.txt"</code>
=== With MySQL ===
Edit the conf/authserver.conf file, and remove the # at the beginning of this line: 
<code bash>#use_mysql_database "hostname" "port" "database" "username" "password" "install_db"</code>
Set correctly the hostname (localhost by default), the port (3306 by default), the database, the username, the password and remove "install_db" if the database schemas and triggers are already installed into the database. \\
Add a # at the beginning of this one:
<code bash>use_text_database "./log/auths.txt"</code>
==== SuckerServ ====
=== Auth.lua ===
Add an ''auth.lua'' file in the conf/ directory of your SuckerServ installation if there's not one already, with the following :\\
**WARNING:** Don't use `localhost` as hostname since it's broken. Use `127.0.0.1` instead.
<code lua auth.lua>
auth.directory.server{
    id = "suckerserv",
    hostname = "127.0.0.1",
    port = 28787
}

auth.directory.domain{
    id = "suckerserv",
    server = "suckerserv"
}

auth.directory.domain{
    id = "suckerserv:master",
    server = "suckerserv"
}

auth.directory.domain{
    id = "suckerserv:admin",
    server = "suckerserv"
}
</code>
=== Server.conf ===
Add the following in your server.conf, replacing content of domains variables by what you set above:
<code lua server.conf>
###############################################################################
# Authkey configuration for Name protection & Admin
###############################################################################

admin_domains "suckerserv:admin"            # Domain for admin
invadmin_domains "suckerserv:admin"         # Same
auto_invadmin_domains "suckerserv:admin"    # Same, if you want to be auto-invadmin at connection

master_domains "suckerserv:master"          # Domain for master
invmaster_domains "suckerserv:master"       # Same
auto_invmaster_domains "suckerserv:master"  # Same, if you want to be auto-invadmin at connection

name_reservation_domain "suckerserv"        # Domain for name protect
auth_domains "suckerserv"                   # Domain for privileges with new authserver

module "auth/name"                          # Module for name protect
module "auth/invmaster"                     # Module for auto-invmaster
module "auth/invadmin"                      # Module for auto-invadmin
#module "auth/privileges"                   # New privileges module to set inv-master/admin with new authserver. Disable auth/invadmin and auth/invmaster before enabling this 
</code>
===== Using authserver =====
==== With MySQL ====
Run once the authserver, and then remove the ''install_db'' in your authserver.conf
==== Run it ====
To launch the authserver, just do:
<code bash>./bin/authserver start</code>
In the suckerserv-v3 directory
==== Adding domains ====
<code bash>./bin/authserver manage domain add "suckerserv" case_insensitive</code>
<code bash>./bin/authserver manage domain add "suckerserv:master" case_insensitive</code>
<code bash>./bin/authserver manage domain add "suckerserv:admin" case_insensitive</code>
==== Adding users ====
Before adding users, you have to add domains, described before.\\
To add an user for name protection, firstly generate a pair of keys:
<code bash>./bin/utils/keygen</code>
Then copy the output. The first line is the private key, the one that you have to give to the user.\\
The user add something like this:
<code bash>authkey "the_user" "private_key" "suckerserv"</code>
in his auth.cfg\\
The second line is the public_key, you have to add it in the database:
<code bash>./bin/authserver manage user add "the_user" "suckerserv" "public_key"</code>
Now same for master, but replace the domain by your master domain:\\
The master add this in his auth.cfg
<code bash>authkey "the_admin" "private_key" "suckerserv:master"</code>
And in the server:
<code bash>./bin/authserver manage user add "the_user" "suckerserv:master" "public_key"</code>
And same for admin, but replace the domain by your admin domain:\\
The admin add this in his auth.cfg
<code bash>authkey "the_admin" "private_key" "suckerserv:admin"</code>
And in the server:
<code bash>./bin/authserver manage user add "the_user" "suckerserv:admin" "public_key"</code>
Remember, an authkey is unique, so don't loose it, and create one for each user.
==== Restart the authserver ====
After adding an authkey, you have to restart the authserver:
<code bash>./bin/authserver stop</code>
<code bash>./bin/authserver start</code>
===== In-Game =====
Now, all admins (added in the previous section) should be set automatically to invadmin, and all masters to invmaster.\\
And all users must have their authkey for the server doesn't change their name.\\
And all stats are recorded into single name, even changing it or IP, if you keep the authkey.\\