Skip to content

Commit 9661d02

Browse files
committed
Revert "Add IdentityServer 8.0 documentation"
This reverts commit e980773. # Conflicts: # .weave/plans/is8-docs.md
1 parent 1c0e180 commit 9661d02

30 files changed

Lines changed: 536 additions & 2697 deletions

.weave/plans/is8-docs.md

Lines changed: 0 additions & 794 deletions
This file was deleted.

astro/src/content/docs/bff/extensibility/index.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,6 @@ redirect_from:
1414

1515
Duende.BFF can be extended in the following areas
1616

17-
- custom logic at the session management endpoints
18-
- custom logic and configuration for HTTP forwarding
19-
- custom data storage for server-side sessions and access/refresh tokens
20-
- [enriching claims returned from the user endpoint](/bff/extensibility/user-endpoint-claims/) using `IUserEndpointClaimsEnricher` (added in v8.0)
17+
* custom logic at the session management endpoints
18+
* custom logic and configuration for HTTP forwarding
19+
* custom data storage for server-side sessions and access/refresh tokens

astro/src/content/docs/bff/extensibility/user-endpoint-claims.md

Lines changed: 0 additions & 78 deletions
This file was deleted.

astro/src/content/docs/identityserver/aspnet-identity/schemes.md

Lines changed: 1 addition & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,6 @@ When a user logs in, their identity is established and persisted across requests
1616

1717
When using IdentityServer without ASP.NET Identity, the default cookie scheme is named `"idsrv"`, though we recommend using the constant `IdentityServerConstants.DefaultCookieAuthenticationScheme` in your code if you ever need it.
1818

19-
Starting in **v8.0**, the default cookie name (not the scheme name) has changed to `"__Host-idsrv"` to improve security. The scheme name remains `"idsrv"`. See [Cookie Name Migration (v8.0)](#cookie-name-migration-v80) below for upgrade instructions.
20-
2119
The default cookie scheme is configured by default in `AddIdentityServer()`, which sets up the cookie authentication handler with this scheme name. This cookie is essential for:
2220

2321
- maintaining the user's authenticated session
@@ -41,7 +39,7 @@ services.ConfigureApplicationCookie(options =>
4139
{
4240
// The default ("Identity.Application")
4341
options.Cookie.Name = IdentityConstants.ApplicationScheme;
44-
42+
4543
// Configure other options here...
4644
options.ExpireTimeSpan = TimeSpan.FromHours(1);
4745
options.SlidingExpiration = true;
@@ -59,8 +57,6 @@ This allows your login logic to read the claims from the external provider befor
5957

6058
IdentityServer always uses the `"idsrv.external"` scheme here, available in the `IdentityServerConstants.ExternalCookieAuthenticationScheme` constant.
6159

62-
Starting in **v8.0**, the default cookie _name_ for this scheme has changed to `"__Host-idsrv.external"` (previously `"idsrv.external"`). See [Cookie Name Migration (v8.0)](#cookie-name-migration-v80) below for upgrade instructions.
63-
6460
### Check Session Cookie
6561

6662
IdentityServer session management requires a separate cookie to monitor the session state without sending the large authentication cookie.
@@ -70,59 +66,6 @@ The [User Session Service](/identityserver/reference/services/user-session-servi
7066

7167
Note this cookie is not marked as `HttpOnly`, so it can be accessed in client-side code. The JavaScript code that is required to check user sessions in the background also requires access to this cookie, and needs it to be `HttpOnly`.
7268

73-
## Cookie Name Migration (v8.0)
74-
75-
In IdentityServer v8.0, the default cookie **names** changed to use the `__Host-` prefix:
76-
77-
| Cookie | Old name (v7.x) | New name (v8.0) |
78-
| -------------------- | ---------------- | ----------------------- |
79-
| Primary auth cookie | `idsrv` | `__Host-idsrv` |
80-
| External auth cookie | `idsrv.external` | `__Host-idsrv.external` |
81-
82-
Note: the authentication **scheme names** (`"idsrv"` and `"idsrv.external"`) are unchanged.
83-
84-
### Why `__Host-`?
85-
86-
The `__Host-` prefix is a browser security feature that restricts a cookie to:
87-
88-
- HTTPS-only connections
89-
- `Path=/` (the entire site)
90-
- No `Domain` attribute (preventing subdomain sharing)
91-
92-
This provides defense-in-depth against cookie theft and session fixation attacks.
93-
94-
### Migrating Existing Sessions
95-
96-
To avoid invalidating existing user sessions when upgrading, use the migration middleware to
97-
transparently accept both old and new cookie names. Add it to `Program.cs` **before**
98-
`UseIdentityServer()`, calling it once per cookie:
99-
100-
```csharp
101-
// Program.cs — add BEFORE UseIdentityServer()
102-
app.MigrateIdentityServerCookieName("idsrv", "__Host-idsrv");
103-
app.MigrateIdentityServerCookieName("idsrv.external", "__Host-idsrv.external");
104-
app.UseIdentityServer();
105-
```
106-
107-
When a user visits with an old cookie, the middleware transparently re-issues it under the new
108-
name. Once all active sessions have been re-issued, you can remove the middleware calls.
109-
110-
### Configuring Cookie Names
111-
112-
Override the default names using `AuthenticationOptions`:
113-
114-
```csharp
115-
builder.Services.AddIdentityServer(options =>
116-
{
117-
// Restore legacy names if needed (e.g., staged migration)
118-
options.Authentication.CookieName = "idsrv";
119-
options.Authentication.ExternalCookieName = "idsrv.external";
120-
});
121-
```
122-
123-
See the [upgrade guide](/identityserver/upgrades/v7_4-to-v8_0/#cookie-names-changed-to-__host--prefix)
124-
for full migration instructions.
125-
12669
## Common Pitfalls
12770

12871
- **Mixing Schemes:** Attempting to `SignOutAsync("idsrv")` when ASP.NET Identity is in use will have no effect on the actual `"Identity.Application"` cookie, leaving the user logged in. Always use the constants or the helper services (like `SignInManager`) that match your configuration.

astro/src/content/docs/identityserver/diagnostics/conformance-report.md

Lines changed: 0 additions & 137 deletions
This file was deleted.

astro/src/content/docs/identityserver/diagnostics/index.md

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -33,11 +33,4 @@ systems (APM). They used to have their own different APIs so IdentityServer only
3333
that could be used to call the APM's APIs. Thanks to OpenTelemetry there is now a standardized
3434
way to emit diagnostic information from a process. The events may eventually be deprecated and removed.
3535

36-
[Read More](/identityserver/diagnostics/events.md)
37-
38-
## Conformance Report
39-
40-
IdentityServer can generate a conformance report that assesses your configuration against OAuth 2.1
41-
and FAPI 2.0 specifications.
42-
43-
[Read More](/identityserver/diagnostics/conformance-report/)
36+
[Read More](/identityserver/diagnostics/events.md)

0 commit comments

Comments
 (0)