netsoul 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1fca4fc8cb31539dcadae7a5435367ccf62b30d8
+  data.tar.gz: 39ae71d45700d0a145d35a0c530471753e104e97
+SHA512:
+  metadata.gz: d4b8ef7653cb49dba99db630aded565bfce9c4eb4aeca92e02ea74ffd112979f913bfd3be2e7ab8ef1d2f57772e8873514b912ca2c4eb7af264270a0c1b4814f
+  data.tar.gz: 44c2dfa0b942484e5d4c079d3b46bd5fe1614c36eb4d0f554aefc12eeee9d6de5e7df0360583dbfeed6e4977a370a1c9dcb1248391e68b21bdd562290c80612a

data/.gitignore

@@ -0,0 +1,42 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+/.yardoc
+/Gemfile.lock
+/.idea/
+/lib/*.so
+/lib/*.dll
+/lib/*.dylib

data/.pullreview.yml

@@ -0,0 +1,77 @@
+---
+rules:
+  ignore:
+#  - add_db_index
+#  - add_underscores_to_large_numeric
+#  - always_else_in_case
+#  - ambiguous_first_argument
+#  - assigned_but_unused_variable
+#  - assignment_in_conditional
+#  - avoid_copy_paste
+#  - avoid_empty_rescue_block
+#  - avoid_global_variable
+#  - avoid_similar_code
+#  - avoid_singleton_variable
+#  - avoid_using_curly_braces_for_multi-line_blocks
+#  - check_return_value_of_save
+#  - don_t_use_parentheses_around_the_condition
+#  - extra_blank_line_detected
+#  - extra_blank_line_detected_at_body_beginning
+#  - extra_blank_line_detected_at_body_end
+#  - favor_if_unless_for_single_line
+#  - improve_coverage_of_class
+#  - improve_coverage_of_method
+#  - improve_coverage_of_project
+#  - indent_when_as_deep_as_case
+  - missing_class_documentation
+  - missing_method_documentation
+#  - naming_convention_for_class
+#  - naming_convention_for_method
+#  - naming_convention_for_module
+#  - no_for_loop
+#  - no_instance_variable_in_partial
+#  - no_params_in_view
+#  - no_session_in_view
+#  - omit_parentheses_when_no_args
+#  - prefer_accolades_over_doend_for_single-line_blocks
+#  - prefer_map_over_collect
+#  - prefer_reduce_over_inject
+#  - prefer_ruby_19_new_hash_syntax
+#  - prefer_ruby_19_new_lambda_syntax
+#  - prefer_single_quoted_strings
+  - reduce_number_of_params
+#  - refactor_complex_class
+#  - refactor_complex_method
+#  - remove_trailing_whitespace
+#  - restrict_auto_generated_routes
+#  - shadowing_outer_local_variable
+#  - simplify_call_to_render
+#  - simplify_call_to_render_partial
+#  - space_between_curly_brace_and_pipe_missing
+#  - space_inside_closing_curly_brace_missing
+#  - space_inside_opening_curly_brace_missing
+#  - space_inside_parentheses_detected
+#  - space_inside_square_brackets_detected
+#  - space_missing_after_colon
+#  - space_missing_after_comma
+#  - space_missing_after_hash_sign
+#  - space_missing_after_semicolon
+#  - space_missing_inside_closing_curly_brace
+#  - space_missing_inside_opening_curly_brace
+#  - space_missing_to_left_of_parentheses
+#  - star_interpreted_as_argument_prefix
+#  - surrounding_space_missing_for_accolade
+#  - surrounding_space_missing_for_addition
+#  - surrounding_space_missing_for_arrow
+#  - surrounding_space_missing_for_assign
+#  - surrounding_space_missing_for_divide
+#  - surrounding_space_missing_for_equality
+#  - surrounding_space_missing_for_greater_than
+#  - surrounding_space_missing_for_incr
+#  - surrounding_space_missing_for_minus
+#  - surrounding_space_missing_for_multiplication
+#  - surrounding_space_missing_for_not_equal
+#  - surrounding_space_missing_for_t_square
+#  - use_a_logger
+#  - use_def_with_parentheses_when_there_are_arguments
+#  - uses_spaces_instead_of_tabs

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,24 @@
+# Reference here: https://github.com/bbatsov/rubocop/blob/master/config/enabled.yml
+
+Metrics/LineLength:
+  Description: 'Limit lines to 165 characters.'
+  Enabled: true
+  Max: 165
+
+Metrics/MethodLength:
+  Description: 'Try to avoid methods longer than 50 lines of code.'
+  Enabled: true
+  Max: 50
+
+Metrics/ClassLength:
+  Description: 'Try to avoid methods longer than 50 lines of code.'
+  Enabled: true
+  Max: 150
+
+Style/Documentation:
+  Description: 'Document classes and non-namespace modules.'
+  Enabled: false
+
+AllCops:
+  Excludes:
+    - 'bin/**'

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 2.1.6
+  - 2.2.3
+script: bundle exec rspec spec

data/.versions.conf

@@ -0,0 +1,2 @@
+ruby=2.2.3
+ruby-gemset=netsoul

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in netsoul.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Christian Kakesa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,86 @@
+# Netsoul-Ruby (formerly libnetsoul-rb) [![Gem Version](https://badge.fury.io/rb/netsoul-ruby.svg)](http://badge.fury.io/rb/netsoul-ruby) [![Build Status](https://travis-ci.org/fenicks/netsoul-ruby.svg?branch=master)](https://travis-ci.org/fenicks/netsoul-ruby) [![Coverage Status](https://coveralls.io/repos/fenicks/netsoul-ruby/badge.svg?branch=master&service=github)](https://coveralls.io/github/fenicks/netsoul-ruby?branch=master)
+
+This gem is a simple and efficient Netsoul client implementation written in Ruby.
+You can use it as a Ruby gem in order to implement your own Netsoul client in Ruby or just use the provided Netsoul client.
+
+*__[History]__: 8 years after writing my first ruby lines of code, I decide to rewrite this old own with all my Ruby backgrounds.*
+
+## Features
+
+* __MD5__ authentication
+* __Kerberos__ (my own Ruby native extension) authentication. Something is wrong with kerberos server or gssapi __[work in progress]__
+* Data transfert is supported **only for the library part, not the provided client**, use it at your own. _My academic account was closed when I tryed files transfert at school_.
+* Identification Netsoul client is provided
+* Netsoul message library: all netsoul DSL is covered by the 'netsoul/message' module
+
+## Installation
+
+### On your desktop
+
+    ```bash
+    gem install netsoul
+    ```
+
+### In your project
+
+    ```ruby
+    # Gemfile
+    gem 'netsoul', '~> 0.1'
+    ```
+
+    ```ruby
+    # project.rb
+    require 'netsoul'
+    ```
+
+## Use the client
+
+After installing the gem **netsoul**, call the client as described bellow.
+
+    ```bash
+    netsoul-ruby -config netsoul-config.yml
+    ```
+
+### Example of _netsoul-config.yml_ file
+
+#### Standard (MD5) authentication
+
+    ```yaml
+    ---|
+    :login: 'kakesa_c'
+    :socks_password: 'my socks password'
+    # :unix_password: 'unix password needed for kerberos authentication' # :auth_method must be set to :krb5
+    # :auth_method: :std # :std, :krb5
+    # :server_host: 'ns-server.epita.fr'
+    # :server_port: 4242
+    # :state: :none # :actif, :away, :connection, :idle, :lock, :server, :none
+    # :location: 'Home'
+    # :user_group: 'ETNA_2008'
+    ```
+
+#### Kerberos authentication
+
+    ```yaml
+    ---|
+    :login: 'kakesa_c'
+    :unix_password: 'unix password'
+    :auth_method: :krb5 # :std, :krb5
+    # :socks_password: 'my socks password'
+    # :server_host: 'ns-server.epita.fr'
+    # :server_port: 4242
+    # :state: :none # :actif, :away, :connection, :idle, :lock, :server, :none
+    # :location: 'Home'
+    # :user_group: 'ETNA_2008'
+    ```
+
+## Use the library in custom Netsoul Ruby client
+
+__[TODO]__
+
+## Contributing
+
+1. Fork it ( https://github.com/fenicks/netsoul-ruby/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,18 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'yard'
+
+RSpec::Core::RakeTask.new('spec')
+
+task default: :spec
+
+require 'rake/extensiontask'
+Rake::ExtensionTask.new 'netsoul_kerberos' do |ext|
+  ext.lib_dir = 'lib'
+end
+
+desc 'Generate documentation'
+YARD::Rake::YardocTask.new do |t|
+  t.files = %w(lib/**/*.rb - LICENSE.txt)
+  t.options = %w(--main README.md --no-private --protected)
+end

data/bin/netsoul-ruby

@@ -0,0 +1,122 @@
+#!/usr/bin/env ruby
+# -*- encoding: binary -*-
+lib = File.expand_path('../../lib', __FILE__)
+$LOAD_PATH.unshift lib unless $LOAD_PATH.include?(lib)
+
+require 'base64'
+require 'digest/md5'
+require 'netsoul'
+require 'socket'
+require 'uri'
+
+module Netsoul
+  class Client
+    include Logging
+
+    attr_reader :started
+
+    def initialize(*args)
+      opts = args.last.is_a?(Hash) ? args.last : {}
+      @config = Config.new(opts)
+      @started = false
+    end
+
+    def auth_ag
+      sock_send(Message.auth_ag)
+      fail Netsoul::IdentificationError, 'Identification failed.'.freeze unless sock_get.split(' ')[1] == '002'.freeze
+    end
+    private :auth_ag
+
+    def auth_method
+      if @config.auth_method == :krb5
+        sock_send(Message.kerberos_auth(@config))
+      else
+        sock_send(Message.standard_auth(@config))
+      end
+      fail Netsoul::AuthenticationError, 'Authentication failed.'.freeze unless sock_get.split(' ')[1] == '002'
+    end
+    private :auth_method
+
+    def auth_status
+      sock_send(Message.attach)
+      sock_send(Message.user_state(@config.state, Time.now.to_i))
+    end
+    private :auth_status
+
+    def connect
+      @sock = TCPSocket.new(@config.server_host, @config.server_port)
+      fail Netsoul::SocketError, 'Could not open a socket. Connection is unavailable.'.freeze unless @sock
+
+      _cmd, _socket_num, md5_hash, client_ip, client_port, _server_timestamp = sock_get.split
+      @config.build_user_connection_info md5_hash: md5_hash, client_ip: client_ip, client_port: client_port
+
+      auth_ag
+      auth_method
+      auth_status
+      @started = true
+    end
+
+    def disconnect
+      sock_send(Message.ns_exit)
+    ensure
+      sock_close
+    end
+
+    def sock_send(str)
+      log :info, "[send] #{str.chomp}"
+      @sock.puts str
+    end
+
+    def sock_get
+      res = @sock.gets
+      log :info, "[get ] #{res.chomp}"
+      res
+    end
+
+    def sock_close
+      @started = false
+      @sock.close
+    rescue
+      nil
+    end
+  end
+end
+
+if __FILE__ == $PROGRAM_NAME
+  $stderr.sync = true
+  require 'optparse'
+  require 'yaml'
+
+  options = {}
+  OptionParser.new do |opts|
+    opts.banner = 'Usage: netsoul-ruby [options]'.freeze
+    opts.separator "\nNetsoul-Ruby options:".freeze
+    opts.on('-c'.freeze, '--config FILE'.freeze, 'Configuration file in YAML'.freeze) do |file|
+      options[:config] = file
+      unless File.file?(options[:config])
+        puts '[ERROR] Configuration is not a valid file'
+        exit
+      end
+      options[:user_opts] = YAML.load_file(options[:config])
+    end
+    opts.on('-h', '--help', 'Display this screen') do
+      puts opts
+      exit
+    end
+  end.parse!
+
+  unless options.include?(:config)
+    puts '[ERROR] Configuration file is not provided'
+    exit
+  end
+
+  c = Netsoul::Client.new options[:user_opts]
+  c.connect
+  if c.started
+    loop do
+      res = c.sock_get
+      c.sock_send res if res.to_s.match(/^ping.*/)
+      sleep 1
+    end
+  end
+end

data/ext/netsoul_kerberos/extconf.rb

@@ -0,0 +1,10 @@
+require 'mkmf'
+
+have_library('krb5', 'krb5_init_context')
+have_library('gssapi_krb5', 'gss_init_sec_context')
+have_header('string.h')
+have_header('krb5.h')
+have_header('gssapi/gssapi.h')
+have_header('gssapi/gssapi_krb5.h')
+
+create_makefile('netsoul_kerberos')

data/ext/netsoul_kerberos/kerberos.c

@@ -0,0 +1,206 @@
+/*
+** This file is part of RubySoul project.
+**
+** Test for the kerberos authentication.
+**
+** @author Christian KAKESA <christian.kakesa@gmail.com>
+*/
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <krb5.h>
+#include <gssapi/gssapi.h>
+#include <gssapi/gssapi_krb5.h>
+
+#include "kerberos.h"
+
+void	display_status(k_data_t *data)
+{
+	OM_uint32	minor, status;
+	gss_buffer_desc	msg;
+
+	gss_display_status(&minor, data->min, GSS_C_GSS_CODE, GSS_C_NO_OID, &status, &msg);
+	if (msg.value) puts(msg.value);
+}
+
+krb5_error_code	get_new_tickets(	k_data_t *data,
+					krb5_context context,
+					krb5_principal principal,
+					krb5_ccache ccache)
+{
+   krb5_error_code		ret;
+   krb5_get_init_creds_opt	opt;
+   krb5_creds			cred;
+//   char *			password = NULL;
+
+   memset(&cred, 0, sizeof(cred));
+   krb5_get_init_creds_opt_init (&opt);
+   ret = krb5_get_init_creds_password(context,
+                                      &cred,
+                                      principal,
+                                      data->unix_pass,
+                                      krb5_prompter_posix,
+                                      NULL,
+                                      0,
+                                      NULL,
+                                      &opt);
+   if (ret == KRB5_LIBOS_PWDINTR ||
+       ret == KRB5KRB_AP_ERR_MODIFIED ||
+       ret == KRB5KRB_AP_ERR_MODIFIED)
+      return (1);
+   else if (ret)
+      return (2);
+   if (krb5_cc_initialize(context, ccache, cred.client))
+      return (3);
+   if (krb5_cc_store_cred(context, ccache, &cred))
+      return (3);
+   //krb5_free_creds_contents(context, &cred);
+   return (0);
+}
+
+int	my_init(k_data_t *data)
+{
+   krb5_error_code               ret;
+   krb5_context                  context;
+   krb5_ccache                   ccache;
+   krb5_principal                principal;
+
+   if (krb5_init_context(&context))
+      return (1);
+
+   if (!data->login ||
+       krb5_build_principal(context, &principal, sizeof(NS_REALM) - 1, NS_REALM, data->login, NULL))
+      return (1);
+   if (krb5_cc_default(context, &ccache))
+      return (1);
+
+   ret = get_new_tickets(data, context, principal, ccache);
+   krb5_cc_close(context, ccache);
+   krb5_free_principal(context, principal);
+   krb5_free_context(context);
+   return (ret);
+}
+
+void	import_name(k_data_t *data)
+{
+	OM_uint32		min;
+	OM_uint32		maj;
+	gss_buffer_desc		buf;
+
+	buf.value = (unsigned char *) strdup(NS_SERVICE_NAME);
+	buf.length = strlen((const char*)buf.value) + 1;
+	maj = gss_import_name(&min, &buf, GSS_C_NT_HOSTBASED_SERVICE, &data->gss_name);
+
+	if (maj != GSS_S_COMPLETE)
+	      display_status(data);
+}
+
+void	init_context(k_data_t *data)
+{
+	OM_uint32	maj;
+	/* gss_buffer_t	itoken      = GSS_C_NO_BUFFER; */
+	krb5_enctype	etypes[]    = { ENCTYPE_DES3_CBC_SHA1, ENCTYPE_NULL };
+	int		etype_count = sizeof(etypes) / sizeof(*etypes);
+	gss_cred_id_t	credh;
+
+	maj = gss_acquire_cred(	&data->min,
+				GSS_C_NO_NAME,
+				GSS_C_INDEFINITE,
+				GSS_C_NO_OID_SET,
+				GSS_C_INITIATE,
+				&credh,
+				NULL,
+				NULL);
+	if (maj != GSS_S_COMPLETE)
+	{
+		display_status(data);
+		return;
+	}
+	maj = gss_krb5_set_allowable_enctypes(&data->min, credh, etype_count, etypes);
+	if (maj != GSS_S_COMPLETE)
+	{
+		display_status(data);
+		return;
+	}
+	data->ctx = GSS_C_NO_CONTEXT;
+	maj = gss_init_sec_context(	&data->min,
+					credh,
+					&data->ctx,
+					data->gss_name,
+					GSS_C_NO_OID,
+					GSS_C_CONF_FLAG,
+					0,
+					GSS_C_NO_CHANNEL_BINDINGS,
+					data->itoken,
+					NULL,
+					&data->otoken,
+					NULL,
+					NULL);
+
+	if (data->maj != GSS_S_COMPLETE)
+		display_status(data);
+}
+
+int	check_tokens(k_data_t *data)
+{
+   import_name(data);
+   init_context(data);
+
+   if (!data->otoken.value)
+   {
+      my_init(data);
+      import_name(data);
+      init_context(data);
+   }
+   if (data->otoken.value)
+      return (1);
+
+   return (0);
+}
+
+/**
+ * Encode string in base64
+ */
+unsigned char * base64_encode(const unsigned char *src, size_t len, size_t *out_len)
+{
+	unsigned char *out, *pos;
+	const unsigned char *end, *in;
+	size_t olen;
+	int line_len;
+	const unsigned char base64_table[65] = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+
+	olen = len * 4 / 3 + 4; /* 3-byte blocks to 4-byte */
+	out = malloc(olen);
+	if (out == NULL)
+		return NULL;
+
+	end = src + len;
+	in = src;
+	pos = out;
+	while (end - in >= 3) {
+		*pos++ = base64_table[in[0] >> 2];
+		*pos++ = base64_table[((in[0] & 0x03) << 4) | (in[1] >> 4)];
+		*pos++ = base64_table[((in[1] & 0x0f) << 2) | (in[2] >> 6)];
+		*pos++ = base64_table[in[2] & 0x3f];
+		in += 3;
+	}
+
+	if (end - in) {
+		*pos++ = base64_table[in[0] >> 2];
+		if (end - in == 1) {
+			*pos++ = base64_table[(in[0] & 0x03) << 4];
+			*pos++ = '=';
+		} else {
+			*pos++ = base64_table[((in[0] & 0x03) << 4) |
+					      (in[1] >> 4)];
+			*pos++ = base64_table[(in[1] & 0x0f) << 2];
+		}
+		*pos++ = '=';
+		line_len += 4;
+	}
+
+	if (out_len)
+		*out_len = pos - out;
+	return out;
+}

data/ext/netsoul_kerberos/kerberos.h

@@ -0,0 +1,58 @@
+/*
+** This file is part of RubySoul project.
+**
+** Test for the kerberos authentication.
+**
+** @author Christian KAKESA <christian.kakesa@gmail.com>
+*/
+
+#ifndef __KERBEROS_H_
+#define __KERBEROS_H_
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <krb5.h>
+#include <gssapi/gssapi.h>
+#include <gssapi/gssapi_krb5.h>
+
+#define NS_SERVICE_NAME	"host@ns-server.epitech.net"
+#define NS_REALM	"EPITECH.NET"
+
+typedef struct k_data
+{
+	char*		login;
+	char*		unix_pass;
+	OM_uint32	min;
+	OM_uint32	maj;
+	gss_name_t	gss_name;
+	gss_ctx_id_t	ctx;
+	gss_buffer_t	itoken;
+	gss_buffer_desc	otoken;
+}	k_data_t;
+
+void
+display_status(k_data_t *data);
+
+krb5_error_code
+get_new_tickets(	k_data_t *data,
+			krb5_context context,
+			krb5_principal principal,
+			krb5_ccache ccache);
+
+int
+my_init(k_data_t *data);
+
+void
+import_name(k_data_t *data);
+
+void
+init_context(k_data_t *data);
+
+int
+check_tokens(k_data_t *data);
+
+unsigned char *
+base64_encode(const unsigned char *src, size_t len, size_t *out_len);
+
+#endif /* !__KERBEROS_H_ */

data/ext/netsoul_kerberos/netsoul_kerberos.c

@@ -0,0 +1,55 @@
+/*
+** This file is part of RubySoul project.
+**
+** Test for the kerberos authentication.
+**
+** @author Christian KAKESA <christian.kakesa@gmail.com>
+*/
+
+#include <ruby.h>
+
+#include "kerberos.h"
+
+VALUE cNetsoulKerberos;
+
+static VALUE k_init(VALUE self)
+{
+	rb_define_attr(cNetsoulKerberos, "login", 1, 1);
+	rb_define_attr(cNetsoulKerberos, "password", 1, 1);
+	rb_define_attr(cNetsoulKerberos, "token", 1, 0);
+	rb_define_attr(cNetsoulKerberos, "token_base64", 1, 0);
+	return self;
+}
+
+static VALUE k_build_token(VALUE self, VALUE login, VALUE password)
+{
+	k_data_t	*data;
+	unsigned char	*token_base64;
+	unsigned char	*token;
+	size_t		elen;
+
+	data = calloc(1, sizeof (k_data_t));
+	data->login = (char*)login;
+	data->unix_pass = (char*)password;
+	data->itoken = GSS_C_NO_BUFFER;
+	if (check_tokens(data) != 1)
+		return Qfalse;
+
+	token = (unsigned char*)strdup(data->otoken.value);
+	token_base64 = base64_encode((const unsigned char*)data->otoken.value, data->otoken.length, &elen);
+	rb_iv_set(self, "@login", login);
+	rb_iv_set(self, "@password", password);
+	rb_iv_set(self, "@token", rb_str_new2((const char*)token));
+	rb_iv_set(self, "@token_base64", rb_str_new2((const char*)token_base64));
+	free(token);
+	free(token_base64);
+	free(data);
+	return Qtrue;
+}
+
+void Init_netsoul_kerberos()
+{
+	cNetsoulKerberos = rb_define_class("NetsoulKerberos", rb_cObject);
+	rb_define_method(cNetsoulKerberos, "initialize", k_init, 0);
+	rb_define_method(cNetsoulKerberos, "build_token", k_build_token, 2);
+}

data/lib/netsoul/config.rb

@@ -0,0 +1,41 @@
+module Netsoul
+  class Config
+    AUTH_METHODS = [:std, :krb5].freeze
+    USER_STATES = [:actif, :away, :connection, :idle, :lock, :server, :none].freeze
+    VALID_USER_CONNECTION_INFO = [:md5_hash, :client_ip, :client_port].freeze
+
+    attr_accessor :server_host,
+                  :server_port,
+                  :login,
+                  :socks_password,
+                  :unix_password,
+                  :auth_method,
+                  :state,
+                  :location,
+                  :user_group,
+                  :user_connection_info # Not used in configuration file
+
+    attr_reader :client_name
+
+    # rubocop:disable Metrics/AbcSize
+    def initialize(opts = {})
+      @server_host = opts.fetch(:server_host, 'ns-server.epita.fr'.freeze)
+      @server_port = Integer(opts.fetch(:server_port, 4242))
+      @login = opts.fetch(:login, 'ionis'.freeze)
+      @socks_password = opts.fetch(:socks_password, 'socks_password'.freeze)
+      @unix_password = opts.fetch(:unix_password, 'unix_password'.freeze)
+      @auth_method = AUTH_METHODS.include?(opts[:auth_method]) ? opts[:auth_method] : :std
+      @state = USER_STATES.include?(opts[:state]) ? opts[:state] : :none
+      @location = opts.fetch(:location, 'Home'.freeze)
+      @user_group = opts.fetch(:user_group, 'ETNA_2008'.freeze)
+      @user_connection_info = {}
+
+      @client_name = opts.fetch(:client_name, '(Netsoul-Ruby) -> { Christian Kakesa, since 2009}'.freeze)
+    end
+
+    def build_user_connection_info(opts = {})
+      return unless opts.is_a?(Hash)
+      opts.each { |k, v| @user_connection_info[k] = v if VALID_USER_CONNECTION_INFO.include?(k) }
+    end
+  end
+end

data/lib/netsoul/errors.rb

@@ -0,0 +1,6 @@
+module Netsoul
+  class AuthenticationError < StandardError; end
+  class Error < StandardError; end
+  class IdentificationError < StandardError; end
+  class SocketError < StandardError; end
+end

data/lib/netsoul/location.rb

@@ -0,0 +1,55 @@
+module Netsoul
+  class Location
+    class << self
+      def get(ip)
+        locations.each do |key, val|
+          res = ip.match(/^#{val}/)
+          if res
+            res = "#{key}"
+            return res
+          end
+        end
+        'ext'.freeze
+      end
+
+      # rubocop:disable Metrics/AbcSize
+      def locations
+        {
+          'lab-cisco-mid-sr': '10.251.'.freeze,
+          etna: '10.245.'.freeze,
+          lse: '10.227.42.'.freeze,
+          'sda-1': '10.227.4.'.freeze,
+          lab: '10.227.'.freeze,
+          'lab-tcom': '10.226.7.'.freeze,
+          'lab-acu': '10.226.6.'.freeze,
+          'lab-console': '10.226.5.'.freeze,
+          'lab-mspe': '10.226.'.freeze,
+          epitanim: '10.225.19.'.freeze,
+          epidemic: '10.225.18.'.freeze,
+          'sda-2': '10.225.10.'.freeze,
+          cycom: '10.225.8.'.freeze,
+          epx: '10.225.7.'.freeze,
+          prologin: '10.225.6.'.freeze,
+          nomad: '10.225.2.'.freeze,
+          assos: '10.225.'.freeze,
+          sda: '10.224.14.'.freeze,
+          www: '10.223.106.'.freeze,
+          episport: '10.223.104.'.freeze,
+          epicom: '10.223.103.'.freeze,
+          'bde-epita': '10.223.100.'.freeze,
+          omatis: '10.223.42.'.freeze,
+          ipsa: '10.223.15.'.freeze,
+          lrde: '10.223.13.'.freeze,
+          cvi: '10.223.7.'.freeze,
+          epi: '10.223.1.'.freeze,
+          pasteur: '10.223.'.freeze,
+          bocal: '10.42.42.'.freeze,
+          sm: '10.42.'.freeze,
+          vpn: '10.10.'.freeze,
+          adm: '10.1.'.freeze,
+          epita: '10.'.freeze
+        }
+      end
+    end
+  end
+end

data/lib/netsoul/logging.rb

@@ -0,0 +1,26 @@
+require 'logger'
+
+module Netsoul
+  module Logging # :nodoc:
+    PREFIX = '[Netsoul-Ruby]'.freeze
+
+    class << self
+      attr_writer :logger
+    end
+
+    def self.logger
+      @logger ||= ::Logger.new(STDERR).tap do |logger|
+        logger.level = Logger::INFO
+        logger.formatter = proc do |severity, datetime, _progname, msg|
+          "#{severity} [#{datetime.strftime('%Y-%m-%d %H:%M:%S.%L'.freeze)}] #{msg}\n"
+        end
+      end
+    end
+
+    private
+
+    def log(level, message)
+      Netsoul::Logging.logger.send(level.to_sym, "#{PREFIX} #{message}") if Netsoul::Logging.logger
+    end
+  end
+end

data/lib/netsoul/message.rb

@@ -0,0 +1,143 @@
+module Netsoul
+  class Message
+    class << self
+      def _standard_auth_string(c)
+        str = "#{c.user_connection_info[:md5_hash]}"
+        str << "-#{c.user_connection_info[:client_ip]}"
+        str << "/#{c.user_connection_info[:client_port]}#{c.socks_password}"
+        Digest::MD5.hexdigest(str)
+      end
+
+      def standard_auth(config)
+        login = config.login
+        client_ip = config.user_connection_info[:client_ip]
+        user_custom_location = config.location
+        location = Message.escape(Location.get(client_ip) == 'ext'.freeze ? user_custom_location : Location.get(client_ip))
+        client_name = Message.escape(config.client_name)
+        "ext_user_log #{login} #{_standard_auth_string(config)} #{client_name} #{location}"
+      end
+
+      def _kerberos_get
+        require 'netsoul_kerberos'
+        @netsoul_kerberos ||= NetsoulKerberos.new
+      rescue LoadError => e
+        raise Netsoul::Error, "NetsoulKerberos library not found: #{e}.".freeze
+      end
+
+      def _kerberos_auth_klog(config)
+        location = Message.escape(config.location)
+        user_group = Message.escape(config.user_group)
+        client_name = Message.escape(config.client_name)
+        "ext_user_klog #{_kerberos_get.token_base64.slice(0, 812)} #{Message.escape(RUBY_PLATFORM)} #{location} #{user_group} #{client_name}"
+      end
+
+      def kerberos_auth(config)
+        unless _kerberos_get.build_token(config.login, config.unix_password)
+          fail Netsoul::Error, 'Impossible to retrieve the kerberos token.'.freeze
+        end
+        _kerberos_auth_klog(config)
+      end
+
+      def auth_ag
+        'auth_ag ext_user none -'.freeze
+      end
+
+      def send_message(user, msg)
+        "user_cmd msg_user #{user} msg #{Message.escape(msg.to_s)}"
+      end
+
+      def start_writing_to_user(user)
+        "user_cmd msg_user #{user} dotnetSoul_UserTyping null"
+      end
+
+      def stop_writing_to_user(user)
+        "user_cmd msg_user #{user} dotnetSoul_UserCancelledTyping null"
+      end
+
+      def list_users(user_list)
+        "list_users {#{user_list}}"
+      end
+
+      def who_users(user_list)
+        "user_cmd who {#{user_list}}"
+      end
+
+      def watch_users(user_list)
+        "user_cmd watch_log_user {#{user_list}}"
+      end
+
+      def attach
+        'user_cmd attach'.freeze
+      end
+
+      def user_state(state, timestamp)
+        "user_cmd state #{state}:#{timestamp}"
+      end
+
+      def user_data(data)
+        "user_cmd user_data #{Message.escape(data.to_s)}"
+      end
+
+      def xfer(user, id, filename, size, desc)
+        "user_cmd msg_user #{user} desoul_ns_xfer #{Message.escape("#{id} #{filename} #{size} #{desc}")}"
+      end
+
+      def desoul_ns_xfer(user, id, filename, size, desc)
+        xfer(user, id, filename, size, desc)
+      end
+
+      def xfer_accept(user, id)
+        "user_cmd msg_user #{user} desoul_ns_xfer_accept #{id}"
+      end
+
+      def desoul_ns_xfer_accept(user, id)
+        xfer_accept(user, id)
+      end
+
+      def xfer_data(user, id, data)
+        "user_cmd msg_user #{user} desoul_ns_xfer_data #{Message.escape("#{id} #{Base64.b64encode(data.to_s, data.to_s.length)}")}"
+      end
+
+      def desoul_ns_xfer_data(user, id, data)
+        xfer_data(user, id, data)
+      end
+
+      def xfer_cancel(user, id)
+        "user_cmd msg_user #{user} desoul_ns_xfer_cancel #{id}"
+      end
+
+      def desoul_ns_xfer_cancel(user, id)
+        xfer_cancel(user, id)
+      end
+
+      def ping
+        'pong'.freeze
+      end
+
+      def ns_exit
+        'exit'.freeze
+      end
+
+      def escape(str)
+        str = URI.escape(str, Regexp.new("#{URI::PATTERN::ALNUM}[:graph:][:punct:][:cntrl:][:print:][:blank:]", false, 'N'.freeze))
+        URI.escape(str, Regexp.new("[^#{URI::PATTERN::ALNUM}]", false, 'N'.freeze))
+      end
+
+      def unescape(str)
+        URI.unescape str
+      end
+
+      def ltrim(str)
+        str.to_s.gsub(/^\s+/, ''.freeze)
+      end
+
+      def rtrim(str)
+        str.to_s.gsub(/\s+$/, ''.freeze)
+      end
+
+      def trim(str)
+        rtrim(ltrim(str.to_s))
+      end
+    end
+  end
+end

data/lib/netsoul/version.rb

@@ -0,0 +1,3 @@
+module Netsoul
+  VERSION = '0.1.0'.freeze
+end

data/lib/netsoul.rb

@@ -0,0 +1,6 @@
+require_relative 'netsoul/config'
+require_relative 'netsoul/errors'
+require_relative 'netsoul/location'
+require_relative 'netsoul/logging'
+require_relative 'netsoul/message'
+require_relative 'netsoul/version'

data/netsoul.gemspec

@@ -0,0 +1,39 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'netsoul/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'netsoul'
+  spec.version       = Netsoul::VERSION
+  spec.authors       = ['Christian Kakesa']
+  spec.email         = ['christian.kakesa@gmail.com']
+
+  spec.summary       = 'Netsoul client and library for ruby.'
+  spec.description   = spec.summary
+  spec.homepage      = 'https://github.com/fenicks/netsoul-ruby'
+  spec.license       = 'MIT'
+
+  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
+  # delete this section to allow pushing this gem to any host.
+  # if spec.respond_to?(:metadata)
+  #   spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  # else
+  #   fail 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
+  # end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'bin'
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = %w(lib ext bin)
+  spec.extensions    = ['ext/netsoul_kerberos/extconf.rb']
+
+  spec.add_development_dependency 'bundler', '~> 1.7', '>= 1.7.0'
+  spec.add_development_dependency 'rake', '~> 0'
+  spec.add_development_dependency 'rubocop', '~> 0'
+  spec.add_development_dependency 'rspec', '~> 3.3'
+  spec.add_development_dependency 'simplecov', '~> 0'
+  spec.add_development_dependency 'coveralls', '~> 0'
+  spec.add_development_dependency 'yard', '~> 0'
+  spec.add_development_dependency 'rake-compiler', '~> 0.9.5'
+end

metadata

@@ -0,0 +1,190 @@
+--- !ruby/object:Gem::Specification
+name: netsoul
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Christian Kakesa
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-01-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.5
+description: Netsoul client and library for ruby.
+email:
+- christian.kakesa@gmail.com
+executables:
+- netsoul-ruby
+extensions:
+- ext/netsoul_kerberos/extconf.rb
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".pullreview.yml"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- ".versions.conf"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/netsoul-ruby
+- ext/netsoul_kerberos/extconf.rb
+- ext/netsoul_kerberos/kerberos.c
+- ext/netsoul_kerberos/kerberos.h
+- ext/netsoul_kerberos/netsoul_kerberos.c
+- lib/netsoul.rb
+- lib/netsoul/config.rb
+- lib/netsoul/errors.rb
+- lib/netsoul/location.rb
+- lib/netsoul/logging.rb
+- lib/netsoul/message.rb
+- lib/netsoul/version.rb
+- netsoul.gemspec
+homepage: https://github.com/fenicks/netsoul-ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+- ext
+- bin
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Netsoul client and library for ruby.
+test_files: []
+has_rdoc: