<p>
v1beta1 包是 v1beta1 版本的 API。 </p>
资源类型 {#resource-types}
- AuthenticationConfiguration
- AuthorizationConfiguration
- EgressSelectorConfiguration
- TracingConfiguration
TracingConfiguration {#TracingConfiguration}
出现在:
<p>
TracingConfiguration 为 OpenTelemetry 跟踪客户端提供版本化的配置。 </p>
<table class="table">
<thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>endpoint</code><br/> <code>string</code> </td> <td> <p>
<code>endpoint</code> 是采集器的端点,此组件将向其报告跟踪信息。连接不安全,目前不支持 TLS。 推荐不设置,端点为 otlp grpc 默认值 localhost:4317。 </p> </td> </tr> <tr><td><code>samplingRatePerMillion</code><br/> <code>int32</code> </td> <td> <p>
<code>samplingRatePerMillion</code> 是每百万 span 中采集的样本数。 推荐不设置。如果不设置,采集器将继承其父级 span 的采样率,否则不进行采样。 </p> </td> </tr> </tbody> </table>
AuthenticationConfiguration {#apiserver-k8s-io-v1beta1-AuthenticationConfiguration}
<p>
AuthenticationConfiguration 为身份认证提供版本化的配置。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>apiVersion</code><br/>string</td><td><code>apiserver.k8s.io/v1beta1</code></td></tr> <tr><td><code>kind</code><br/>string</td><td><code>AuthenticationConfiguration</code></td></tr>
<tr><td><code>jwt</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-JWTAuthenticator"><code>[]JWTAuthenticator</code></a> </td> <td> <p>
<code>jwt</code> 是一个身份认证器列表,用于对使用符合 JWT 的令牌的 Kubernetes 用户进行身份认证。 身份认证器将尝试解析原始 ID 令牌,验证其是否由配置的发放者签名。用于验证签名的公钥是通过 OIDC 发现从颁发者的公开端点获取的。对于传入的令牌,将按照此列表中指定的顺序尝试每个 JWT 身份认证器。但是请注意,其他身份认证器可能会在 JWT 身份认证器之前或之后运行。JWT 身份认证器相对于其他身份认证器的具体位置在不同版本中既未定义也不稳定。由于每个 JWT 身份认证器必须具有唯一的颁发者 URL,因此最多只有一个 JWT 身份认证器会尝试基于密码学方法对令牌进行合法性检查。 </p> <p>
最小有效 JWT 负载必须包含以下申领: <pre> { "iss": "https://issuer.example.com", "aud": ["audience"], "exp": 1234567890, "<username claim>": "username" } </pre> </p> </td> </tr> <tr><td><code>anonymous</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-AnonymousAuthConfig"><code>AnonymousAuthConfig</code></a> </td> <td> <p>
如果设置了此字段,则不得设置 <code>--anonymous-auth</code>。 </p> </td> </tr> </tbody> </table>
AuthorizationConfiguration {#apiserver-k8s-io-v1beta1-AuthorizationConfiguration}
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>apiVersion</code><br/>string</td><td><code>apiserver.k8s.io/v1beta1</code></td></tr> <tr><td><code>kind</code><br/>string</td><td><code>AuthorizationConfiguration</code></td></tr>
<tr><td><code>authorizers</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-AuthorizerConfiguration"><code>[]AuthorizerConfiguration</code></a> </td> <td> <p>
<code>authorizers</code> 是一个有序的鉴权器列表,用于对请求进行鉴权。 这类似于 kube-apiserver <code>--authorization-modes</code> 标志。 此列表不能为空。 </p> </td> </tr> </tbody> </table>
EgressSelectorConfiguration {#apiserver-k8s-io-v1beta1-EgressSelectorConfiguration}
<p>
EgressSelectorConfiguration 为出站流量选择器客户端(Egress Selector Client)提供版本化的配置选项。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>apiVersion</code><br/>string</td><td><code>apiserver.k8s.io/v1beta1</code></td></tr> <tr><td><code>kind</code><br/>string</td><td><code>EgressSelectorConfiguration</code></td></tr>
<tr><td><code>egressSelections</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-EgressSelection"><code>[]EgressSelection</code></a> </td> <td> <p>
connectionServices 包含一组出站流量选择器客户端(Egress Selector Client)配置选项。 </p> </td> </tr> </tbody> </table>
TracingConfiguration {#apiserver-k8s-io-v1beta1-TracingConfiguration}
<p>
TracingConfiguration 为跟踪客户端提供版本化的配置信息。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>apiVersion</code><br/>string</td><td><code>apiserver.k8s.io/v1beta1</code></td></tr> <tr><td><code>kind</code><br/>string</td><td><code>TracingConfiguration</code></td></tr>
<tr><td><code>TracingConfiguration</code> <B>[必需]</B><br/> <a href="#TracingConfiguration"><code>TracingConfiguration</code></a> </td> <td> <p>
嵌入组件配置中的跟踪配置结构体。 </p> </td> </tr> </tbody> </table>
AnonymousAuthCondition {#apiserver-k8s-io-v1beta1-AnonymousAuthCondition}
出现在:
<p>
AnonymousAuthCondition 描述了应启用匿名身份认证的条件。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>path</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
启用匿名身份认证的路径。 </p> </td> </tr> </tbody> </table>
AnonymousAuthConfig {#apiserver-k8s-io-v1beta1-AnonymousAuthConfig}
出现在:
<p>
AnonymousAuthConfig 为匿名身份认证器提供配置信息。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>enabled</code> <B>[必需]</B><br/> <code>bool</code> </td> <td> </td> </tr> <tr><td><code>conditions</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-AnonymousAuthCondition"><code>[]AnonymousAuthCondition</code></a> </td> <td> <p>
如果设置,只有在请求满足其中一个条件时才允许匿名身份认证。 </p> </td> </tr> </tbody> </table>
AudienceMatchPolicyType {#apiserver-k8s-io-v1beta1-AudienceMatchPolicyType}
(string 类型的别名)
出现在:
<p>
AudienceMatchPolicyType 是 issuer.audienceMatchPolicy 合法值的集合 </p>
AuthorizerConfiguration {#apiserver-k8s-io-v1beta1-AuthorizerConfiguration}
出现在:
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>type</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
<code>type</code> 指的是鉴权器的类型。 通用 API 服务器支持 "Webhook"。 其他 API 服务器可能支持其他鉴权器类型,如 Node、RBAC、ABAC 等。 </p> </td> </tr> <tr><td><code>name</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
<code>name</code> 用于描述 webhook 的名称。此字段专为监控机制中的指标提供。 注意:name 值必须是 DNS1123 标签,如 <code>myauthorizername</code>, 或子域名,如 <code>myauthorizer.example.domain</code>。必需,没有默认值。 </p> </td> </tr> <tr><td><code>webhook</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-WebhookConfiguration"><code>WebhookConfiguration</code></a> </td> <td> <p>
<code>webhook</code> 定义 Webhook 鉴权器的配置。 当 type=Webhook 时必须定义。当 type!=Webhook 时不得定义。 </p> </td> </tr> </tbody> </table>
ClaimMappings {#apiserver-k8s-io-v1beta1-ClaimMappings}
出现在:
<p>
ClaimMappings 为申领映射提供配置信息 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>username</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-PrefixedClaimOrExpression"><code>PrefixedClaimOrExpression</code></a> </td> <td> <p>
<code>username</code> 表示用户名属性的一个选项。申领的值必须是单一字符串。 与 <code>--oidc-username-claim</code> 和 <code>--oidc-username-prefix</code> 标志相同。 如果设置了 <code>username.expression</code>,则该表达式必须生成一个字符串值。 如果 <code>username.expression</code> 使用 'claims.email',则必须在 <code>username.expression</code> 或 <code>extra[].valueExpression</code> 或 <code>claimValidationRules[].expression</code> 中使用 'claims.email_verified'。 这里有一个申领验证规则表达式的示例,当 username.claim 设置为 'email' 时与自动应用的验证所匹配: 'claims.?email_verified.orValue(true) == true'。 通过显式地将值与 true 进行比较,我们可以看到类型检查的结果将是一个布尔值, 并确保在运行时捕获到非布尔值的 email_verified 申领。 </p> <p>
在基于标志的方法中,--oidc-username-claim 和 --oidc-username-prefix 是可选的。如果未设置 --oidc-username-claim,默认值为 "sub"。 对于身份认证配置,申领或前缀都没有默认值。申领和前缀必须显式设置。 对于申领,如果在传统标志方法中未设置 --oidc-username-claim, 请在身份认证配置中配置 username.claim="sub"。 对于前缀: (1) --oidc-username-prefix="-", 未添加前缀到用户名。要实现相同的行为,请在身份认证配置中设置 username.prefix="" (2) --oidc-username-prefix="" 并且 --oidc-username-claim != "email", 前缀为 "<--oidc-issuer-url 的值>#"。要实现相同的行为,请在身份认证配置中设置 username.prefix="<issuer.url 的值>#"。 (3) --oidc-username-prefix="<value>"。要实现相同的行为,请在身份认证配置中设置 username.prefix="<value>"。 </p> </td> </tr> <tr><td><code>groups</code><br/> <a href="#apiserver-k8s-io-v1beta1-PrefixedClaimOrExpression"><code>PrefixedClaimOrExpression</code></a> </td> <td> <p>
groups 表示 groups 属性的一个选项。 其中 claim 字段的值必须是字符串或字符串数组。 如果设置了 groups.claim,则必须指定 prefix 字段(可以是空字符串)。 如果设置了 groups.expression,则该表达式必须生成一个字符串或字符串数组值。 ""、[] 和 null 值被视为不存在组映射。 </p> </td> </tr> <tr><td><code>uid</code><br/> <a href="#apiserver-k8s-io-v1beta1-ClaimOrExpression"><code>ClaimOrExpression</code></a> </td> <td> <p>
uid 表示 uid 属性的一个选项。 其中的 claim 字段必须是一个字符串。 如果设置了 uid.expression,则该表达式必须生成一个字符串值。 </p> </td> </tr> <tr><td><code>extra</code><br/> <a href="#apiserver-k8s-io-v1beta1-ExtraMapping"><code>[]ExtraMapping</code></a> </td> <td> <p>
extra 表示 extra 属性的一个选项。 expression 必须生成一个字符串或字符串数组值。 如果值为空,则不会存在 extra 映射。 </p> <p>
硬编码的额外 key/value <pre>
- key: "foo" valueExpression: "'bar'" </pre> 这将导致一个额外的属性 - foo: ["bar"]<br/>
硬编码 key,value 从申领的值复制 <pre>
- key: "foo" valueExpression: "claims.some_claim" </pre> 结果会是一个 extra 属性 - foo: [some_claim 的值]
硬编码 key,value 从申领的值派生<br/> <pre>
- key: "admin" valueExpression: '(has(claims.is_admin) && claims.is_admin) ? "true":""' </pre> 这将导致: </p> <ul> <li>
如果 is_admin 申领存在且为 true,则添加 extra 属性 - admin: ["true"] </li> <li>
如果 is_admin 申领存在且为 false 或 is_admin 申领不存在,则不会添加 extra 属性 </li> </ul> </td> </tr> </tbody> </table>
ClaimOrExpression {#apiserver-k8s-io-v1beta1-ClaimOrExpression}
出现在:
<p>
ClaimOrExpression 为单个申领或表达式提供配置信息。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>claim</code><br/> <code>string</code> </td> <td> <p>
<code>claim</code> 是要使用的 JWT 申领。 <code>claim</code> 或 <code>expression</code> 必须设置一个。 与 <code>expression</code> 互斥。 </p> </td> </tr> <tr><td><code>expression</code><br/> <code>string</code> </td> <td>
<p>expression 表示将由 CEL 求值的表达式。</p> <p>CEL 表达式可以访问令牌申领的内容,这些内容被组织成 CEL 变量:</p> <ul>
<li>'claims' 是申领名称到申领值的映射。 例如,一个名为 'sub' 的变量可以通过 'claims.sub' 访问。 嵌套的申领可以使用点表示法访问,例如 'claims.foo.bar'。</li> </ul>
<p>关于 CEL 的文档:<a href="https://kubernetes.io/zh-cn/docs/reference/using-api/cel/">https://kubernetes.io/zh-cn/docs/reference/using-api/cel/</a></p> <p>与 claim 互斥。</p> </td> </tr> </tbody> </table>
ClaimValidationRule {#apiserver-k8s-io-v1beta1-ClaimValidationRule}
出现在:
<p>
ClaimValidationRule 为单个申领验证规则提供配置信息。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>claim</code><br/> <code>string</code> </td> <td> <p>
claim 是所需要的申领的名称。 与 <code>--oidc-required-claim</code> 标志相同。 仅支持用字符串申领键。 与 <code>expression</code> 和 <code>message</code> 互斥。 </p> </td> </tr> <tr><td><code>requiredValue</code><br/> <code>string</code> </td> <td> <p>
requiredValue 是申领中必须包含的值。 与 --oidc-required-claim 标志相同。仅支持用字符串申领值。 如果设置了 claim 而未设置 requiredValue,则 claim 必须存在且值必须设置为空字符串。 与 expression 和 message 互斥。 </p> </td> </tr> <tr><td><code>expression</code><br/> <code>string</code> </td> <td>
<p>expression 表示将由 CEL 求值的表达式。必须生成一个布尔值。</p> <p>CEL 表达式可以访问令牌申领的内容,这些内容被组织成 CEL 变量:</p> <ul>
<li>'claims' 是申领名称到申领值的映射。 例如,一个名为 'sub' 的变量可以通过 'claims.sub' 访问。 嵌套的申领可以使用点表示法访问,例如 'claims.foo.bar'。 必须返回 true,才有可能通过检查。</li> </ul> <p>关于 CEL 的文档:<a href="https://kubernetes.io/zh-cn/docs/reference/using-api/cel/">https://kubernetes.io/zh-cn/docs/reference/using-api/cel/</a></p> <p>与 claim 和 requiredValue 互斥。</p> </td> </tr> <tr><td><code>message</code><br/> <code>string</code> </td> <td> <p>
message 自定义当 expression 返回 false 时的错误消息。 message 是一个字符串文字。 与 claim 和 requiredValue 互斥。 </p> </td> </tr> </tbody> </table>
Connection {#apiserver-k8s-io-v1beta1-Connection}
出现在:
<p>
Connection 提供某个出站流量选择器客户端(Egress Selector Client)的配置信息。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>proxyProtocol</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-ProtocolType"><code>ProtocolType</code></a> </td> <td> <p>
proxyProtocol 是客户端连接到 konnectivity 服务器所使用的协议。 </p> </td> </tr> <tr><td><code>transport</code><br/> <a href="#apiserver-k8s-io-v1beta1-Transport"><code>Transport</code></a> </td> <td> <p>
transport 定义的是传输层的配置。我们使用这个配置来联系 konnectivity 服务器。 当 proxyProtocol 是 HTTPConnect 或 GRPC 时需要设置此字段。 </p> </td> </tr> </tbody> </table>
EgressSelection {#apiserver-k8s-io-v1beta1-EgressSelection}
出现在:
<p>
EgressSelection 为某个出站流量选择器客户端(Egress Selector Client)提供配置信息。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>name</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
name 是出站流量选择(egress selection)的名称。当前支持的取值有 "controlplane", "master","etcd" 和 "cluster"。 "master" 出站流量选择(egress selection)已被弃用,推荐使用 "controlplane"。 </p> </td> </tr> <tr><td><code>connection</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-Connection"><code>Connection</code></a> </td> <td> <p>
connection 是用来配置出站流量选择(egress selection)的确切信息。 </p> </td> </tr> </tbody> </table>
EgressSelectorType {#apiserver-k8s-io-v1beta1-EgressSelectorType}
(别名为 string)
出现在:
<p>
EgressSelectorType 是一个指示符,表明应使用哪种出口选择器来发送流量。 </p>
ExtraMapping {#apiserver-k8s-io-v1beta1-ExtraMapping}
出现在:
<p>ExtraMapping 为单个 extra 映射提供配置信息。</p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>key</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
key 是用作 extra 属性键的字符串。 key 必须是域前缀路径(例如 example.org/foo)。第一个 "/" 之前的所有字符必须是符合 RFC 1123 定义的有效子域名。第一个 "/" 之后的所有字符必须是符合 RFC 3986 定义的有效 HTTP 路径字符。 key 必须是小写。 必须是唯一的。 </p> </td> </tr> <tr><td><code>valueExpression</code> <B>[必需]</B><br/> <code>string</code> </td> <td>
<p>valueExpression 是一个 CEL 表达式,用于提取 extra 中的属性值。 valueExpression 必须生成一个字符串或字符串数组值。 ""、[] 和 null 值被视为不存在 extra 映射。 字符串数组中包含的空字符串值将被过滤掉。</p> <p>CEL 表达式可以访问令牌申领的内容,这些内容被组织成 CEL 变量:</p> <ul> <li>'claims' 是申领名称到申领值的映射。 例如,一个名为 'sub' 的变量可以通过 'claims.sub' 访问。 嵌套的申领可以使用点表示法访问,例如 'claims.foo.bar'。</li> </ul> <p>关于 CEL 的文档:<a href="https://kubernetes.io/zh-cn/docs/reference/using-api/cel/">https://kubernetes.io/zh-cn/docs/reference/using-api/cel/</a></p> </td> </tr> </tbody> </table>
Issuer {#apiserver-k8s-io-v1beta1-Issuer}
出现在:
<p>Issuer 为外部提供者的特定设置提供配置。</p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>url</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
url 指向颁发者 URL,格式为 https://url 或 https://url/path。 此 URL 必须与所提供的 JWT 中的 "iss" 申领以及从发现中返回的颁发者匹配。 与 --oidc-issuer-url 标志的值相同。 除非被 discoveryURL 覆盖,否则发现信息将从 "{url}/.well-known/openid-configuration" 获取。 在所有 JWT 身份认证器中必须唯一。 请注意,此网络连接不使用出站流量选择配置。 </p> </td> </tr> <tr><td><code>discoveryURL</code><br/> <code>string</code> </td> <td> <p>
discoveryURL(如果指定)会覆盖用于获取发现信息的 URL,而不是使用 "{url}/.well-known/openid-configuration"。 使用指定的确切值,因此如果需要,必须在 discoveryURL 中包含 "/.well-known/openid-configuration"。 </p> <p>
所获取的发现信息中的 "issuer" 字段必须与 AuthenticationConfiguration 中的 "issuer.url" 字段匹配,并将用于检验所提供的 JWT 中的 "iss" 申领。 这适用于 well-known 和 jwks 端点托管在与颁发者不同的位置(例如在集群中本地托管)的场景。 </p> <p>
示例: 发现 URL 是通过 Kubernetes 在命名空间 'oidc-namespace' 中的服务 'oidc' 公布的, 而访问 '/.well-known/openid-configuration' 可以获得发现信息。 discoveryURL: "https://oidc.oidc-namespace/.well-known/openid-configuration" certificateAuthority 用于验证 TLS 连接,叶证书上的主机名必须设置为 'oidc.oidc-namespace'。 </p>
<p> <pre><code> curl https://oidc.oidc-namespace/.well-known/openid-configuration (discoveryURL 字段) { issuer: "https://oidc.example.com" (url 字段) } </code> </pre> </p> <p>discoveryURL 必须与 url 不同。 在所有 JWT 身份认证器中必须唯一。 请注意,此网络连接不使用出站流量选择配置。</p> </td> </tr> <tr><td><code>certificateAuthority</code><br/> <code>string</code> </td> <td> <p>
certificateAuthority 包含 PEM 编码的证书颁发机构证书, 用于在获取发现信息时验证连接。 如果未设置,则使用系统验证器。 与 --oidc-ca-file 标志引用的文件内容相同。 </p> </td> </tr> <tr><td><code>audiences</code> <B>[必需]</B><br/> <code>[]string</code> </td> <td> <p>
audiences 是 JWT 必须签发给的可接受受众集。 所提供的 JWT 中的 "aud" 申领必须至少与其中一个条目匹配。 与 --oidc-client-id 标志的值相同(尽管此字段支持数组)。 必须为非空。 </p> </td> </tr> <tr><td><code>audienceMatchPolicy</code><br/> <a href="#apiserver-k8s-io-v1beta1-AudienceMatchPolicyType"><code>AudienceMatchPolicyType</code></a> </td> <td> <p>
audienceMatchPolicy 定义了如何使用 "audiences" 字段来匹配所提供的 JWT 中的 "aud" 申领。 允许的值有: </p> <ol>
<li>"MatchAny" 当指定多个受众时</li> <li>空(或未设置)或 "MatchAny" (仅指定单个受众时)</li> </ol> <ul> <li>
<p>MatchAny:所提供的 JWT 中的 "aud" 申领必须至少与 "audiences" 字段中的一个条目匹配。 例如,如果 "audiences" 是 ["foo", "bar"],则所提供的 JWT 中的 "aud" 申领必须包含 "foo" 或 "bar"(也可以同时包含两者)。 </p> </li> <li>
<p>"":当 "audiences" 字段中指定单个受众时,匹配策略可以为空(或未设置)。 所提供的 JWT 中的 "aud" 申领必须包含该单个受众(并且可以包含其他受众)。</p> </li> </ul> <p>
对于更精细的受众验证,请使用 claimValidationRules。 示例:claimValidationRule[].expression: 'sets.equivalent(claims.aud, ["bar", "foo", "baz"])' 以要求精确匹配。 </p> </td> </tr> <tr><td><code>egressSelectorType</code><br/> <a href="#apiserver-k8s-io-v1beta1-EgressSelectorType"><code>EgressSelectorType</code></a> </td> <td> <p>
<code>egressSelectorType</code> 是一个指示符, 表明应使用哪种出口选择器来发送与此颁发者相关的所有流量(发现、JWKS、分布式申领等)。 如果未指定,则不使用自定义拨号器。当指定时,有效选项是 "controlplane" 和 "cluster"。 这些对应于 <code>--egress-selector-config-file</code> 中的关联值。 </p> <ul> <li> <p>
controlplane: 用于前往控制平面的流量。 </p> </li> <li> <p>
cluster:用于指向由 Kubernetes 管理的系统的流量。 </p> </li> </ul> </td> </tr> </tbody> </table>
JWTAuthenticator {#apiserver-k8s-io-v1beta1-JWTAuthenticator}
出现在:
<p>
JWTAuthenticator 为单个 JWT 身份认证器提供配置信息。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>issuer</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-Issuer"><code>Issuer</code></a> </td> <td> <p>
issuer 包含基本的 OIDC 提供者连接选项。 </p> </td> </tr> <tr><td><code>claimValidationRules</code><br/> <a href="#apiserver-k8s-io-v1beta1-ClaimValidationRule"><code>[]ClaimValidationRule</code></a> </td> <td> <p>
claimValidationRules 是用于验证令牌申领以认证用户的规则。 </p> </td> </tr> <tr><td><code>claimMappings</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-ClaimMappings"><code>ClaimMappings</code></a> </td> <td> <p>
claimMappings 指向要视为用户属性的令牌申领。 </p> </td> </tr> <tr><td><code>userValidationRules</code><br/> <a href="#apiserver-k8s-io-v1beta1-UserValidationRule"><code>[]UserValidationRule</code></a> </td> <td> <p>
userValidationRules 是在完成身份认证之前应用于最终用户的规则。 这些规则允许将不变量应用于传入的身份,例如禁止使用 Kubernetes 组件常用的 <code>system:</code> 前缀。 验证规则在逻辑上是 AND 关系,必须全部返回 true 才能通过验证。 </p> </td> </tr> </tbody> </table>
PrefixedClaimOrExpression {#apiserver-k8s-io-v1beta1-PrefixedClaimOrExpression}
出现在:
<p>
PrefixedClaimOrExpression 为单个带前缀的申领或表达式提供配置。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>claim</code><br/> <code>string</code> </td> <td> <p>
claim 是要使用的 JWT 申领。与 expression 互斥。 </p> </td> </tr> <tr><td><code>prefix</code><br/> <code>string</code> </td> <td> <p>
prefix 是添加到申领值前面的前缀,以防止与现有名称冲突。 如果设置了 claim,则需要设置 prefix,并且可以是空字符串。 与 expression 互斥。 </p> </td> </tr> <tr><td><code>expression</code><br/> <code>string</code> </td> <td>
<p>expression 表示将由 CEL 评估的表达式。</p> <p>CEL 表达式可以访问令牌申领的内容,这些内容被组织成 CEL 变量:</p> <ul> <li>'claims' 是申领名称到申领值的映射。 例如,一个名为 'sub' 的变量可以通过 'claims.sub' 访问。 嵌套的申领可以使用点表示法访问,例如 'claims.foo.bar'。</li> </ul> <p>关于 CEL 的文档:<a href="https://kubernetes.io/zh-cn/docs/reference/using-api/cel/">https://kubernetes.io/zh-cn/docs/reference/using-api/cel/</a></p> <p>与 claim 和 prefix 互斥。</p> </td> </tr> </tbody> </table>
ProtocolType {#apiserver-k8s-io-v1beta1-ProtocolType}
(string 类型的别名)
出现在:
<p>
ProtocolType 是 connection.protocolType 的合法值集合。 </p>
TCPTransport {#apiserver-k8s-io-v1beta1-TCPTransport}
出现在:
<p>
TCPTransport 提供使用 TCP 连接 konnectivity 服务器时需要的信息。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>url</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
url 是要连接的 konnectivity 服务器的位置。例如 "https://127.0.0.1:8131"。 </p> </td> </tr> <tr><td><code>tlsConfig</code><br/> <a href="#apiserver-k8s-io-v1beta1-TLSConfig"><code>TLSConfig</code></a> </td> <td> <p>
tlsConfig 是使用 TLS 来连接 konnectivity 服务器时需要的信息。 </p> </td> </tr> </tbody> </table>
TLSConfig {#apiserver-k8s-io-v1beta1-TLSConfig}
出现在:
<p>
TLSConfig 为连接 konnectivity 服务器提供身份认证信息。仅用于 TCPTransport。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>caBundle</code><br/> <code>string</code> </td> <td> <p>
caBundle 是指向用来确定与 konnectivity 服务器间信任关系的 CA 证书包的文件位置。 如果 TCPTransport.URL 前缀为 "http://" 时必须不设置,或者设置为空。 如果 TCPTransport.URL 前缀为 "https://" 并且此字段未设置,则默认使用系统的信任根。 </p> </td> </tr> <tr><td><code>clientKey</code><br/> <code>string</code> </td> <td> <p>
clientKey 是与 konnectivity 服务器进行 mTLS 握手时使用的客户端秘钥文件位置。 如果 TCPTransport.URL 前缀为 http://,必须不指定或者为空; 如果 TCPTransport.URL 前缀为 https://,必须设置。 </p> </td> </tr> <tr><td><code>clientCert</code><br/> <code>string</code> </td> <td> <p>
<code>clientCert</code> 是与 konnectivity 服务器进行 mTLS 握手时使用的客户端证书文件位置。 如果 TCPTransport.URL 前缀为 http://,必须不指定或者为空; 如果 TCPTransport.URL 前缀为 https://,必须设置。 </p> </td> </tr> <tr><td><code>tlsServerName</code><br/> <code>string</code> </td> <td> <p>
<code>tlsServerName</code> 用于校验服务器证书。如果 <code>tlsServerName</code> 为空,则使用与服务器联系的主机名。 </p> </td> </tr> </tbody> </table>
Transport {#apiserver-k8s-io-v1beta1-Transport}
出现在:
<p>
Transport 定义联系 konnectivity 服务器时要使用的传输层配置。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>tcp</code><br/> <a href="#apiserver-k8s-io-v1beta1-TCPTransport"><code>TCPTransport</code></a> </td> <td> <p>
tcp 包含通过 TCP 与 konnectivity 服务器通信时使用的 TCP 配置。 目前使用 TCP 传输时不支持 GRPC 的 proxyProtocol。 tcp 和 uds 二者至少设置一个。 </p> </td> </tr> <tr><td><code>uds</code><br/> <a href="#apiserver-k8s-io-v1beta1-UDSTransport"><code>UDSTransport</code></a> </td> <td> <p>
uds 包含通过 UDS 与 konnectivity 服务器通信时使用的 UDS 配置。 tcp 和 uds 二者至少设置一个。 </p> </td> </tr> </tbody> </table>
UDSTransport {#apiserver-k8s-io-v1beta1-UDSTransport}
出现在:
<p>
UDSTransport 设置通过 UDS 连接 konnectivity 服务器时需要的信息。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>udsName</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
udsName 是与 konnectivity 服务器连接时使用的 UNIX 域套接字名称。 字段取值不要求包含 unix:// 前缀。 (例如:/etc/srv/kubernetes/konnectivity-server/konnectivity-server.socket) </p> </td> </tr> </tbody> </table>
UserValidationRule {#apiserver-k8s-io-v1beta1-UserValidationRule}
出现在:
<p>
UserValidationRule 为单个用户信息验证规则提供配置信息。 </p>
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>expression</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
expression 表示将由 CEL 求值的表达式。 验证通过时必须返回 true。 </p>
<p>CEL 表达式可以访问 UserInfo 的内容,这些内容被组织成 CEL 变量:</p> <ul> <li>'user' - authentication.k8s.io/v1,Kind=UserInfo 对象 关于 UserInfo 的定义,参阅 https://github.com/kubernetes/api/blob/release-1.28/authentication/v1/types.go#L105-L122。 API 文档:https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.28/#userinfo-v1-authentication-k8s-io</li> </ul> <p>关于 CEL 的文档:https://kubernetes.io/zh-cn/docs/reference/using-api/cel/</p> </td> </tr> <tr><td><code>message</code><br/> <code>string</code> </td> <td> <p>
message 自定义当规则返回 false 时的错误消息。 message 是一个字符串文字。 </p> </td> </tr> </tbody> </table>
WebhookConfiguration {#apiserver-k8s-io-v1beta1-WebhookConfiguration}
出现在:
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>authorizedTTL</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td> <p>
对来自 Webhook 鉴权组件的 “authorized” 响应的缓存时长。 与设置 <code>--authorization-webhook-cache-authorized-ttl</code> 标志相同。 默认值:5m0s。 </p> </td> </tr> <tr><td><code>cacheAuthorizedRequests</code><br/> <code>bool</code> </td> <td> <p>
<code>cacheAuthorizedRequests</code> 指定是否应当缓存已授权的请求。 如果设置为 true,缓存决策的 TTL 可以通过 <code>authorizedTTL</code> 字段配置。 默认值:true </p> </td> </tr> <tr><td><code>unauthorizedTTL</code> <B>[Required]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td> <p>
对来自 Webhook 鉴权组件的 “unauthorized” 响应的缓存时长。 与设置 <code>--authorization-webhook-cache-unauthorized-ttl</code> 标志相同。 默认值:30s </p>
</td> </tr> <tr><td><code>cacheUnauthorizedRequests</code><br/> <code>bool</code> </td> <td> <p>
<code>cacheUnauthorizedRequests</code> 指定是否应当缓存未授权的请求。 如果设置为 true,缓存决策的 TTL 可以通过 <code>unauthorizedTTL</code> 字段配置。 默认值:true </p> </td> </tr> <tr><td><code>timeout</code> <B>[必需]</B><br/> <a href="https://pkg.go.dev/k8s.io/apimachinery/pkg/apis/meta/v1#Duration"><code>meta/v1.Duration</code></a> </td> <td> <p>
Webhook 请求超时时间。 允许的最大时间为 30 秒。 必需,没有默认值。 </p> </td> </tr> <tr><td><code>subjectAccessReviewVersion</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
要发送到 Webhook 并期望从 Webhook 获得的 authorization.k8s.io SubjectAccessReview 的 API 版本。 与设置 <code>--authorization-webhook-version</code> 标志相同。 有效值:v1beta1、v1。 必需,无默认值 </p> </td> </tr> <tr><td><code>matchConditionSubjectAccessReviewVersion</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
matchConditionSubjectAccessReviewVersion 指定对 CEL 表达式求值时使用的 SubjectAccessReview 版本。 有效值:v1。必需,无默认值。 </p> </td> </tr> <tr><td><code>failurePolicy</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
控制当 Webhook 请求无法完成或返回格式错误的响应或计算 matchConditions 出现错误时的鉴权决定。 有效值: </p> <ul>
<li>NoOpinion:继续执行后续鉴权组件,看其中是否有组件允许该请求;</li> <li>Deny:拒绝请求而不考虑后续鉴权组件。</li> </ul> 必需,没有默认值。 </td> </tr> <tr><td><code>connectionInfo</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-WebhookConnectionInfo"><code>WebhookConnectionInfo</code></a> </td> <td> <p>
ConnectionInfo 定义 Webhook 如何与服务器通信。 </p> </td> </tr> <tr><td><code>matchConditions</code> <B>[必需]</B><br/> <a href="#apiserver-k8s-io-v1beta1-WebhookMatchCondition"><code>[]WebhookMatchCondition</code></a> </td> <td>
<p>matchConditions 是将请求发送到此 Webhook 必须满足的条件列表。matchConditions 为空列表表示匹配所有请求。 最多允许 64 个匹配条件。</p> <p>精确匹配逻辑如下(按顺序):</p> <ol>
<li>如果至少一个 matchCondition 计算结果为 FALSE,则跳过 Webhook。</li> <li>如果所有 matchConditions 计算结果为 TRUE,则调用 Webhook。</li> <li>如果至少一个 matchCondition 计算结果为错误(但没有一个为 FALSE): <ul> <li>如果 FailurePolicy=Deny,则 Webhook 拒绝请求</li> <li>如果 FailurePolicy=NoOpinion,则忽略错误并跳过 Webhook</li> </ul> </li> </ol> </td> </tr> </tbody> </table>
WebhookConnectionInfo {#apiserver-k8s-io-v1beta1-WebhookConnectionInfo}
出现在:
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>type</code> <B>[必需]</B><br/> <code>string</code> </td> <td>
<p>控制 Webhook 如何与服务器通信。 有效值:</p> <ul> <li>KubeConfigFile:使用 <code>kubeConfigFile</code> 中指定的文件来定位服务器。</li> <li>InClusterConfig:使用集群内配置来调用由 kube-apiserver 托管的 SubjectAccessReview API,kube-apiserver 不允许使用此模式。</li> </ul> </td> </tr> <tr><td><code>kubeConfigFile</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
包含连接信息的 KubeConfig 文件的路径。 如果 connectionInfo.type 是 KubeConfig,则为必需项。 </p> </td> </tr> </tbody> </table>
WebhookMatchCondition {#apiserver-k8s-io-v1beta1-WebhookMatchCondition}
出现在:
<table class="table"> <thead><tr><th width="30%">字段</th><th>描述</th></tr></thead> <tbody>
<tr><td><code>expression</code> <B>[必需]</B><br/> <code>string</code> </td> <td> <p>
expression 表示将由 CEL 求值的表达式。求值结果必须为布尔值。 CEL 表达式可以访问 v1 版本中的 SubjectAccessReview 的内容。 如果请求变量中 subjectAccessReviewVersion 指定的版本是 v1beta1, 在计算 CEL 表达式之前,内容将被转换为 v1 版本。 </p> <ul>
<li>'resourceAttributes' 描述了资源访问请求的信息,对于非资源请求则未设置。例如:<code>has(request.resourceAttributes) && request.resourceAttributes.namespace == 'default'</code>。</li> <li>'nonResourceAttributes' 描述了非资源访问请求的信息,对于资源请求则未设置。例如:<code>has(request.nonResourceAttributes) && request.nonResourceAttributes.path == '/healthz'</code>。</li> <li>'user' 是要测试的用户。例如:<code>request.user == 'alice'</code>。</li> <li>'groups' 是要测试的用户组。例如:<code>('group1' in request.groups)</code>。</li> <li>'extra' 对应于身份验证器中的 <code>user.Info.GetExtra()</code> 方法。</li> <li>'uid' 是关于请求用户的标识信息。例如:<code>request.uid == '1'</code>。</li> </ul> <p>
关于 CEL 文档:https://kubernetes.io/zh-cn/docs/reference/using-api/cel/ </p> </td> </tr> </tbody> </table>
来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。
