Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

OAuth2 implicit grant is not secure #3584

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions versions/1.2.md
Original file line number Diff line number Diff line change
Expand Up @@ -172,6 +172,10 @@ Field Name | Type | Description
<a name="rlInfo"/>info | [Info Object](#513-info-object) | Provides metadata about the API. The metadata can be used by the clients if needed, and can be presented in the Swagger-UI for convenience.
<a name="rlAuthorizations"/>authorizations | [Authorizations Object](#514-authorizations-object) | Provides information about the authorization schemes allowed on this API.

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

#### 5.1.1 Object Example

```js
Expand Down Expand Up @@ -342,6 +346,10 @@ The object provides information about a specific authorization scheme. Currently

Within OAuth2, the Authorization Code Grant and Implicit Grant are supported.

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

In the table below, the `Validity` column imposes additional limitations to the requirement of the [`type`](#authorizationType) in order to be able to use that field.

Field Name | Type | Validity | Description
Expand Down Expand Up @@ -407,6 +415,10 @@ Field Name | Type | Description
#### 5.1.7 Grant Types Object
Provides details regarding the OAuth2 grant types that are supported by the API. Currently, the Authorization Code and Implicit grants are supported.

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

At least one of the grant types MUST be included (otherwise there's no need for the OAuth2 declaration).

Field Name | Type | Description
Expand Down Expand Up @@ -438,6 +450,11 @@ Field Name | Type | Description
```

#### 5.1.8 Implicit Object

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

Provides details regarding the OAuth2's Implicit Grant flow type.

Field Name | Type | Description
Expand Down Expand Up @@ -479,6 +496,11 @@ Field Name | Type | Description
```

#### 5.1.10 Login Endpoint Object

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

Provides details regarding the Implicit Grant's *authorization endpoint*.

Field Name | Type | Description
Expand Down
12 changes: 12 additions & 0 deletions versions/2.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -2097,6 +2097,10 @@ Field Pattern | Type | Description

##### Security Definitions Object Example

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

```js
{
"api_key": {
Expand Down Expand Up @@ -2134,6 +2138,10 @@ petstore_auth:

Allows the definition of a security scheme that can be used by the operations. Supported schemes are basic authentication, an API key (either as a header or as a query parameter) and OAuth2's common flows (implicit, password, application and access code).

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

##### Fixed Fields
Field Name | Type | Validity | Description
---|:---:|---|---
Expand Down Expand Up @@ -2184,6 +2192,10 @@ in: header

###### Implicit OAuth2 Sample

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

```js
{
"type": "oauth2",
Expand Down
12 changes: 12 additions & 0 deletions versions/3.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -559,6 +559,10 @@ my.org.User
}
```

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

```yaml
components:
schemas:
Expand Down Expand Up @@ -3196,6 +3200,10 @@ animals:
Defines a security scheme that can be used by the operations.
Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2's common flows (implicit, password, application and access code) as defined in [RFC6749](https://tools.ietf.org/html/rfc6749), and [OpenID Connect Discovery](https://tools.ietf.org/html/draft-ietf-oauth-discovery-06).

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

##### Fixed Fields
Field Name | Type | Applies To | Description
---|:---:|---|---
Expand Down Expand Up @@ -3260,6 +3268,10 @@ bearerFormat: JWT

###### Implicit OAuth2 Sample

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

```json
{
"type": "oauth2",
Expand Down
12 changes: 12 additions & 0 deletions versions/3.0.1.md
Original file line number Diff line number Diff line change
Expand Up @@ -469,6 +469,10 @@ my.org.User

##### Components Object Example

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

```json
"components": {
"schemas": {
Expand Down Expand Up @@ -3134,6 +3138,10 @@ animals:
Defines a security scheme that can be used by the operations.
Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2's common flows (implicit, password, application and access code) as defined in [RFC6749](https://tools.ietf.org/html/rfc6749), and [OpenID Connect Discovery](https://tools.ietf.org/html/draft-ietf-oauth-discovery-06).

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

##### Fixed Fields
Field Name | Type | Applies To | Description
---|:---:|---|---
Expand Down Expand Up @@ -3198,6 +3206,10 @@ bearerFormat: JWT

###### Implicit OAuth2 Sample

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

```json
{
"type": "oauth2",
Expand Down
8 changes: 8 additions & 0 deletions versions/3.0.2.md
Original file line number Diff line number Diff line change
Expand Up @@ -3165,6 +3165,10 @@ animals:
Defines a security scheme that can be used by the operations.
Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), OAuth2's common flows (implicit, password, application and access code) as defined in [RFC6749](https://tools.ietf.org/html/rfc6749), and [OpenID Connect Discovery](https://tools.ietf.org/html/draft-ietf-oauth-discovery-06).

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

##### Fixed Fields
Field Name | Type | Applies To | Description
---|:---:|---|---
Expand Down Expand Up @@ -3229,6 +3233,10 @@ bearerFormat: JWT

###### Implicit OAuth2 Sample

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

```json
{
"type": "oauth2",
Expand Down
4 changes: 4 additions & 0 deletions versions/3.0.3.md
Original file line number Diff line number Diff line change
Expand Up @@ -3245,6 +3245,10 @@ bearerFormat: JWT

###### Implicit OAuth2 Sample

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

```json
{
"type": "oauth2",
Expand Down
8 changes: 8 additions & 0 deletions versions/3.1.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -3255,6 +3255,10 @@ bearerFormat: JWT

###### Implicit OAuth2 Sample

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

```json
{
"type": "oauth2",
Expand Down Expand Up @@ -3284,6 +3288,10 @@ flows:

Allows configuration of the supported OAuth Flows.

```
Security note: OAuth2 implicit grant is considered to be not secure and should not be used by clients.
```

##### Fixed Fields
Field Name | Type | Description
---|:---:|---
Expand Down