moved from 'git.xdrm.io/schastsp' to 'git.xdrm.io/logauth/schastsp' + add readme

README.md

@@ -0,0 +1,86 @@
+# SCHA/STSP
+
+**Copyright (C) 2017 xdrm-brackets**
+
+
+
+[![Go version](https://img.shields.io/badge/go_version-1.10.3-blue.svg)](https://golang.org/doc/go1.10)
+
+[![Go Report Card](https://goreportcard.com/badge/git.xdrm.io/logauth/schastsp)](https://goreportcard.com/report/git.xdrm.io/logauth/schastsp)
+[![Go doc](https://godoc.org/git.xdrm.io/logauth/schastsp?status.svg)](https://godoc.org/git.xdrm.io/logauth/schastsp)
+
+
+## Overview
+
+----
+
+This software defines and uses its own protocol which bundles 2 technologies  :
+
+- Stateless Cyclic Hash Algorithm
+- Stateless Time Scrambling Protocol
+
+It is meant to be used over request/response stateless networking and has been designed with HTTP in mind. The protocol only covers the generation and management of a pair of *tokens* which are hexadecimal strings. These are sent inside each  request and a pair also has to be sent back to the sender. These tokens are mainly sent in the  HTTP `Authorization` header for HTTP requests and responses.
+
+
+
+**Features**
+
+Beyond security issues, this protocol has some additional features :
+
+- **Trust Chain** - Each exchange between the server and the client is bound to the previous one. Each request is unique and can only give information about previous ones, not future ones. This principle ensures the server that no-one can be faking the client (unless someone has access to its key).
+
+  > If an attacker can guess (*e.g. bruteforce*) a successful request and gain access to the server - if he hasn't the client's key - it is fairly impossible that he also guesses the next request.
+
+  > A resynchronization protocol is featured in this package in order for a client to regain ownership on the trust chain if lost (by network issue or by an attack). 
+
+- **Time-awareness** - A request is only valid a short amount of time after its generation. This amount is usually the maximum transmission time.
+
+  > Any MITM that catches the client's request to change its content only has a minimum time to forward it. As a result - if the amount is well chosen - any request modification is blocked by the time it takes. 
+
+- [TODO]
+
+
+
+
+
+**Security**
+
+The aim of this package is to provide a **secure** authentication system between a server and its clients. Secure is defined as follows :
+
+- No *man-in-the-middle* (MITM) can gather enough information to fake any client. Every data sent over the network is the result of one or more <u>one-way algorithms</u>.
+- Neither a protocol understanding nor the source code can help an attacker fake a client or find useful information among requests.
+- The server has no secret key other than the <u>synchronization key</u> (used once to bind the client). The server has no clue what each client's key is, in fact it knows as much as a *MITM*.
+
+
+
+
+
+## Requirements
+
+----
+
+You need a recent machine with `go` installed.
+
+> This package has not been tested under the version **1.10**.
+
+
+
+## Installation
+
+----
+
+Download the package with `go get` :
+
+```bash
+go get git.xdrm.io/logauth/schastsp
+```
+
+
+
+Build the executables :
+
+```bash
+go install git.xdrm.io/logauth/schastsp/cmd/client;
+go install git.xdrm.io/logauth/schastsp/cmd/server;
+```
+

client/client.go

@@ -3,9 +3,9 @@ package client
 import (
 	"errors"
 	"fmt"
-	"git.xdrm.io/schastsp/internal/keyset"
+	"git.xdrm.io/logauth/schastsp/internal/keyset"
-	"git.xdrm.io/schastsp/context"
+	"git.xdrm.io/logauth/schastsp/context"
-	"git.xdrm.io/schastsp/internal/scha"
+	"git.xdrm.io/logauth/schastsp/internal/scha"
 	"io"
 )
 

client/client.internal.go

@@ -3,10 +3,10 @@ package client
 import (
 	"encoding/binary"
 	"fmt"
-	"git.xdrm.io/schastsp/internal/keyset"
+	"git.xdrm.io/logauth/schastsp/internal/keyset"
-	"git.xdrm.io/schastsp/internal/scha"
+	"git.xdrm.io/logauth/schastsp/internal/scha"
-	"git.xdrm.io/schastsp/internal/timeid"
+	"git.xdrm.io/logauth/schastsp/internal/timeid"
-	"git.xdrm.io/schastsp/internal/xor"
+	"git.xdrm.io/logauth/schastsp/internal/xor"
 )
 
 /* (1) Updates 'key' and 'sync' with files

client/config.go

@@ -1,7 +1,7 @@
 package client;
 
 import (
-	"git.xdrm.io/schastsp/internal/keyset"
+	"git.xdrm.io/logauth/schastsp/internal/keyset"
 	"fmt"
 	"path/filepath"
 	"errors"

cmd/client/client.go

@@ -5,8 +5,8 @@ import (
 	"os"
 	"flag"
 	"fmt"
-	"git.xdrm.io/schastsp/context"
+	"git.xdrm.io/logauth/schastsp/context"
-	"git.xdrm.io/schastsp/client"
+	"git.xdrm.io/logauth/schastsp/client"
 )
 
 func main(){

cmd/server/server.go

@@ -1,13 +1,13 @@
 package main
 
 import (
-	"git.xdrm.io/schastsp/internal/scha"
+	"git.xdrm.io/logauth/schastsp/internal/scha"
 	"time"
 	"os"
 	"flag"
 	"fmt"
-	"git.xdrm.io/schastsp/context"
+	"git.xdrm.io/logauth/schastsp/context"
-	"git.xdrm.io/schastsp/server"
+	"git.xdrm.io/logauth/schastsp/server"
 )
 
 func main(){

cmd/simple/simple.go

@@ -6,9 +6,9 @@ import (
 	"os"
 	"flag"
 	"fmt"
-	"git.xdrm.io/schastsp/context"
+	"git.xdrm.io/logauth/schastsp/context"
-	"git.xdrm.io/schastsp/client"
+	"git.xdrm.io/logauth/schastsp/client"
-	"git.xdrm.io/schastsp/server"
+	"git.xdrm.io/logauth/schastsp/server"
 )
 
 /* Store target config paths */

internal/keyset/keyset.go

@@ -3,8 +3,8 @@ package keyset
 import (
 	"encoding/binary"
 	"errors"
-	"git.xdrm.io/schastsp/context"
+	"git.xdrm.io/logauth/schastsp/context"
-	"git.xdrm.io/schastsp/internal/scha"
+	"git.xdrm.io/logauth/schastsp/internal/scha"
 	"io"
 )
 

internal/keyset/keyset_test.go

@@ -2,8 +2,8 @@ package keyset
 
 import (
 	"bytes"
-	"git.xdrm.io/schastsp/context"
+	"git.xdrm.io/logauth/schastsp/context"
-	"git.xdrm.io/schastsp/internal/scha"
+	"git.xdrm.io/logauth/schastsp/internal/scha"
 	"testing"
 )
 

internal/scha/hash.go

@@ -3,7 +3,7 @@ package scha
 import (
 	"errors"
 	"crypto/sha512"
-	"git.xdrm.io/schastsp/internal/xor"
+	"git.xdrm.io/logauth/schastsp/internal/xor"
 )
 
 /* (0) Static

server/server.go

@@ -2,12 +2,12 @@ package server
 
 import (
 	"fmt"
-	"git.xdrm.io/schastsp/internal/scha"
+	"git.xdrm.io/logauth/schastsp/internal/scha"
 	"io"
 	"os"
 	"path/filepath"
 	"errors"
-	"git.xdrm.io/schastsp/context"
+	"git.xdrm.io/logauth/schastsp/context"
 )
 
 const DEBUG = false

server/server.internal.go

@@ -4,9 +4,9 @@ import (
 	"encoding/binary"
 	"errors"
 	"fmt"
-	"git.xdrm.io/schastsp/internal/scha"
+	"git.xdrm.io/logauth/schastsp/internal/scha"
-	"git.xdrm.io/schastsp/internal/timeid"
+	"git.xdrm.io/logauth/schastsp/internal/timeid"
-	"git.xdrm.io/schastsp/internal/xor"
+	"git.xdrm.io/logauth/schastsp/internal/xor"
 	"os"
 )