diff --git a/README.md b/README.md index d774907..8c4bb5b 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # jwt-go [![Build Status](https://travis-ci.org/dgrijalva/jwt-go.svg?branch=master)](https://travis-ci.org/dgrijalva/jwt-go) -[![GoDoc](https://godoc.org/github.com/dgrijalva/jwt-go?status.svg)](https://godoc.org/github.com/dgrijalva/jwt-go) +[![GoDoc](https://godoc.org/github.com/golang-jwt/jwt?status.svg)](https://godoc.org/github.com/golang-jwt/jwt) A [go](http://www.golang.org) (or 'golang' for search engine friendliness) implementation of [JSON Web Tokens](http://self-issued.info/docs/draft-ietf-oauth-json-web-token.html) @@ -27,11 +27,11 @@ This library supports the parsing and verification as well as the generation and ## Examples -See [the project documentation](https://godoc.org/github.com/dgrijalva/jwt-go) for examples of usage: +See [the project documentation](https://godoc.org/github.com/golang-jwt/jwt) for examples of usage: -* [Simple example of parsing and validating a token](https://godoc.org/github.com/dgrijalva/jwt-go#example-Parse--Hmac) -* [Simple example of building and signing a token](https://godoc.org/github.com/dgrijalva/jwt-go#example-New--Hmac) -* [Directory of Examples](https://godoc.org/github.com/dgrijalva/jwt-go#pkg-examples) +* [Simple example of parsing and validating a token](https://godoc.org/github.com/golang-jwt/jwt#example-Parse--Hmac) +* [Simple example of building and signing a token](https://godoc.org/github.com/golang-jwt/jwt#example-New--Hmac) +* [Directory of Examples](https://godoc.org/github.com/golang-jwt/jwt#pkg-examples) ## Extensions @@ -49,7 +49,7 @@ This library was last reviewed to comply with [RTF 7519](http://www.rfc-editor.o This library is considered production ready. Feedback and feature requests are appreciated. The API should be considered stable. There should be very few backwards-incompatible changes outside of major version updates (and only with good reason). -This project uses [Semantic Versioning 2.0.0](http://semver.org). Accepted pull requests will land on `master`. Periodically, versions will be tagged from `master`. You can find all the releases on [the project releases page](https://github.com/dgrijalva/jwt-go/releases). +This project uses [Semantic Versioning 2.0.0](http://semver.org). Accepted pull requests will land on `master`. Periodically, versions will be tagged from `master`. You can find all the releases on [the project releases page](https://github.com/golang-jwt/jwt/releases). While we try to make it obvious when we make breaking changes, there isn't a great mechanism for pushing announcements out to users. You may want to use this alternative package include: `gopkg.in/dgrijalva/jwt-go.v3`. It will do the right thing WRT semantic versioning. @@ -79,9 +79,9 @@ Asymmetric signing methods, such as RSA, use different keys for signing and veri Each signing method expects a different object type for its signing keys. See the package documentation for details. Here are the most common ones: -* The [HMAC signing method](https://godoc.org/github.com/dgrijalva/jwt-go#SigningMethodHMAC) (`HS256`,`HS384`,`HS512`) expect `[]byte` values for signing and validation -* The [RSA signing method](https://godoc.org/github.com/dgrijalva/jwt-go#SigningMethodRSA) (`RS256`,`RS384`,`RS512`) expect `*rsa.PrivateKey` for signing and `*rsa.PublicKey` for validation -* The [ECDSA signing method](https://godoc.org/github.com/dgrijalva/jwt-go#SigningMethodECDSA) (`ES256`,`ES384`,`ES512`) expect `*ecdsa.PrivateKey` for signing and `*ecdsa.PublicKey` for validation +* The [HMAC signing method](https://godoc.org/github.com/golang-jwt/jwt#SigningMethodHMAC) (`HS256`,`HS384`,`HS512`) expect `[]byte` values for signing and validation +* The [RSA signing method](https://godoc.org/github.com/golang-jwt/jwt#SigningMethodRSA) (`RS256`,`RS384`,`RS512`) expect `*rsa.PrivateKey` for signing and `*rsa.PublicKey` for validation +* The [ECDSA signing method](https://godoc.org/github.com/golang-jwt/jwt#SigningMethodECDSA) (`ES256`,`ES384`,`ES512`) expect `*ecdsa.PrivateKey` for signing and `*ecdsa.PublicKey` for validation ### JWT and OAuth @@ -99,6 +99,6 @@ This library uses descriptive error messages whenever possible. If you are not g ## More -Documentation can be found [on godoc.org](http://godoc.org/github.com/dgrijalva/jwt-go). +Documentation can be found [on godoc.org](http://godoc.org/github.com/golang-jwt/jwt). The command line utility included in this project (cmd/jwt) provides a straightforward example of token creation and parsing as well as a useful tool for debugging your own integration. You'll also find several implementation examples in the documentation. diff --git a/cmd/jwt/README.md b/cmd/jwt/README.md index d9d06e7..8c659e9 100644 --- a/cmd/jwt/README.md +++ b/cmd/jwt/README.md @@ -16,5 +16,5 @@ To simply display a token, use: You can install this tool with the following command: - go install github.com/dgrijalva/jwt-go/cmd/jwt + go install github.com/golang-jwt/jwt/cmd/jwt diff --git a/cmd/jwt/app.go b/cmd/jwt/app.go index cdf2500..491f5d2 100644 --- a/cmd/jwt/app.go +++ b/cmd/jwt/app.go @@ -16,7 +16,7 @@ import ( "regexp" "strings" - jwt "github.com/dgrijalva/jwt-go" + "github.com/golang-jwt/jwt" ) var ( diff --git a/ecdsa_test.go b/ecdsa_test.go index 753047b..ad0a401 100644 --- a/ecdsa_test.go +++ b/ecdsa_test.go @@ -6,7 +6,7 @@ import ( "strings" "testing" - "github.com/dgrijalva/jwt-go" + "github.com/golang-jwt/jwt" ) var ecdsaTestData = []struct { diff --git a/example_test.go b/example_test.go index ae8b788..5be4a29 100644 --- a/example_test.go +++ b/example_test.go @@ -2,8 +2,9 @@ package jwt_test import ( "fmt" - "github.com/dgrijalva/jwt-go" "time" + + "github.com/golang-jwt/jwt" ) // Example (atypical) using the StandardClaims type by itself to parse a token. diff --git a/hmac_example_test.go b/hmac_example_test.go index 0027831..7657677 100644 --- a/hmac_example_test.go +++ b/hmac_example_test.go @@ -2,9 +2,10 @@ package jwt_test import ( "fmt" - "github.com/dgrijalva/jwt-go" "io/ioutil" "time" + + "github.com/golang-jwt/jwt" ) // For HMAC signing method, the key can be any []byte. It is recommended to generate @@ -51,7 +52,7 @@ func ExampleParse_hmac() { if _, ok := token.Method.(*jwt.SigningMethodHMAC); !ok { return nil, fmt.Errorf("Unexpected signing method: %v", token.Header["alg"]) } - + // hmacSampleSecret is a []byte containing your secret, e.g. []byte("my_secret_key") return hmacSampleSecret, nil }) diff --git a/hmac_test.go b/hmac_test.go index c7e114f..f45d5db 100644 --- a/hmac_test.go +++ b/hmac_test.go @@ -1,10 +1,11 @@ package jwt_test import ( - "github.com/dgrijalva/jwt-go" "io/ioutil" "strings" "testing" + + "github.com/golang-jwt/jwt" ) var hmacTestData = []struct { diff --git a/http_example_test.go b/http_example_test.go index f3e72c8..3b6330b 100644 --- a/http_example_test.go +++ b/http_example_test.go @@ -16,8 +16,8 @@ import ( "strings" "time" - "github.com/dgrijalva/jwt-go" - "github.com/dgrijalva/jwt-go/request" + "github.com/golang-jwt/jwt" + "github.com/golang-jwt/jwt/request" ) // location of the files used for signing and verification diff --git a/none_test.go b/none_test.go index 29a69ef..9e3371a 100644 --- a/none_test.go +++ b/none_test.go @@ -1,9 +1,10 @@ package jwt_test import ( - "github.com/dgrijalva/jwt-go" "strings" "testing" + + "github.com/golang-jwt/jwt" ) var noneTestData = []struct { diff --git a/parser_test.go b/parser_test.go index 3907797..7fb1580 100644 --- a/parser_test.go +++ b/parser_test.go @@ -8,8 +8,8 @@ import ( "testing" "time" - "github.com/dgrijalva/jwt-go" - "github.com/dgrijalva/jwt-go/test" + "github.com/golang-jwt/jwt" + "github.com/golang-jwt/jwt/test" ) var keyFuncError error = fmt.Errorf("error loading key") diff --git a/request/request.go b/request/request.go index 70525cf..32b2729 100644 --- a/request/request.go +++ b/request/request.go @@ -1,8 +1,9 @@ package request import ( - "github.com/dgrijalva/jwt-go" "net/http" + + "github.com/golang-jwt/jwt" ) // Extract and parse a JWT token from an HTTP request. diff --git a/request/request_test.go b/request/request_test.go index b4365cd..fd3a850 100644 --- a/request/request_test.go +++ b/request/request_test.go @@ -2,13 +2,14 @@ package request import ( "fmt" - "github.com/dgrijalva/jwt-go" - "github.com/dgrijalva/jwt-go/test" "net/http" "net/url" "reflect" "strings" "testing" + + "github.com/golang-jwt/jwt" + "github.com/golang-jwt/jwt/test" ) var requestTestData = []struct { diff --git a/rsa_pss.go b/rsa_pss.go index c014708..db23769 100644 --- a/rsa_pss.go +++ b/rsa_pss.go @@ -15,7 +15,7 @@ type SigningMethodRSAPSS struct { // VerifyOptions is optional. If set overrides Options for rsa.VerifyPPS. // Used to accept tokens signed with rsa.PSSSaltLengthAuto, what doesn't follow // https://tools.ietf.org/html/rfc7518#section-3.5 but was used previously. - // See https://github.com/dgrijalva/jwt-go/issues/285#issuecomment-437451244 for details. + // See https://github.com/golang-jwt/jwt/issues/285#issuecomment-437451244 for details. VerifyOptions *rsa.PSSOptions } diff --git a/rsa_pss_test.go b/rsa_pss_test.go index e0134d9..167731a 100644 --- a/rsa_pss_test.go +++ b/rsa_pss_test.go @@ -9,8 +9,8 @@ import ( "testing" "time" - "github.com/dgrijalva/jwt-go" - "github.com/dgrijalva/jwt-go/test" + "github.com/golang-jwt/jwt" + "github.com/golang-jwt/jwt/test" ) var rsaPSSTestData = []struct { @@ -106,7 +106,7 @@ func TestRSAPSSSaltLengthCompatibility(t *testing.T) { }, } - // Behaves as before https://github.com/dgrijalva/jwt-go/issues/285 fix. + // Behaves as before https://github.com/golang-jwt/jwt/issues/285 fix. ps256SaltLengthAuto := &jwt.SigningMethodRSAPSS{ SigningMethodRSA: jwt.SigningMethodPS256.SigningMethodRSA, Options: &rsa.PSSOptions{ diff --git a/rsa_test.go b/rsa_test.go index 7f67c5d..fba45e0 100644 --- a/rsa_test.go +++ b/rsa_test.go @@ -1,10 +1,11 @@ package jwt_test import ( - "github.com/dgrijalva/jwt-go" "io/ioutil" "strings" "testing" + + "github.com/golang-jwt/jwt" ) var rsaTestData = []struct { diff --git a/test/helpers.go b/test/helpers.go index f84c3ef..ef54aea 100644 --- a/test/helpers.go +++ b/test/helpers.go @@ -2,8 +2,9 @@ package test import ( "crypto/rsa" - "github.com/dgrijalva/jwt-go" "io/ioutil" + + "github.com/golang-jwt/jwt" ) func LoadRSAPrivateKeyFromDisk(location string) *rsa.PrivateKey {