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

Add docs for configuring custom CA on openshift #838

Merged
merged 3 commits into from
Dec 3, 2024
Merged
Changes from 2 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
32 changes: 32 additions & 0 deletions content/en/docs/Configuration/authentication/openshift.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,3 +36,35 @@ Kiali as a client for the most common use-cases. The `openshift` strategy does h
configuration settings that most people will never need but are available in case you have
a situation where the customization is needed. See the Kiali CR Reference page for the
documentation on those settings.

### Multi-Cluster - Using an internal or self-signed certificate

If you have a multi-cluster Kiali deployment and the OAuth server is configured with an external IdP that uses an internal or self-signed certificate, you can configure Kiali to trust the server's certificate by creating a ConfigMap named `kiali-oauth-cabundle` containing the CA certificate bundle for the server under the `oauth-server-ca.crt` key:

nrfox marked this conversation as resolved.
Show resolved Hide resolved
```yaml
apiVersion: v1
kind: ConfigMap
metadata:
name: kiali-oauth-cabundle
namespace: istio-system # This is Kiali's install namespace
data:
oauth-server-ca.crt: <PEM encoded CA root certificate>
```

After restarting the Kiali pod, Kiali will trust this root certificate for all HTTPS requests related to OAuth authentication. If you have multiple different CAs, for different clusters, include each as a separate block in the bundle.

#### Insecure setting

{{% alert color="warning" %}}
You should only use this setting for testing and not in a production environment.
{{% /alert %}}

You can disable certificate validation between Kiali and the remote OAuth server(s) by setting `insecure_skip_verify_tls` to `true` in
the Kiali CR:

```yaml
spec:
auth:
openshift:
insecure_skip_verify_tls: true
```