Merge pull request #34098 from Nirusu/patch-1
Remove section about the localhost port
This commit is contained in:
@@ -23,10 +23,11 @@ following diagram:
|
|||||||
|
|
||||||
## Transport security
|
## Transport security
|
||||||
|
|
||||||
In a typical Kubernetes cluster, the API serves on port 443, protected by TLS.
|
By default, the Kubernetes API server listens on port 6443 on the first non-localhost network interface, protected by TLS. In a typical production Kubernetes cluster, the API serves on port 443. The port can be changed with the `--secure-port`, and the listening IP address with the `--bind-address` flag.
|
||||||
|
|
||||||
The API server presents a certificate. This certificate may be signed using
|
The API server presents a certificate. This certificate may be signed using
|
||||||
a private certificate authority (CA), or based on a public key infrastructure linked
|
a private certificate authority (CA), or based on a public key infrastructure linked
|
||||||
to a generally recognized CA.
|
to a generally recognized CA. The certificate and corresponding private key can be set by using the `--tls-cert-file` and `--tls-private-key-file` flags.
|
||||||
|
|
||||||
If your cluster uses a private certificate authority, you need a copy of that CA
|
If your cluster uses a private certificate authority, you need a copy of that CA
|
||||||
certificate configured into your `~/.kube/config` on the client, so that you can
|
certificate configured into your `~/.kube/config` on the client, so that you can
|
||||||
@@ -137,34 +138,6 @@ The cluster audits the activities generated by users, by applications that use t
|
|||||||
|
|
||||||
For more information, see [Auditing](/docs/tasks/debug/debug-cluster/audit/).
|
For more information, see [Auditing](/docs/tasks/debug/debug-cluster/audit/).
|
||||||
|
|
||||||
## API server ports and IPs
|
|
||||||
|
|
||||||
The previous discussion applies to requests sent to the secure port of the API server
|
|
||||||
(the typical case). The API server can actually serve on 2 ports:
|
|
||||||
|
|
||||||
By default, the Kubernetes API server serves HTTP on 2 ports:
|
|
||||||
|
|
||||||
1. `localhost` port:
|
|
||||||
|
|
||||||
- is intended for testing and bootstrap, and for other components of the master node
|
|
||||||
(scheduler, controller-manager) to talk to the API
|
|
||||||
- no TLS
|
|
||||||
- default is port 8080
|
|
||||||
- default IP is localhost, change with `--insecure-bind-address` flag.
|
|
||||||
- request **bypasses** authentication and authorization modules.
|
|
||||||
- request handled by admission control module(s).
|
|
||||||
- protected by need to have host access
|
|
||||||
|
|
||||||
2. “Secure port”:
|
|
||||||
|
|
||||||
- use whenever possible
|
|
||||||
- uses TLS. Set cert with `--tls-cert-file` and key with `--tls-private-key-file` flag.
|
|
||||||
- default is port 6443, change with `--secure-port` flag.
|
|
||||||
- default IP is first non-localhost network interface, change with `--bind-address` flag.
|
|
||||||
- request handled by authentication and authorization modules.
|
|
||||||
- request handled by admission control module(s).
|
|
||||||
- authentication and authorization modules run.
|
|
||||||
|
|
||||||
## {{% heading "whatsnext" %}}
|
## {{% heading "whatsnext" %}}
|
||||||
|
|
||||||
Read more documentation on authentication, authorization and API access control:
|
Read more documentation on authentication, authorization and API access control:
|
||||||
|
|||||||
Reference in New Issue
Block a user