docs: update errors list

This commit is contained in:
AJ ONeal 2021-10-21 13:37:21 -06:00
parent 2ea44e3a46
commit d5647ea905
1 changed files with 14 additions and 15 deletions

View File

@ -276,26 +276,25 @@ For now you can limit the number of keys fetched by having a simple whitelist.
SemVer Compatibility: SemVer Compatibility:
- `code` & `status` will remain the same. - `code` & `status` will remain the same.
- The `message` property of an error is **NOT** included in the semver compatibility guarantee (we intend to make them more client-friendly), neither is `detail` at this time (but it will be once we decide on what it should be). - `message` is **NOT** included in the semver compatibility guarantee (we intend to make them more client-friendly), neither is `detail` at this time (but it will be once we decide on what it should be).
- `details` may be added to, but not subtracted from
For backwards compatibility with v1, the non-stringified `message` is the same as what it was in v1 (and the v2 message is `client_message`, which replaces `message` in v3). Don't rely on it. Rely on `code`.
| Hint | Code | Status | Message (truncated) | | Hint | Code | Status | Message (truncated) |
| ------------------- | --------------- | ------ | ------------------------------------------------ | | ------------------- | --------------- | ------ | ------------------------------------------------ |
| (developer error) | DEVELOPER_ERROR | 500 | test... | | (developer error) | DEVELOPER_ERROR | 500 | test... |
| (bad gateway) | BAD_GATEWAY | 502 | The token could not be verified because our s... | | (bad gateway) | BAD_GATEWAY | 502 | The token could not be verified because our s... |
| (insecure issuer) | MALFORMED_JWT | 400 | 'test' is NOT secure. Set env 'KEYFETCH_ALLOW... | | (insecure issuer) | MALFORMED_JWT | 400 | The token could not be verified because our s... |
| (parse error) | MALFORMED_JWT | 400 | could not parse jwt: 'test'... | | (parse error) | MALFORMED_JWT | 400 | The auth token is malformed.... |
| (no issuer) | MALFORMED_JWT | 400 | 'iss' is not defined... | | (no issuer) | MALFORMED_JWT | 400 | The token could not be verified because it do... |
| (malformed exp) | MALFORMED_JWT | 400 | token's 'exp' has passed or could not parsed:... | | (malformed exp) | MALFORMED_JWT | 400 | The auth token could not be verified because ... |
| (expired) | INVALID_JWT | 401 | token's 'exp' has passed or could not parsed:... | | (expired) | INVALID_JWT | 401 | The auth token is expired. To try again, go t... |
| (inactive) | INVALID_JWT | 401 | token's 'nbf' has not been reached or could n... | | (inactive) | INVALID_JWT | 401 | The auth token isn't valid yet. It's activati... |
| (bad signature) | INVALID_JWT | 401 | token signature verification was unsuccessful... | | (bad signature) | INVALID_JWT | 401 | The auth token did not pass verification beca... |
| (jwk not found old) | INVALID_JWT | 401 | Retrieved a list of keys, but none of them ma... | | (jwk not found old) | INVALID_JWT | 401 | The auth token did not pass verification beca... |
| (jwk not found) | INVALID_JWT | 401 | No JWK found by kid or thumbprint 'test'... | | (jwk not found) | INVALID_JWT | 401 | The auth token did not pass verification beca... |
| (no jwkws uri) | INVALID_JWT | 401 | Failed to retrieve openid configuration... | | (no jwkws uri) | INVALID_JWT | 401 | The auth token did not pass verification beca... |
| (unknown issuer) | INVALID_JWT | 401 | token was issued by an untrusted issuer: 'tes... | | (unknown issuer) | INVALID_JWT | 401 | The auth token did not pass verification beca... |
| (failed claims) | INVALID_JWT | 401 | token did not match on one or more authorizat... | | (failed claims) | INVALID_JWT | 401 | The auth token did not pass verification beca... |
# Change Log # Change Log