Apply templates and fix dead links under "/docs/reference/access-authn-authz/" (#9202)

* fix double bullets in TOC and apply an tempalte.

* fix url prefix

* anchor link with lower strings

* fix another url prefix
This commit is contained in:
makocchi
2018-06-23 03:26:06 +09:00
committed by k8s-ci-robot
parent 91396cb44d
commit 203391835d
9 changed files with 181 additions and 125 deletions
@@ -6,11 +6,15 @@ reviewers:
- deads2k
- liggitt
title: Authenticating
content_template: templates/concept
weight: 10
---
{{< toc >}}
{{% capture overview %}}
This page provides an overview of authenticating.
{{% /capture %}}
{{% capture body %}}
## Users in Kubernetes
All Kubernetes clusters have two categories of users: service accounts managed
@@ -90,12 +94,15 @@ The API server reads bearer tokens from a file when given the `--token-auth-file
changed without restarting API server.
The token file is a csv file with a minimum of 3 columns: token, user name, user uid,
followed by optional group names. Note, if you have more than one group the column must be
double quoted e.g.
followed by optional group names.
{{< note >}}
**Note:** If you have more than one group the column must be double quoted e.g.
```conf
token,user,uid,"group1,group2,group3"
```
{{< /note >}}
#### Putting a Bearer Token in a Request
@@ -182,9 +189,11 @@ mounted into pods at well-known locations, and allow in-cluster processes to
talk to the API server. Accounts may be explicitly associated with pods using the
`serviceAccountName` field of a `PodSpec`.
NOTE: `serviceAccountName` is usually omitted because this is done automatically.
{{< note >}}
**Note:** `serviceAccountName` is usually omitted because this is done automatically.
{{< /note >}}
```
```yaml
apiVersion: apps/v1 # this apiVersion is relevant as of Kubernetes 1.9
kind: Deployment
metadata:
@@ -236,7 +245,9 @@ metadata:
type: kubernetes.io/service-account-token
```
Note: values are base64 encoded because secrets are always base64 encoded.
{{< note >}}
**Note:** Values are base64 encoded because secrets are always base64 encoded.
{{< /note >}}
The signed JWT can be used as a bearer token to authenticate as the given service
account. See [above](#putting-a-bearer-token-in-a-request) for how the token is included
@@ -393,8 +404,8 @@ Webhook authentication is a hook for verifying bearer tokens.
* `--authentication-token-webhook-cache-ttl` how long to cache authentication decisions. Defaults to two minutes.
The configuration file uses the [kubeconfig](/docs/concepts/cluster-administration/authenticate-across-clusters-kubeconfig/)
file format. Within the file "users" refers to the API server webhook and
"clusters" refers to the remote service. An example would be:
file format. Within the file `users` refers to the API server webhook and
`clusters` refers to the remote service. An example would be:
```yaml
# clusters refers to the remote service.
@@ -506,7 +517,7 @@ For example, with this configuration:
this request:
```
```http
GET / HTTP/1.1
X-Remote-User: fido
X-Remote-Group: dogs
@@ -694,7 +705,7 @@ To authenticate against the API:
### Configuration
Credential plugins are configured through [`kubectl` config files](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/)
Credential plugins are configured through [kubectl config files](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/)
as part of the user fields.
```yaml
@@ -818,3 +829,4 @@ is triggered each time the tool using the plugin is invoked.
}
}
```
{{% /capture %}}