From f3c5ec2f5192fa077c4da0d1c67aa48a742c6d37 Mon Sep 17 00:00:00 2001
From: paulr <me@pjr.cc>
Date: Mon, 15 Nov 2010 09:07:48 +1100
Subject: [PATCH] initial commit

---
 .project          |   11 +++++++++++
 doco/readme.txt   |   44 ++++++++++++++++++++++++++++++++++++++++++++
 example/index.php |    3 +++
 lib/lib.php       |    4 ++++
 4 files changed, 62 insertions(+), 0 deletions(-)
 create mode 100644 .project
 create mode 100644 doco/readme.txt
 create mode 100644 example/index.php
 create mode 100644 lib/lib.php

diff --git a/.project b/.project
new file mode 100644
index 0000000..10dd441
--- /dev/null
+++ b/.project
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>ga4php</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+	</buildSpec>
+	<natures>
+	</natures>
+</projectDescription>
diff --git a/doco/readme.txt b/doco/readme.txt
new file mode 100644
index 0000000..d26656d
--- /dev/null
+++ b/doco/readme.txt
@@ -0,0 +1,44 @@
+The GA4PHP Project
+==================
+
+GA4PHP means Google Authenticator for PHP.
+
+The purpose of this "library" is to provde a convienient and
+hopefully simple way of provisioning and authenticating users
+using the Google Authenticator mechanism
+
+
+Why?
+====
+
+Mostly cause I can. Recently i've been heavily interesting in
+what is "out there" for FOSS based authentication projects and
+the Google Authenticator is based on OATH - HOTP/TOTP. It also
+has a few kewl features, like providing its secret key via QR
+codes. But looking at the App's available for smartphones
+(android, iphone, etc), the google auth app was the only one
+that fullfilled some realistic criteria - easy to use, easy to
+provision.
+
+
+How?
+====
+
+Ultimately, this is just a library with a web based example,
+the purpose of which is to integrate into your exisint applications,
+those that are PHP.
+
+
+Complications
+=============
+
+The only real complication i've had so far is that alot of the
+HOTP based keys out there provide the secret key as HEX where
+google choose to use base32, of which there exist no single
+or simple implementation. So I wrote my (rather terrible so far)
+own as all i really want to do is convert from base32 back to
+hex, this I do by converting to binary first... Lets how thats
+going to work in the long run. The sad thing is is that if I
+were writing it in C/C++/etc, bit math is easy and while im sure
+its not too different in PHP, I've never done it, so this seeemed
+easier.   
\ No newline at end of file
diff --git a/example/index.php b/example/index.php
new file mode 100644
index 0000000..15c5adc
--- /dev/null
+++ b/example/index.php
@@ -0,0 +1,3 @@
+<?php
+
+?>
\ No newline at end of file
diff --git a/lib/lib.php b/lib/lib.php
new file mode 100644
index 0000000..dc10d56
--- /dev/null
+++ b/lib/lib.php
@@ -0,0 +1,4 @@
+<?php
+
+
+?>
\ No newline at end of file
-- 
1.7.0.4