Skip to content

Commit 236068a

Browse files
[Dex migration] Add note: users must clear cookies (#1886)
1 parent 73f01f6 commit 236068a

File tree

3 files changed

+27
-15
lines changed
  • content/kubermatic

3 files changed

+27
-15
lines changed

content/kubermatic/main/installation/upgrading/upgrade-from-2.26-to-2.27/_index.en.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,10 @@ Administrators are advised to begin migrating to the new chart as soon as possib
7878

7979
#### Migration Procedure
8080

81+
{{% notice warning %}}
82+
After migrating to Dex, users may encounter login issues due to invalid tokens. To resolve, clear browser cookies for the application domain and log in again.
83+
{{% /notice %}}
84+
8185
Most importantly, with this change the Kubernetes namespace where Dex is installed is also changed. Previously we installed Dex into the `oauth` namespace, but the new chart is meant to be installed into the `dex` namespace. This is the default the KKP installer will choose; if you install KKP manually you could place Dex into any namespace.
8286

8387
Because the namespace changes, both old and new Dex can temporarily live side-by-side in your cluster. This allows administrators to verify their configuration changes before migration over to the new Dex instances.
@@ -199,11 +203,11 @@ You should see a response similar to:
199203

200204
```json
201205
{
202-
"issuer": "https://kkp.securinets.tn/dex2",
203-
"authorization_endpoint": "https://kkp.securinets.tn/dex2/auth",
204-
"token_endpoint": "https://kkp.securinets.tn/dex2/token",
205-
"jwks_uri": "https://kkp.securinets.tn/dex2/keys",
206-
"userinfo_endpoint": "https://kkp.securinets.tn/dex2/userinfo",
206+
"issuer": "https://kkp.example.com/dex2",
207+
"authorization_endpoint": "https://kkp.example.com/dex2/auth",
208+
"token_endpoint": "https://kkp.example.com/dex2/token",
209+
"jwks_uri": "https://kkp.example.com/dex2/keys",
210+
"userinfo_endpoint": "https://kkp.example.com/dex2/userinfo",
207211
...
208212
}
209213
```

content/kubermatic/main/installation/upgrading/upgrade-from-2.27-to-2.28/_index.en.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,10 @@ Administrators are advised to begin migrating to the new chart as soon as possib
144144

145145
#### Migration Procedure
146146

147+
{{% notice warning %}}
148+
After migrating to Dex, users may encounter login issues due to invalid tokens. To resolve, clear browser cookies for the application domain and log in again.
149+
{{% /notice %}}
150+
147151
With 2.28, the KKP installer will install the new `dex` Helm chart into the `dex` namespace, instead of the old `oauth` namespace. This ensures that the old `oauth` chart remains intact and is not removed by KKP, which could result in downtimes.
148152

149153
This is the default namespace that the KKP installer will choose. If you install KKP manually you could place Dex into any namespace.
@@ -267,11 +271,11 @@ You should see a response similar to:
267271

268272
```json
269273
{
270-
"issuer": "https://kkp.securinets.tn/dex2",
271-
"authorization_endpoint": "https://kkp.securinets.tn/dex2/auth",
272-
"token_endpoint": "https://kkp.securinets.tn/dex2/token",
273-
"jwks_uri": "https://kkp.securinets.tn/dex2/keys",
274-
"userinfo_endpoint": "https://kkp.securinets.tn/dex2/userinfo",
274+
"issuer": "https://kkp.example.com/dex2",
275+
"authorization_endpoint": "https://kkp.example.com/dex2/auth",
276+
"token_endpoint": "https://kkp.example.com/dex2/token",
277+
"jwks_uri": "https://kkp.example.com/dex2/keys",
278+
"userinfo_endpoint": "https://kkp.example.com/dex2/userinfo",
275279
...
276280
}
277281
```

content/kubermatic/v2.27/installation/upgrading/upgrade-from-2.26-to-2.27/_index.en.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,10 @@ Administrators are advised to begin migrating to the new chart as soon as possib
7878

7979
#### Migration Procedure
8080

81+
{{% notice warning %}}
82+
After migrating to Dex, users may encounter login issues due to invalid tokens. To resolve, clear browser cookies for the application domain and log in again.
83+
{{% /notice %}}
84+
8185
Most importantly, with this change the Kubernetes namespace where Dex is installed is also changed. Previously we installed Dex into the `oauth` namespace, but the new chart is meant to be installed into the `dex` namespace. This is the default the KKP installer will choose; if you install KKP manually you could place Dex into any namespace.
8286

8387
Because the namespace changes, both old and new Dex can temporarily live side-by-side in your cluster. This allows administrators to verify their configuration changes before migration over to the new Dex instances.
@@ -199,11 +203,11 @@ You should see a response similar to:
199203

200204
```json
201205
{
202-
"issuer": "https://kkp.securinets.tn/dex2",
203-
"authorization_endpoint": "https://kkp.securinets.tn/dex2/auth",
204-
"token_endpoint": "https://kkp.securinets.tn/dex2/token",
205-
"jwks_uri": "https://kkp.securinets.tn/dex2/keys",
206-
"userinfo_endpoint": "https://kkp.securinets.tn/dex2/userinfo",
206+
"issuer": "https://kkp.example.com/dex2",
207+
"authorization_endpoint": "https://kkp.example.com/dex2/auth",
208+
"token_endpoint": "https://kkp.example.com/dex2/token",
209+
"jwks_uri": "https://kkp.example.com/dex2/keys",
210+
"userinfo_endpoint": "https://kkp.example.com/dex2/userinfo",
207211
...
208212
}
209213
```

0 commit comments

Comments
 (0)