Skip to content

Commit 46dd0be

Browse files
committed
Add warnings against exposing auth tokens in web apps
1 parent 5e106d2 commit 46dd0be

File tree

4 files changed

+24
-0
lines changed
  • 13/umbraco-cms/reference/content-delivery-api
  • 15/umbraco-cms/reference/content-delivery-api/protected-content-in-the-delivery-api
  • 16/umbraco-cms/reference/content-delivery-api/protected-content-in-the-delivery-api
  • 17/umbraco-cms/reference/content-delivery-api/protected-content-in-the-delivery-api

4 files changed

+24
-0
lines changed

13/umbraco-cms/reference/content-delivery-api/protected-content-in-the-delivery-api.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,12 @@ Member authorization in the Delivery API was introduced in version 12.3.
1616
If you are not familiar with members in Umbraco, please read the [Members](https://docs.umbraco.com/umbraco-cms/fundamentals/data/members) article.
1717
{% endhint %}
1818

19+
{% hint style="warning" %}
20+
It is no longer recommended to use public OpenID Connect (OAuth) clients for web applications. If you want to use protected content from the Delivery API in a web application, please consider adding additional layers of security.
21+
22+
You'll find more details in [this article](https://learn.microsoft.com/en-us/aspnet/core/security/authentication/configure-oidc-web-authentication) from Microsoft.
23+
{% endhint %}
24+
1925
## Member authorization
2026

2127
Member authentication and authorization in the Delivery API is performed using the OpenId Connect flow _Authorization Code Flow + Proof Key of Code Exchange (PKCE)_. This is a complex authorization flow, and it is beyond the scope of this article to explain it. Many articles can be found online that explain the flow in detail.

15/umbraco-cms/reference/content-delivery-api/protected-content-in-the-delivery-api/README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,12 @@ This article describes how to access protected content in a client-to-server con
1818
If you are looking to achieve server-to-server access to protected content, please refer to [server-to-server access article](server-to-server-access.md) instead.
1919
{% endhint %}
2020

21+
{% hint style="warning" %}
22+
It is no longer recommended to use public OpenID Connect (OAuth) clients for web applications. If you want to use protected content from the Delivery API in a web application, please consider adding additional layers of security.
23+
24+
You'll find more details in [this article](https://learn.microsoft.com/en-us/aspnet/core/security/authentication/configure-oidc-web-authentication) from Microsoft.
25+
{% endhint %}
26+
2127
## Member authorization
2228

2329
Member authentication and authorization in the Delivery API is performed using the OpenId Connect flow _Authorization Code Flow + Proof Key of Code Exchange (PKCE)_. This is a complex authorization flow, and it is beyond the scope of this article to explain it. Many articles can be found online that explain the flow in detail.\

16/umbraco-cms/reference/content-delivery-api/protected-content-in-the-delivery-api/README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,12 @@ This article describes how to access protected content in a client-to-server con
1818
If you are looking to achieve server-to-server access to protected content, please refer to [server-to-server access article](server-to-server-access.md) instead.
1919
{% endhint %}
2020

21+
{% hint style="warning" %}
22+
It is no longer recommended to use public OpenID Connect (OAuth) clients for web applications. If you want to use protected content from the Delivery API in a web application, please consider adding additional layers of security.
23+
24+
You'll find more details in [this article](https://learn.microsoft.com/en-us/aspnet/core/security/authentication/configure-oidc-web-authentication) from Microsoft.
25+
{% endhint %}
26+
2127
## Member authorization
2228

2329
Member authentication and authorization in the Delivery API is performed using the OpenId Connect flow _Authorization Code Flow + Proof Key of Code Exchange (PKCE)_. This is a complex authorization flow, and it is beyond the scope of this article to explain it. Many articles can be found online that explain the flow in detail.\

17/umbraco-cms/reference/content-delivery-api/protected-content-in-the-delivery-api/README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,12 @@ If you are looking to achieve server-to-server access to protected content, plea
2323
Member authentication and authorization in the Delivery API is performed using the OpenId Connect flow _Authorization Code Flow + Proof Key of Code Exchange (PKCE)_. This is a complex authorization flow, and it is beyond the scope of this article to explain it. Many articles can be found online that explain the flow in detail.\
2424
Most programming languages have OpenId Connect client libraries to handle the complexity for us. [`AppAuth`](https://appauth.io/) is a great example of such a library. In ASP.NET Core, OpenId Connect support is built into the framework.
2525

26+
{% hint style="warning" %}
27+
It is no longer recommended to use public OpenID Connect (OAuth) clients for web applications. If you want to use protected content from the Delivery API in a web application, please consider adding additional layers of security.
28+
29+
You'll find more details in [this article](https://learn.microsoft.com/en-us/aspnet/core/security/authentication/configure-oidc-web-authentication) from Microsoft.
30+
{% endhint %}
31+
2632
### Enabling member authorization
2733

2834
Member authorization is an opt-in feature of the Delivery API. To enable it, configure `MemberAuthorization:AuthorizationCodeFlow` in the `DeliveryApi` section of `appsettings.json`:

0 commit comments

Comments
 (0)