Skip to content
This repository was archived by the owner on Apr 9, 2019. It is now read-only.
/ stormpath-sdk-go Public archive

Go SDK for the Stormpath API

License

Notifications You must be signed in to change notification settings

jarias/stormpath-sdk-go

Folders and files

NameName
Last commit message
Last commit date

Latest commit

a458778 · Mar 6, 2017
Mar 26, 2014
Jan 18, 2017
Aug 30, 2016
Jan 18, 2017
Jan 17, 2017
Aug 10, 2015
Mar 6, 2017
Jan 18, 2017
May 25, 2016
Sep 5, 2016
Jan 18, 2017
Jan 18, 2017
Jan 18, 2017
Sep 5, 2016
Jan 18, 2017
Jan 18, 2017
Sep 5, 2016
Jan 18, 2017
Jan 18, 2017
Jan 18, 2017
Jan 18, 2017
Sep 5, 2016
Jun 13, 2016
Aug 19, 2016
Aug 19, 2016
Jun 13, 2016
Jun 13, 2016
Jan 18, 2017
Jan 18, 2017
Jun 13, 2016
Jan 18, 2017
Jan 18, 2017
Jan 18, 2017
Jun 13, 2016
Sep 5, 2016
Sep 7, 2016
Jan 18, 2017
Aug 31, 2016
Jan 18, 2017
Jan 18, 2017
Jan 18, 2017
Jan 18, 2017
Jan 18, 2017
Sep 5, 2016
Jun 18, 2016
Jun 13, 2016
Jun 13, 2016
Jun 13, 2016
Sep 5, 2016
Jun 13, 2016
Jan 18, 2017
Jan 18, 2017
Sep 5, 2016
Aug 10, 2015
Jun 13, 2016
Jan 18, 2017
Jun 13, 2016
Jun 13, 2016
Jan 18, 2017
Jan 18, 2017
Jan 18, 2017
Jan 18, 2017

Repository files navigation


Due to this announcement https://stormpath.com/blog/stormpaths-new-path 
this project is no longer maintain

Go SDK for the Stormpath API

Develop:

Build Status codecov.io

Master:

Build Status codecov.io

Usage

Core

go get github.com/jarias/stormpath-sdk-go

import "github.com/jarias/stormpath-sdk-go"
import "fmt"

//Load the configuration according to the StormPath framework spec
//See: https://github.com/stormpath/stormpath-sdk-spec/blob/master/specifications/config.md
clientConfig, err := stormpath.LoadConfiguration()

if err != nil {
    stormpath.Logger.Panicf("[ERROR] Couldn't load Stormpath client configuration: %s", err)
}

//Init the client with the loaded config and no specific cache,
//note that if the cache is enabled via config the default local cache would be used
stormpath.Init(clientConfig, nil)

//Get the current tenant
tenant, _ := stormpath.CurrentTenant()

//Get the tenat applications
apps, _ := tenant.GetApplications(stormpath.MakeApplicationCriteria().NameEq("test app"))

//Get the first application
app := apps.Items[0]

//Authenticate a user against the app
account, _ := app.AuthenticateAccount("username", "password")

fmt.Println(account)

Web

See web/example/example.go

Features

  • Cache with a sample local in-memory implementation
  • Almost 100% of the Stormpath API implemented
  • Load credentials via properties file or env variables
  • Load client configuration according to Stormpath framework spec
  • Requests are authenticated via Stormpath SAuthc1 algorithm only
  • Web extension according to the Stormpath Spec

Debugging

If you need to trace all requests done to stormpath you can enable debugging in the logs by setting the environment variable STORMPATH_LOG_LEVEL=DEBUG the default level is ERROR.

Contributing

Pull request are more than welcome, please follow this sample workflow, make sure you work out of the develop branch.

  • Fork
  • Clone git clone YOUR_USERNAME/stormpath-sdk-go
  • Checkout develop branch git checkout -t origin/develop
  • Create a feature branch git checkout -b YOUR_FEATURE_OR_BUG_FIX
  • Create a PR to jarias/develop hub pull-request -b jarias/stormpath-sdk-go:develop

Please make sure you add tests ;)

Development requirements:

  • Go 1.7+
  • Testify go get github.com/stretchr/testify/assert
  • An Stormpath account (for integration testing)

Running the test suite

Env variables:

export STORMPATH_API_KEY_ID=XXXX
export STORMPATH_API_KEY_SECRET=XXXX
go test . -cover -covermode=atomic

I'm aiming at 85% test coverage not yet met but thats the goal.

License

Copyright 2014, 2015, 2016 Julio Arias

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.