Включение OIDC Server
Предварительные требования
Конфигурация OIDC API server должен быть настроен на использование OIDC. Если используется Talos Linux, machine configuration должна включать следующие параметры:
cluster: apiServer: extraArgs: oidc-issuer-url: "https://keycloak.example.org/realms/cozy" oidc-client-id: "kubernetes" oidc-username-claim: "preferred_username" oidc-groups-claim: "groups"Для Talm Добавьте в
values.yamlв репозитории talm:oidcIssuerUrl: "https://keycloak.<YOUR_ROOT_DOMAIN>/realms/cozy"Доступность домена Убедитесь, что домен
keycloak.example.orgдоступен из кластера и резолвится в root ingress controller.Конфигурация storage Storage должен быть корректно настроен.
Конфигурация
Если все предварительные требования выполнены, можно переходить к настройке.
Шаг 1: включите OIDC в Cozystack
Пропатчите Platform Package, чтобы включить OIDC. Это также автоматически опубликует сервис Keycloak:
kubectl patch packages.cozystack.io cozystack.cozystack-platform --type=merge -p '{
"spec": {
"components": {
"platform": {
"values": {
"authentication": {
"oidc": {
"enabled": true
}
}
}
}
}
}
}'
Если нужно добавить дополнительные redirect URLs для dashboard client (например, при доступе к dashboard через port-forwarding), пропатчите Platform Package. Несколько redirect URLs разделяются запятыми.
kubectl patch packages.cozystack.io cozystack.cozystack-platform --type=merge -p '{
"spec": {
"components": {
"platform": {
"values": {
"authentication": {
"oidc": {
"keycloakExtraRedirectUri": "http://127.0.0.1:8080/oauth2/callback/*,http://localhost:8080/oauth2/callback/*"
}
}
}
}
}
}
}'
keycloak-http Service by default, while browser-facing redirects keep the external issuer URL. Override keycloakInternalUrl only when Keycloak is deployed at a different in-cluster address, or set it to an empty string to restore external OIDC discovery. See
Private CA and Let’s Encrypt Staging for private and development certificate trust.В течение минуты CozyStack выполнит reconcile и создаст три новых ресурса HelmRelease:
# kubectl get hr -n cozy-keycloak
cozy-keycloak keycloak 26s Unknown Running 'install' action with a timeout of 5m0s
cozy-keycloak keycloak-configure 26s False dependency 'cozy-keycloak/keycloak-operator' is not ready
cozy-keycloak keycloak-operator 26s False dependency 'cozy-keycloak/keycloak' is not ready
Шаг 2: дождитесь завершения установки
Дождитесь, пока все ресурсы успешно установятся и перейдут в состояние Ready:
NAME AGE READY STATUS
keycloak 2m19s True Release reconciliation succeeded
keycloak-configure 2m19s True Release reconciliation succeeded
keycloak-operator 2m19s True Release reconciliation succeeded
Выполните reconcile tenants:
kubectl annotate -n tenant-root hr/tenant-root reconcile.fluxcd.io/forceAt=$(date +"%Y-%m-%dT%H:%M:%SZ") --overwrite
Шаг 3: откройте Keycloak
Теперь Keycloak доступен по адресу https://keycloak.example.org (замените example.org на домен вашей инфраструктуры).
Чтобы получить credentials Keycloak для пользователя admin по умолчанию, выполните:
kubectl get secret -o yaml -n cozy-keycloak keycloak-credentials -o go-template='{{ printf "%s\n" (index .data "password" | base64decode) }}'
Переключите realm на
cozy.Создайте пользователя в realm
cozy.Создание пользователя в realm
cozyописано в документации Keycloak.После создания пользователя перейдите к его details в Keycloak admin console и включите toggle “Verified email”. Это нужно для корректной работы OIDC authentication.
Добавьте пользователя в группу
cozystack-cluster-admin.Теперь вы сможете войти в dashboard с OIDC credentials.
Если dashboard все еще запрашивает token вместо login/password, вручную выполните reconcile:
kubectl annotate -n cozy-dashboard hr/dashboard reconcile.fluxcd.io/forceAt=$(date +"%Y-%m-%dT%H:%M:%SZ") --overwrite
Шаг 4: получите kubeconfig
Чтобы получить доступ к кластеру через Dashboard, скачайте kubeconfig: выберите развернутый tenant и скопируйте secret из resource map.
Этот kubeconfig будет автоматически настроен на использование OIDC authentication и namespace, выделенного tenant.
Установите kubelogin, необходимый для использования kubeconfig с OIDC.
# Homebrew (macOS and Linux)
brew install int128/kubelogin/kubelogin
# Krew (macOS, Linux, Windows and ARM)
kubectl krew install oidc-login
# Chocolatey (Windows)
choco install kubelogin