4c0e3c5d2f
* Initialized basic outline of TOTP backend using Postgresql backend as template * Updated TOTP backend.go's structure and help string * Updated TOTP path_roles.go's structure and help strings * Updated TOTP path_role_create.go's structure and help strings * Fixed typo in path_roles.go * Fixed errors in path_role_create.go and path_roles.go * Added TOTP secret backend information to cli commands * Fixed build errors in path_roles.go and path_role_create.go * Changed field values of period and digits from uint to int, added uint conversion of period when generating passwords * Initialized TOTP test file based on structure of postgresql test file * Added enforcement of input values * Added otp library to vendor folder * Added test steps and cleaned up errors * Modified read credential test step, not working yet * Use of vendored package not allowed - Test error * Removed vendor files for TOTP library * Revert "Removed vendor files for TOTP library" This reverts commit fcd030994bc1741dbf490f3995944e091b11da61. * Hopefully fixed vendor folder issue with TOTP Library * Added additional tests for TOTP backend * Cleaned up comments in TOTP backend_test.go * Added default values of period, algorithm and digits to field schema * Changed account_name and issuer fields to optional * Removed MD5 as a hash algorithm option * Implemented requested pull request changes * Added ability to validate TOTP codes * Added ability to have a key generated * Added skew, qr size and key size parameters * Reset vendor.json prior to merge * Readded otp and barcode libraries to vendor.json * Modified help strings for path_role_create.go * Fixed test issue in testAccStepReadRole * Cleaned up error formatting, variable names and path names. Also added some additional documentation * Moveed barcode and url output to key creation function and did some additional cleanup based on requested changes * Added ability to pass in TOTP urls * Added additional tests for TOTP server functions * Removed unused QRSize, URL and Generate members of keyEntry struct * Removed unnecessary urlstring variable from pathKeyCreate * Added website documentation for TOTP secret backend * Added errors if generate is true and url or key is passed, removed logger from backend, and revised parameter documentation. * Updated website documentation and added QR example * Added exported variable and ability to disable QR generation, cleaned up error reporting, changed default skew value, updated documentation and added additional tests * Updated API documentation to inlude to exported variable and qr size option * Cleaned up return statements in path_code, added error handling while validating codes and clarified documentation for generate parameters in path_keys
71 lines
2.2 KiB
Go
71 lines
2.2 KiB
Go
/**
|
|
* Copyright 2014 Paul Querna
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
*/
|
|
|
|
// Package otp implements both HOTP and TOTP based
|
|
// one time passcodes in a Google Authenticator compatible manner.
|
|
//
|
|
// When adding a TOTP for a user, you must store the "secret" value
|
|
// persistently. It is recommend to store the secret in an encrypted field in your
|
|
// datastore. Due to how TOTP works, it is not possible to store a hash
|
|
// for the secret value like you would a password.
|
|
//
|
|
// To enroll a user, you must first generate an OTP for them. Google
|
|
// Authenticator supports using a QR code as an enrollment method:
|
|
//
|
|
// import (
|
|
// "github.com/pquerna/otp/totp"
|
|
//
|
|
// "bytes"
|
|
// "image/png"
|
|
// )
|
|
//
|
|
// key, err := totp.Generate(totp.GenerateOpts{
|
|
// Issuer: "Example.com",
|
|
// AccountName: "alice@example.com",
|
|
// })
|
|
//
|
|
// // Convert TOTP key into a QR code encoded as a PNG image.
|
|
// var buf bytes.Buffer
|
|
// img, err := key.Image(200, 200)
|
|
// png.Encode(&buf, img)
|
|
//
|
|
// // display the QR code to the user.
|
|
// display(buf.Bytes())
|
|
//
|
|
// // Now Validate that the user's successfully added the passcode.
|
|
// passcode := promptForPasscode()
|
|
// valid := totp.Validate(passcode, key.Secret())
|
|
//
|
|
// if valid {
|
|
// // User successfully used their TOTP, save it to your backend!
|
|
// storeSecret("alice@example.com", key.Secret())
|
|
// }
|
|
//
|
|
// Validating a TOTP passcode is very easy, just prompt the user for a passcode
|
|
// and retrieve the associated user's previously stored secret.
|
|
// import "github.com/pquerna/otp/totp"
|
|
//
|
|
// passcode := promptForPasscode()
|
|
// secret := getSecret("alice@example.com")
|
|
//
|
|
// valid := totp.Validate(passcode, secret)
|
|
//
|
|
// if valid {
|
|
// // Success! continue login process.
|
|
// }
|
|
package otp
|