第 7 章 keystone
下面的章节包含有关 keystone
服务中的配置选项的信息。
7.1. keystone.conf
本节包含 /etc/keystone/keystone.conf
文件的选项。
7.1.1. DEFAULT
下表概述了 /etc/keystone/keystone.conf
文件中的 [DEFAULT]
组下可用的选项。
.
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
不建议使用 此功能。反之,使用 |
| 整数值 | 连接过期策略的池大小限制 |
| 整数值 | 池中闲置连接的生存时间 |
| 字符串值 | 主题范围的默认交换。可以被 transport_url 选项中指定的交换名称覆盖。 |
| 布尔值 | 如果设置为 true,则日志级别将设为 DEBUG,而不是默认的 INFO 级别。 |
| 列出值 | 以 logger=LEVEL 的形式列出软件包日志级别列表。如果设置了 log_config_append,则忽略这个选项。 |
| 字符串值 |
用于传出通知的默认 |
| 整数值 | 当 executor 为 threading 或 eventle 时,executor 线程池的大小。 |
| 布尔值 | 启用或禁用弃用的严重状态。 |
| 布尔值 | 如果设置为 true,则服务器将返回 HTTP 响应中的信息,以允许未经身份验证的或经过身份验证的用户获取比正常身份验证的更多信息,例如有关身份验证失败的原因的更多详情。这对调试可能很有用,但不安全。 |
`instance_format = [instance: %(uuid)s] ` | 字符串值 | 通过日志消息传递的实例格式。 |
`instance_uuid_format = [instance: %(uuid)s] ` | 字符串值 | 通过日志消息传递的实例 UUID 格式。 |
| 整数值 |
集合中返回的最大实体数。然后,可以通过在适当的部分(如 |
| 字符串值 | 日志配置文件的名称。此文件附加到任何现有日志记录配置文件中。有关日志记录配置文件的详情,请查看 Python 日志记录模块文档。请注意,当使用日志记录配置文件时,会在配置文件中设置所有日志记录配置,并忽略其他日志记录配置选项(例如 log-date-format)。 |
| 字符串值 | 在日志记录中定义 %%(asctime) s 的格式字符串。默认: %(default) s。如果设置了 log_config_append,则忽略这个选项。 |
| 字符串值 | (可选)用于相对 log_file 路径的基础目录。如果设置了 log_config_append,则忽略这个选项。 |
| 字符串值 | (可选)要将日志输出发送到的日志文件名称。如果没有设置默认值,日志记录将进入由 use_stderr 定义的 stderr。如果设置了 log_config_append,则忽略这个选项。 |
| 整数值 | 轮转日志文件前的时间长度。除非 log_rotation_type 设为 "interval",否则此选项会被忽略。 |
| 字符串值 | 轮转间隔类型。调度下一个轮转时使用上次文件更改(或服务启动时的时间)。 |
| 字符串值 | 日志轮转类型。 |
| 字符串值 | 用于带有上下文的日志消息的格式字符串。由 oslo_log.formatters.ContextFormatter 使用 |
| 字符串值 | 当消息的日志记录级别为 DEBUG 时,要附加到日志消息的额外数据。由 oslo_log.formatters.ContextFormatter 使用 |
| 字符串值 | 上下文未定义时用于日志消息的格式字符串。由 oslo_log.formatters.ContextFormatter 使用 |
| 字符串值 | 使用这种格式为每行例外输出加上前缀。由 oslo_log.formatters.ContextFormatter 使用 |
| 字符串值 | 定义 logging_context_format_string 中使用的 %(user_identity) s 格式字符串。由 oslo_log.formatters.ContextFormatter 使用 |
| 整数值 | 轮转日志文件的最大数量。 |
| 整数值 | 日志文件的最大大小(以 MB 为单位)。如果 "log_rotation_type" 没有设置为 "size",则忽略这个选项。 |
| 整数值 | 限制用户和项目 ID/名称的大小。 |
| 整数值 | 项目层次结构的最大深度,不包括层次结构顶部的项目作为域。警告:将其设置为一个大的值可能会对性能造成负面影响。 |
| 整数值 |
与 |
| 字符串值 |
定义 identity 服务事件的通知格式。 |
| 多值 |
您可以通过显式选择不使用来减少通知 keystone 发出的数量。Keystone 不会发出与此列表中表达的模式匹配的通知。值应该采用 |
| URI 值 |
公告给客户端的 Keystone 的基本公共端点 URL (注意:这不会影响 Keystone 侦听连接的方式)。默认为请求的基本主机 URL。例如,如果 keystone 收到对 |
| 布尔值 | 启用或禁用错误事件的发布。 |
| 整数值 | 每个 rate_limit_interval 的最大日志信息数。 |
| 字符串值 | 通过速率限制使用的日志级别名称:CRITICAL、ERROR、INFO、WARNING、DEBUG 或空字符串。不过滤级别大于或等于 rate_limit_except_level 的日志。空字符串表示过滤所有级别。 |
| 整数值 | 日志速率限制的时间间隔、秒数。 |
| 整数值 | RPC 连接池的大小。 |
| 布尔值 | 添加端点以回答 ping 调用。端点名为 oslo_rpc_server_ping |
| 整数值 | 等待来自调用的响应的秒数。 |
| 布尔值 | 如果设置为 true,则对密码操作执行严格的密码长度检查。如果密码超过最大长度,则操作将失败,并显示 HTTP 403 Forbidden 错误。如果设置为 false,则密码会自动截断到最大长度。 |
| 字符串值 | syslog 工具可接收日志行。如果设置了 log_config_append,则忽略这个选项。 |
| 字符串值 | 用于连接到消息传递后端的网络地址和可选用户凭证,采用 URL 格式。预期的格式是: driver://[user:pass@]host:port[,[userN:passN@]hostN:portN]/virtual_host?query 示例:rabbit://rabbitmq:password@127.0.0.1:5672// 有关 URL 中字段的详情,请查看 oslo_messaging.TransportURL 文档 https://docs.openstack.org/oslo.messaging/latest/reference/transport.html |
| 布尔值 | 为日志记录启用 journald。如果在 systemd 环境中运行,您可能需要启用日志支持。这样做将使用日志原生协议,该协议包括日志消息外的结构化元数据。如果设置了 log_config_append,则忽略此选项。 |
| 布尔值 | 使用 JSON 格式进行日志记录。如果设置了 log_config_append,则忽略这个选项。 |
| 布尔值 | 使用 syslog 进行日志记录。现有 syslog 格式为 DEPRECATED,稍后将更改为遵循 RFC5424。如果设置了 log_config_append,则忽略这个选项。 |
| 布尔值 | 日志输出到 Windows 事件日志。 |
| 布尔值 | 将日志输出到标准错误。如果设置了 log_config_append,则忽略这个选项。 |
| 布尔值 | 使用旨在监视文件系统的日志记录处理程序。当移动或删除日志文件时,此处理程序将立即打开具有指定路径的新日志文件。只有在指定了 log_file 选项并使用 Linux 平台时才有意义。如果设置了 log_config_append,则忽略这个选项。 |
7.1.2. application_credential
下表概述了 /etc/keystone/keystone.conf
文件中的 [application_credential]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 | 快速缓存应用程序凭证数据的时间(以秒为单位)。除非启用了全局缓存,否则这无效。 |
| 布尔值 | 为应用程序凭证缓存切换。除非启用了全局缓存,否则这无效。 |
| 字符串值 |
|
| 整数值 | 允许用户创建的最大应用程序凭证数。值 -1 表示无限。如果没有设置限制,用户会被允许创建应用程序凭证,这会导致在 keystone 数据库中滥用 keystone 数据库,或打开 keystone 进入 DoS 攻击。 |
7.1.3. 分配
下表概述了 /etc/keystone/keystone.conf
文件中的 [assignment]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
分配后端驱动程序的入口点(角色分配存储在 |
| 列出值 | 禁止成为含义的角色名称列表。 |
7.1.4. auth
下表概述了 /etc/keystone/keystone.conf
文件中的 [auth]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
|
| 字符串值 |
|
| 字符串值 |
|
| 列出值 |
允许的身份验证方法.注意:如果您目前正在使用联邦,您应该禁用 |
| 字符串值 |
|
| 字符串值 |
|
| 字符串值 |
|
7.1.5. 缓存
下表概述了 /etc/keystone/keystone.conf
文件中的 [cache]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 | 缓存后端模块.对于基于事件线程服务器的或环境,建议使用带有池的 Memcache (oslo_cache.memcache_pool)。对于小于 100 个线程服务器的环境,建议使用 Memcached (dogpile.cache.memcached)或 Redis (dogpile.cache.redis)。带有单一服务器实例测试环境可以使用 dogpile.cache.memory 后端。 |
| 多值 | 提供给 backend 模块的参数。指定每个参数一次这个选项,以传递给 dogpile.cache 后端。示例格式:"<argname>:<value>"。 |
| 字符串值 | 为缓存区域构建配置字典的前缀。除非存在具有相同配置名称的另一个 dogpile.cache 区域,否则不需要更改此设置。 |
| 浮点值 | 尝试将节点重新添加到 HashClient 内部机制中的池前的时间(以秒为单位)。 |
| 布尔值 | 从缓存后端(缓存密钥、get/set/delete/etc 调用)进行额外的调试。只有在您需要使用键/值查看特定的 cache-backend get/set/delete 调用时,这才有用。通常,这应该设为 false。 |
| 布尔值 | 启用重试客户端机制来处理失败。这些机制可用于嵌套所有的 pymemcache 客户端。打包程序允许您定义在 attemots 之间等待多少次尝试和等待的时间。 |
| 布尔值 | dogpile 的 pymemcache backend 的 socket keepalive 的全局切换 |
| 布尔值 | 缓存的全局切换。 |
| 整数值 | dogpile.cache 区域中的任何缓存项目的默认 TTL (以秒为单位)。这适用于没有为其定义显式缓存过期时间的任何缓存方法。 |
| 整数值 | 在客户端被标记为死状态并从 HashClient 内部机制中的池中移除客户端的次数。 |
| 浮点值 | 在 HashClient 内部机制中应在重试尝试之间传递的时间(以秒为单位)。 |
| 整数值 | 在再次尝试前 memcached 服务器被视为死的秒数。(dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。 |
`memcache_password = ` | 字符串值 | 启用 SASL 的 memcached 密码 |
| 整数值 | 操作将等待进入 memcache 客户端连接的秒数。 |
| 布尔值 | 如果 memcache 将在重新连接时清空,则全局切换。(仅限oslo_cache.memcache_pool 后端)。 |
| 整数值 | 每个 memcached 服务器的最大打开连接数。(仅限oslo_cache.memcache_pool 后端)。 |
| 整数值 | 在关闭之前,与 memcached 的连接在池中保持未使用的秒数。(仅限oslo_cache.memcache_pool 后端)。 |
| 布尔值 | 如果 SASL_enable 为 true,则启用 SASL (Simple Authentication and SecurityLayer),否则禁用。 |
| 列出值 |
memcache 服务器的格式是 "host:port"。这由依赖 Memcached 的后端使用。如果 |
| 浮点值 | 对每个对服务器调用的超时时间(dogpile.cache.memcache 和 oslo_cache.memcache_pool 后端)。 |
`memcache_username = ` | 字符串值 | 启用 SASL 的 memcached 的用户名 |
| 列出值 | 用于导入的代理类将影响 dogpile.cache 后端功能的方式。参阅 dogpile.cache 文档中有关 changing-backend-behavior 的文档。 |
| 整数值 | 失败前尝试操作的次数。 |
| 浮点值 | 每次尝试之间休眠的秒数。 |
| 整数值 | 丢弃连接前应发送的最大 keepalive 探测 TCP 数。应该是一个大于零的正整数。 |
| 整数值 | 在 TCP 开始发送 keepalive 探测前,连接需要保持闲置的时间(以秒为单位)。应该是一个大于零的正整数。 |
| 整数值 | 单个 keepalive 探测之间的时间(以秒为单位)。应该是一个大于零的正整数。 |
| 字符串值 | 为使用 TLS 上下文创建的套接字设置可用密码。它应该是 OpenSSL 密码列表格式的字符串。如果没有指定,则所有启用的 OpenSSL 密码都将可用。 |
| 字符串值 | 以 PEM 格式串联的 CA 证书文件的路径,以建立缓存服务器的真实性。如果 tls_enabled 是 False,则忽略这个选项。 |
| 字符串值 | PEM 格式的单个文件的路径,其中包含客户端证书以及建立证书真实性所需的任意数量的 CA 证书。仅当需要客户端身份验证时,才需要此文件。如果 tls_enabled 是 False,则忽略这个选项。 |
| 布尔值 | 与缓存服务器捆绑时,用于 TLS 使用的全局切换。 |
| 字符串值 | 到包含客户端私钥的单个文件的路径。否则,私钥将从 tls_certfile 中指定的文件中获取。如果 tls_enabled 是 False,则忽略这个选项。 |
7.1.6. catalog
下表概述了 /etc/keystone/keystone.conf
文件中的 [catalog]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 | 缓存目录数据的时间(以秒为单位)。除非同时启用了全局和目录缓存,否则这不起作用。目录数据(服务、端点等)通常不会频繁变化,因此可能需要更长的时间超过全局默认值。 |
| 布尔值 | 目录缓存切换。除非启用了全局缓存,否则这无效。在典型的部署中,不需要禁用此功能。 |
| 字符串值 |
|
| 整数值 | 在目录集合中返回的最大实体数。通常没有设置此功能的原因,因为部署会不常有足够的服务或端点超过合理的限制。 |
| 字符串值 |
用于模板目录后端的文件的绝对路径。只有在 |
7.1.7. CORS
下表概述了 /etc/keystone/keystone.conf
文件中的 [cors]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 布尔值 | 指明实际请求可以包含用户凭证 |
| 列出值 | 指定在实际请求过程中可以使用哪些标头字段名称。 |
| 列出值 | 指明哪些方法可以在实际请求期间使用。 |
| 列出值 | 指明此资源是否可以与请求"origin"标头中收到的域共享。格式:"<protocol>://<host>[:<port>]",没有结尾的斜杠。示例 :https://horizon.example.com |
| 列出值 | 指明向 API 公开哪些标头是安全的。默认为 HTTP Simple Headers。 |
| 整数值 | CORS preflight 请求的最大缓存期限。 |
7.1.8. credential
下表概述了 /etc/keystone/keystone.conf
文件中的 [credential]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 | 签名 EC2 或 S3 令牌请求从令牌请求中包含的时间戳有效的时间长度(以分钟为单位)。 |
| 整数值 | 缓存凭证数据的时间(以秒为单位)。除非启用了全局缓存,否则这无效。 |
| 布尔值 | 只在检索用户凭证时切换缓存。除非启用了全局缓存,否则这无效。 |
| 字符串值 |
|
| 字符串值 | 包含用于加密和解密存储在凭据后端中的 Fernet 密钥的目录。用于加密凭据的 Fernet 密钥与用于加密 Fernet 令牌的 Fernet 密钥没有关系。这两个密钥集合都应单独管理,并需要不同的轮转策略。不要与用于管理 Fernet 令牌密钥的存储库共享此存储库。 |
| 字符串值 |
|
| 整数值 | 允许用户创建的最大凭证数。值 -1 表示无限。如果没有设置限制,则允许用户在 中创建凭证,这可能会导致 keystone 数据库中出现问题或打开 keystone 进入 DoS 攻击。 |
7.1.9. database
下表概述了 /etc/keystone/keystone.conf
文件中的 [database]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 | 用于数据库的后端。 |
| 字符串值 | 用于连接到数据库的 SQLAlchemy 连接字符串。 |
| 整数值 | SQL 调试信息的详细程度:0=None, 100=Everything。 |
`connection_parameters = ` | 字符串值 | 在连接时附加到连接 URL 上的可选 URL 参数 ; 指定为 param1=value1¶m2=value2&… |
| 整数值 | 连接池中存在的连接的时间超过这个秒数,将在下次从池中签出时被替换为新的秒数。 |
| 布尔值 | 将 Python 堆栈跟踪作为注释字符串添加到 SQL 中。 |
| 布尔值 | 如果为 True,将数据库操作重试间隔增加到 db_max_retry_interval。 |
| 整数值 | 在引发错误前,连接错误或死锁错误时的最大重试次数。设置为 -1 以指定无限重试计数。 |
| 整数值 | 如果设置了 db_inc_retry_interval,则数据库操作重试之间的最大秒数。 |
| 整数值 | 数据库事务重试之间的秒数。 |
| 整数值 | 如果设置,请对带有 SQLAlchemy 的 max_overflow 使用这个值。 |
| 整数值 | 池中保持打开的最大 SQL 连接数。设置 0 表示没有限制。 |
| 整数值 | 在启动过程中重试数据库连接的最大数量。设置为 -1 以指定无限重试计数。 |
| 布尔值 | 如果为 True,则透明地启用对处理 MySQL 集群(NDB)的支持。弃用自: 12.1.0 适用于 MySQL NDB 集群存储引擎的reason:*Support 已弃用,并将在以后的版本中删除。 |
| 字符串值 | 用于 MySQL 会话的 SQL 模式。此选项包括默认设置,可覆盖任何 server-set SQL 模式。要使用服务器配置设置的任何 SQL 模式,请将其设置为 no 值。示例:mysql_sql_mode= |
| 整数值 | 对于 Galera,对新连接配置 wsrep_sync_wait 导致性检查。默认为 None,表示不配置任何设置。 |
| 整数值 | 如果设置,请对带有 SQLAlchemy 的 pool_timeout 使用这个值。 |
| 整数值 | 打开 SQL 连接之间的间隔。 |
| 字符串值 | 用于连接到从属数据库的 SQLAlchemy 连接字符串。 |
| 布尔值 | 如果为 True,则 SQLite 使用同步模式。 |
| 布尔值 | 在连接丢失时启用数据库重新连接的实验性使用。 |
7.1.10. domain_config
下表概述了 /etc/keystone/keystone.conf
文件中的 [domain_config]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 |
生存时间(TTL,以秒为单位)来缓存域特定的配置数据。除非启用了 |
| 布尔值 | 切换域特定配置后端的缓存。除非启用了全局缓存,否则这无效。通常没有理由禁用此操作。 |
| 字符串值 |
|
7.1.11. endpoint_filter
下表概述了 /etc/keystone/keystone.conf
文件中的 [endpoint_filter]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
|
| 布尔值 | 如果配置的端点过滤器不会导致用户 + 项目对的任何端点(因此可能存在空服务目录),这将控制 keystone 的行为。如果设置为 true,则 keystone 将返回整个服务目录。如果设置为 false,则 keystone 将返回一个空服务目录。 |
7.1.12. endpoint_policy
下表概述了 /etc/keystone/keystone.conf
文件中的 [endpoint_policy]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
|
7.1.13. eventlet_server
下表概述了 /etc/keystone/keystone.conf
文件中的 [eventlet_server]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 主机地址值 | 要侦听的 admin 服务的网络接口的 IP 地址。弃用自: K 对于在 eventlet 下运行的 keystone,在 Newton 发行版本中删除了在 eventlet 下运行的 keystone。这些选项保持向后兼容性,因为它们用于 URL 替换。 |
| 端口值 | 要侦听的 admin 服务的端口号。弃用自: K 对于在 eventlet 下运行的 keystone,在 Newton 发行版本中删除了在 eventlet 下运行的 keystone。这些选项保持向后兼容性,因为它们用于 URL 替换。 |
| 主机地址值 | 要侦听的公共服务的网络接口的 IP 地址。弃用自: K 对于在 eventlet 下运行的 keystone,在 Newton 发行版本中删除了在 eventlet 下运行的 keystone。这些选项保持向后兼容性,因为它们用于 URL 替换。 |
| 端口值 | 要侦听的公共服务的端口号。弃用自: K 对于在 eventlet 下运行的 keystone,在 Newton 发行版本中删除了在 eventlet 下运行的 keystone。这些选项保持向后兼容性,因为它们用于 URL 替换。 |
7.1.14. federation
下表概述了 /etc/keystone/keystone.conf
文件中的 [federation]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
`assertion_prefix = ` | 字符串值 | 在为联邦断言过滤环境变量名称时使用的前缀。匹配的变量传递到联邦映射引擎中。 |
| 布尔值 | 切换联邦缓存。除非启用了全局缓存,否则这无效。通常没有原因来禁用此功能。 |
| 整数值 | 从映射中执行组成员资格的有效性的默认时间(以分钟为单位)。默认值为 0,即禁用。 |
| 字符串值 |
|
| 字符串值 | 为允许联邦临时用户有一个域概念保留的任意域名。请注意,管理员将无法使用此名称创建域,或将现有域更新为此名称。除非真正需要,否则不建议更改这个值。弃用自: T *reason:* this option 已被其身份提供程序域中的临时用户取代。 |
| 字符串值 |
用于从环境中获取身份提供程序实体 ID 的所有协议的默认值。对于 |
| 字符串值 | 用作单点登录回调处理器的 HTML 文件的绝对路径。此页面应当通过将用户从 keystone 重定向到可信仪表板主机,方法是在 POST 请求中形成编码令牌。Keystone 的默认值应该足以满足大多数部署的情况。 |
| 多值 | 可信仪表板主机列表。在接受 Single Sign-On 请求以返回令牌之前,原始主机必须是此列表的成员。对于多个值,可以重复此配置选项。您必须设置此项,才能使用基于 Web 的 SSO 流。例如: trusted_dashboard=https://acme.example.com/auth/websso trusted_dashboard=https://beta.example.com/auth/websso |
7.1.15. fernet_receipts
下表概述了 /etc/keystone/keystone.conf
文件中的 [fernet_receipts]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
包含 Fernet 重新密钥的目录。在第一次使用 |
| 整数值 |
这会在 |
7.1.16. fernet_tokens
下表概述了 /etc/keystone/keystone.conf
文件中的 [fernet_tokens]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
包含 Fernet 令牌密钥的目录。在第一次使用 |
| 整数值 |
这会在 |
7.1.17. healthcheck
下表概述了 /etc/keystone/keystone.conf
文件中的 [healthcheck]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 列出值 | 可以执行健康检查的额外后端,并报告信息作为请求的一部分。 |
| 布尔值 | 作为响应的一部分,显示更详细的信息。安全备注:启用此选项可能会公开有关被监控服务的敏感详情。务必验证它是否不会违反您的安全策略。 |
| 字符串值 | 检查是否存在文件,以确定应用程序是否在端口上运行。由 DisableByFileHealthcheck 插件使用。 |
| 列出值 | 根据端口检查是否存在文件,以确定应用程序是否在端口上运行。需要一个字符串的 "port:path" 列表。由 DisableByFilesPortsHealthcheck 插件使用。 |
| 字符串值 | 响应 healtcheck 请求的路径。 |
7.1.18. identity
下表概述了 /etc/keystone/keystone.conf
文件中的 [identity]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 | 缓存身份数据的时间(以秒为单位)。除非启用了全局和身份缓存,否则这将无效。 |
| 布尔值 | 切换身份缓存。除非启用了全局缓存,否则这无效。通常没有原因来禁用此功能。 |
| 字符串值 |
这将引用用于所有身份 API v2 请求的域(它们不知道域)。通过 |
| 字符串值 |
keystone 应找到特定于域的 |
| 布尔值 |
默认情况下,特定于域的配置数据是从 |
| 布尔值 |
域的子集(或全部)可以有自己的身份驱动程序,每个选项都有自己的部分配置选项,存储在资源后端或域配置目录中的文件(取决于 |
| 字符串值 |
|
| 整数值 | 在身份集合中返回的最大实体数。 |
| 整数值 | 用户密码的最大允许长度。减少这个值以提高性能。更改此值不会影响现有密码。该值也可以通过某些哈希算法的最大允许长度覆盖,其优先于配置的值。bcrypt max_password_length 为 72 字节。 |
| 字符串值 | 用于 keystone 中存储的密码的密码哈希算法。 |
| 整数值 |
这个选项代表了在安全性和性能之间权衡。数值越高,性能会较慢,但安全性更高。更改此选项将仅影响新创建的密码,因为现有密码哈希已应用了固定数量的循环,因此在正在运行的集群中调整此选项是安全的。bcrypt 的默认值为 12,必须在 4 到 31 之间,包括。scrypt 的默认值为 16,必须在 |
| 整数值 | 在 scrypt 和 pbkfd2_sha512 哈希 salt 中使用的字节数。scrypt 的默认值为 16 字节。对于 pbkfd2_sha512,默认为 16 字节。由于用于存储密码哈希的列的大小,因此限制为最多 96 字节。 |
| 整数值 |
要传递给 scrypt 哈希函数的可选块大小( |
| 整数值 |
可选的并行性传递至 scrypt 哈希函数( |
7.1.19. identity_mapping
下表概述了 /etc/keystone/keystone.conf
文件中的 [identity_mapping]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 布尔值 |
在 Juno 中,不生成 UUID (如 LDAP)的后端更改用户和组 ID 格式,keystone 提供到 LDAP 中底层属性的哈希映射。默认情况下,此映射被禁用,这样可确保现有 ID 不会改变。即使使用域特定驱动程序( |
| 字符串值 |
|
| 字符串值 |
|
7.1.20. jwt_tokens
下表概述了 /etc/keystone/keystone.conf
文件中的 [jwt_tokens]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
包含用于签名 JWS 令牌的私钥的目录。此目录必须存在,以便 keystone 的服务器进程启动。它还必须被 keystone 的服务器进程读取。它必须至少包含一个私钥,对应于 |
| 字符串值 |
包含用于验证 JWS 令牌签名的公钥的目录。此目录必须存在,以便 keystone 的服务器进程启动。它还必须被 keystone 的服务器进程读取。它必须至少包含一个与 |
7.1.21. ldap
下表概述了 /etc/keystone/keystone.conf
文件中的 [ldap]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
用于查询涉及别名的 LDAP 解引用选项。值 |
| 整数值 |
LDAP 服务器的最大最终用户身份验证连接生命周期(以秒为单位)。超过此生命周期时,连接将不被绑定,并从连接池中移除。除非也启用了 |
| 整数值 |
用于最终用户身份验证的连接池的大小。除非也启用了 |
| 布尔值 | 设置 keystone 在目录分区间引用行为。如果未设置,则使用系统的默认行为。 |
| 整数值 |
与 LDAP 服务器一起使用的连接超时。值 |
| 整数值 | 为 LDAP 调用设置 LDAP 调试级别。值 0 表示没有启用调试。这个值是一个位掩码,请参考您的 LDAP 文档以了解可能的值。 |
| 布尔值 | 如果启用,组查询将为嵌套组使用 Active Directory 特定的过滤器。 |
| 列出值 |
用于将额外属性映射到 keystone 中的组的 LDAP 属性到 keystone 组属性对列表。预期的格式为 |
| 列出值 | 要忽略的组群属性列表。或者是否应为 list 或 show group 过滤特定的组属性。 |
| 字符串值 | 在 keystone 中映射到组描述的 LDAP 属性。 |
| 字符串值 | 用于组的 LDAP 搜索过滤器。 |
| 字符串值 | 在 keystone 中映射到组 ID 的 LDAP 属性。这不能是一个多值属性。组 ID 预期在 keystone 域和 URL 间需要全局唯一。 |
| 字符串值 | 用于表示用户是组的成员的 LDAP 属性。 |
| 布尔值 |
如果组对象类的成员是 keystone 用户 ID 而不是 LDAP DN,则启用这个选项。在 Open Directory 中使用 |
| 字符串值 | 在 keystone 中映射到组名称的 LDAP 属性。组名称应该只在 keystone 域中唯一,且不应该是 URL-safe。 |
| 字符串值 |
用于组的 LDAP 对象类。如果将此选项设置为 |
| 字符串值 |
用于组的搜索基础。默认为 |
| 整数值 |
定义在列出对象时 keystone 应该从 LDAP 服务器请求的结果数上限。值为零( |
| 字符串值 | 在查询 LDAP 服务器时,管理员绑定 DN 的密码(如果您的 LDAP 服务器需要它)。 |
| 整数值 |
LDAP 服务器的最大连接生命周期(以秒为单位)。超过此生命周期时,连接将不被绑定,并从连接池中移除。除非也启用了 |
| 整数值 |
池 LDAP 连接时使用的连接超时。值 |
| 浮点值 |
尝试重新连接 LDAP 服务器前要等待的秒数。除非也启用了 |
| 整数值 |
在中止前尝试连接到 LDAP 服务器的次数上限。值 one 只进行一个连接尝试。除非也启用了 |
| 整数值 |
LDAP 连接池的大小。除非也启用了 |
| 字符串值 |
搜索范围定义在搜索基础中搜索程度。 |
| 布尔值 | 随机化每个 keystone 进程中的 URL 顺序。这会使失败行为更加逐步,因为如果第一个服务器停机,进程/线程将等待指定的超时,然后再尝试到服务器的连接进一步关闭列表。对于向后兼容,默认为 False。 |
| 字符串值 |
如果没有通过 |
| 字符串值 |
与 LDAP 服务器通信时要使用的 CA 证书目录的绝对路径。如果您还设置了 |
| 字符串值 |
与 LDAP 服务器通信时要使用的 CA 证书文件的绝对路径。这个选项优先于 |
| 字符串值 |
指定要对传入 TLS 会话上的客户端证书执行的检查。如果设置为 |
| 字符串值 | 用于连接到 LDAP 服务器的 URL。可将多个 LDAP URL 指定为用逗号分开的字符串。要成功绑定的第一个 URL 用于连接。 |
| 布尔值 | 为最终用户身份验证启用 LDAP 连接池。通常没有原因来禁用此功能。 |
| 布尔值 | 启用 LDAP 连接池以查询 LDAP 服务器。通常没有原因来禁用此功能。 |
| 布尔值 |
在与 LDAP 服务器通信时启用 TLS。在使用此选项时,您还应设置 |
| 字符串值 | 在查询 LDAP 服务器时要使用的管理员绑定 DN 的用户名(如果您的 LDAP 服务器需要它)。 |
| 列出值 |
用于映射 keystone 中用户属性到用户属性的 LDAP 属性列表。预期的格式为 |
| 列出值 | 要忽略的用户属性列表,或者是否应为 list 或 show user 过滤特定的用户属性。 |
| 字符串值 | 在 keystone 中映射到用户的 default_project_id 的 LDAP 属性。当 keystone 具有对 LDAP 的写访问权限时,这最常使用。 |
| 字符串值 | 在 keystone 中映射到用户描述的 LDAP 属性。 |
| 字符串值 |
映射到 keystone 中用户启用属性的 LDAP 属性。如果将此选项设置为 |
| 字符串值 |
启用用户的默认值。如果 LDAP 服务器使用非布尔值(bitmask)值来指示用户是否启用或禁用,则这应匹配适当的整数值。如果这未设置为 |
| 布尔值 |
如果启用,Keystone 使用替代方法来确定是否启用了用户或未通过检查 |
| 字符串值 |
使用启用模拟时用于存放启用的用户条目的 DN。除非同时启用了 |
| 布尔值 |
使用 |
| 布尔值 |
在逻辑上,对从 LDAP 服务器获取的 enabled 属性的布尔值相符。有些 LDAP 服务器使用布尔值锁定属性,其中 "true" 表示帐户被禁用。设置 |
| 整数值 |
位掩码整数,如果 LDAP 服务器代表"启用"作为整数而不是离散布尔值,则位代表启用的值。值 |
| 字符串值 | 用于用户的 LDAP 搜索过滤器。 |
| 字符串值 | 在 keystone 中映射到用户 ID 的 LDAP 属性。这不能是一个多值属性。用户 ID 预期在 keystone 域和 URL 安全之间需要全局唯一。 |
| 字符串值 | 在 keystone 中映射到用户电子邮件的 LDAP 属性。 |
| 字符串值 | 在 keystone 中映射到用户名的 LDAP 属性。用户名应该只在 keystone 域中唯一,且不应该是 URL-safe。 |
| 字符串值 | 用于用户的 LDAP 对象类。 |
| 字符串值 | 映射到 keystone 中用户密码的 LDAP 属性。 |
| 字符串值 |
用于用户的搜索基础。默认为 |
7.1.22. memcache
下表概述了 /etc/keystone/keystone.conf
文件中的 [memcache]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 | 在再次尝试前,memcached 服务器被视为停止的秒数。这供 key 值存储系统使用。弃用自: Y *reason:* this option no effect。配置 ''keystone.conf [cache] memcache_dead_retry' 选项,以改为设置 dead_retry 设为 memcached。 |
| 整数值 | 操作将等待进入 memcache 客户端连接的秒数。这供 key 值存储系统使用。弃用自: Y *reason:* this option no effect。配置 ''keystone.conf [cache] memcache_pool_connection_get_timeout' 选项,以将 connection_get_timeout 设为 memcached。 |
| 整数值 | 每个 memcached 服务器的最大开放连接数。这供 key 值存储系统使用。弃用自: Y *reason:* this option no effect。配置 ''keystone.conf [cache] memcache_pool_maxsize' 选项,以将 pool_maxsize 设置为 memcached。 |
| 整数值 | 到 memcached 的连接在关闭前已保持在池中未使用的秒数。这供 key 值存储系统使用。弃用自: Y *reason:* this option no effect。配置 ''keystone.conf [cache] memcache_pool_unused_timeout' 选项,将 pool_unused_timeout 设为 memcached。 |
| 整数值 | 对每个对服务器调用的超时时间(以秒为单位)。这供 key 值存储系统使用。弃用自: T *reason:* this option no effect。配置 ''keystone.conf [cache] memcache_socket_timeout' 选项,以将 socket_timeout 设为 memcached。 |
7.1.23. oauth1
下表概述了 /etc/keystone/keystone.conf
文件中的 [oauth1]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 | OAuth 访问令牌在创建后保持有效的秒数。这是消费者必须与服务提供商交互的时间(通常是 keystone)。将这个选项设置为零意味着访问令牌将持续存在。 |
| 字符串值 |
|
| 整数值 | OAuth 请求令牌在创建后保持有效的秒数。这是用户授权令牌的时间长度。将这个选项设置为零表示请求令牌将持续存在。 |
7.1.24. oauth2
下表概述了 /etc/keystone/keystone.conf
文件中的 [oauth2]
组下可用的选项。
配置选项 = 默认值 | 类型 | 描述 |
---|---|---|
| 列出值 | 当用户通过 OAuth2.0 令牌端点获取访问令牌时,系统支持的 OAuth2.0 验证方法。这个选项可以设置为 certificate 或 secret。如果没有设置选项,则默认值为 certificate。当选项设置为 secret 时,OAuth2.0 令牌端点使用 client_secret_basic 方法进行身份验证,否则使用 tls_client_auth 方法进行身份验证。 |
| 字符串值 | 用于定义映射规则 id。如果没有设置,则映射规则 id 是 oauth2_mapping。 |
7.1.25. oslo_messaging_amqp
下表概述了 /etc/keystone/keystone.conf
文件中的 [oslo_messaging_amqp]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 | 表示驱动程序使用的寻址模式。允许的值: legacy - 使用旧的不可路由寻址;routable - 使用可路由地址;dynamic - 如果消息总线不支持路由,使用 legacy,如果支持,使用 routable。 |
| 字符串值 | 在发送到一组消费者时,附加到地址前缀中。由消息总线使用来识别应以轮循方式传送的消息。 |
| 字符串值 | 广播到所有服务器时使用的地址前缀 |
| 整数值 | 在每次失败故障转移尝试失败后,增加 connection_retry_interval。 |
| 整数值 | 在尝试重新连接前需要暂停的秒数。 |
| 整数值 | connection_retry_interval + connection_retry_backoff 的最大限制 |
| 字符串值 | AMQP 容器的名称。必须全局唯一。默认为生成的 UUID |
| 字符串值 | 通知地址中使用的交换名称。Exchange name resolution priority: Target.exchange if set else default_notification_exchange if set else control_exchange if set else notify |
| 整数值 | 发送通知消息发送的截止时间。仅在调用者不提供超时到期时使用。 |
| 整数值 | 因可恢复错误而重新发送失败的回复消息的最大尝试次数。 |
| 整数值 | rpc 回复消息发送的截止时间。 |
| 字符串值 | RPC 地址中使用的交换名称。Exchange name resolution priority: Target.exchange if set else default_rpc_exchange if set else control_exchange if set else rpc |
| 整数值 | rpc cast 或调用消息发送的截止时间。仅在调用者不提供超时到期时使用。 |
| 整数值 | 调度闲置发送方链接的清除持续时间。在到期后分离链接。 |
| 字符串值 | 发送到组中任何服务器的地址前缀 |
| 整数值 | 不活跃连接的超时时间(以秒为单位) |
| 整数值 | 重新连接因为可恢复的错误而失败的 AMQP 1.0 链接之间暂停的时间。 |
| 字符串值 | 在发送 fanout 消息时附加到地址前缀中。由消息总线用来识别 fanout 消息。 |
| 字符串值 | 所有生成的通知地址的地址前缀 |
| 整数值 | 传入通知消息的窗口大小 |
| 多值 | 发送此类类型的消息。预先修改的消息将不会接收来自对等点的确认。注意:如果发送失败,则预先修改的消息可能会静默丢弃。允许的值: rpc-call - send RPC Calls pre-settled rpc-reply- send RPC Replies pre-settled rpc-cast - Send RPC Casts pre-settled notify - Send Notifications pre-settled |
| 布尔值 | 为那些不支持原生支持虚拟主机(如 qpidd)的消息总线启用虚拟主机支持。当设置为 true 时,虚拟主机名将添加到所有消息总线地址中,从而有效地为每个虚拟主机 创建专用子网。如果消息总线使用 AMQP 1.0 Open performative 作为虚拟主机名称中的 hostname 字段,则设置为 False。 |
| 整数值 | 传入 RPC Reply 消息的窗口大小。 |
| 字符串值 | 所有生成的 RPC 地址的地址前缀 |
| 整数值 | 传入 RPC 请求消息的窗口大小 |
`sasl_config_dir = ` | 字符串值 | 包含 SASL 配置的目录路径 |
`sasl_config_name = ` | 字符串值 | 配置文件的名称(不带 .conf 后缀) |
`sasl_default_realm = ` | 字符串值 | 如果用户名中没有域,则将使用 SASL 域 |
`sasl_mechanisms = ` | 字符串值 | 可接受的 SASL 机制的空格分隔列表 |
| 字符串值 | 发送到特定服务器时使用的地址前缀 |
| 布尔值 | 尝试通过 SSL 连接。如果没有指定其他与 ssl 相关的参数,它将使用系统的 CA-bundle 来验证服务器证书。 |
`ssl_ca_file = ` | 字符串值 | 用于验证服务器证书的 CA 证书 PEM 文件 |
`ssl_cert_file = ` | 字符串值 | 自我识别用于客户端身份验证的证书 PEM 文件 |
`ssl_key_file = ` | 字符串值 | 用于为 ssl_cert_file 证书签名的私钥 PEM 文件(可选) |
| 字符串值 | 用于解密 ssl_key_file 的密码(如果加密) |
| 布尔值 | 默认情况下,SSL 检查服务器证书中的名称是否与 transport_url 中的主机名匹配。在某些配置中,可能最好使用虚拟主机名,例如,如果服务器使用 Server Name Indication TLS 扩展(rfc6066)为每个虚拟主机提供证书。如果服务器的 SSL 证书使用虚拟主机名称而不是 DNS 名称,则将 ssl_verify_vhost 设置为 True。 |
| 布尔值 | debug:将 AMQP 帧转储到 stdout |
| 字符串值 | 在发送到特定的 RPC/Notification 服务器时,附加到地址前缀中。由消息总线用来识别发送到单个目的地的消息。 |
7.1.26. oslo_messaging_kafka
下表概述了 /etc/keystone/keystone.conf
文件中的 [oslo_messaging_kafka]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 | 生成者生成的所有数据的压缩码c。如果没有设置,则不会使用压缩。请注意,这允许的值取决于 kafka 版本 |
| 整数值 | 连接过期策略的池大小限制 |
| 整数值 | 池中闲置连接的生存时间 |
| 字符串值 | Kafka 消费者的组 ID。一个组中的消费者将协调消息消耗 |
| 布尔值 | 启用异步消费者提交 |
| 浮点值 | Kafka 用户的默认超时 |
| 整数值 | Kafka 使用者的最大获取字节数 |
| 整数值 | 轮询调用中返回的最大记录数 |
| 整数值 | Kafka Consumers 的池大小 |
| 整数值 | producer async 发送的批处理大小 |
| 浮点值 | KafkaProducer batching 的延迟上限(以秒为单位) |
| 字符串值 | 安全协议是 SASL 的机制 |
| 字符串值 | 用于与代理通信的协议 |
`ssl_cafile = ` | 字符串值 | 用于验证服务器证书的 CA 证书 PEM 文件 |
`ssl_client_cert_file = ` | 字符串值 | 用于身份验证的客户端证书 PEM 文件。 |
`ssl_client_key_file = ` | 字符串值 | 用于身份验证的客户端密钥 PEM 文件。 |
`ssl_client_key_password = ` | 字符串值 | 用于身份验证的客户端密钥密码文件。 |
7.1.27. oslo_messaging_notifications
下表概述了 /etc/keystone/keystone.conf
文件中的 [oslo_messaging_notifications]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 多值 | 处理发送通知的驱动程序。可能的值有 messaging, messagingv2, routing, log, test, noop |
| 整数值 | 因可恢复的错误而发送失败的通知消息的最大尝试次数。0 - no retry, -1 - indefinite |
| 列出值 | 用于 OpenStack 通知的 AMQP 主题。 |
| 字符串值 | 代表用于通知的消息传递驱动程序的 URL。如果没有设置,我们回退到用于 RPC 的同一配置。 |
7.1.28. oslo_messaging_rabbit
下表概述了 /etc/keystone/keystone.conf
文件中的 [oslo_messaging_rabbit]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 布尔值 | AMQP 中的自动删除队列。 |
| 布尔值 | 在 AMQP 中使用持久队列。如果启用了 rabbit_quorum_queue,则队列将具有持久性,并且此值将被忽略。 |
| 布尔值 | (DEPRECATED)为直接发送启用/禁用 RabbitMQ 强制标记。直接发送用作回复,因此当客户端队列不存在时,会引发 MessageUndeliverable 异常。MessageUndeliverable 异常将用于对超时进行循环,以便发送者有机会恢复该标志,且无法停用此功能。 |
| 布尔值 | 启用 x-cancel-on-ha-failover 标志,rabbitmq 服务器将取消和通知消费者何时队列停机 |
| 布尔值 | 默认情况下,通过原生 python 线程运行健康检查心跳线程。如果此选项等于 False,则健康检查心跳将从父进程继承执行模型。例如,如果父进程使用 eventlet/greenlet 对 stdlib 进行补丁,则 heartbeat 将通过绿色线程运行。这个选项应只针对 wsgi 服务设置为 True。 |
| 整数值 | heartbeat_timeout_threshold 中检查心跳的频率。 |
| 整数值 | 如果 heartbeat 的 keep-alive 失败(0 禁用心跳)失败,则 Rabbit 代理被视为 down 的秒数。 |
| 字符串值 | EXPERIMENTAL:可能的值为 gzip, bz2。如果没有设置压缩,则不会使用。这个选项可能在以后的版本中不可用。 |
| 字符串值 | 确定在当前连接到的 RabbitMQ 节点不可用时如何选择下一个 RabbitMQ 节点。只有在配置中提供了多个 RabbitMQ 节点时,才会生效。 |
| 整数值 | 在放弃向其回复发送之前,等待缺少客户端的时间。这个值不应超过 rpc_response_timeout。 |
| 浮点值 | 在响应 AMQP 消费者取消通知前等待(以秒为单位)等待(以秒为单位)。 |
| 布尔值 | 尝试在 RabbitMQ 中使用 HA 队列(x-ha-policy: all)。如果更改这个选项,您必须擦除 RabbitMQ 数据库。在 RabbitMQ 3.0 中,在声明队列时,x-ha-policy 参数不再控制队列镜像。如果您只想确保所有队列(除自动生成的名称除外)都已镜像到所有节点,请运行:"rabbitmqctl set_policy HA ^(?!amq\.) commands {"ha-mode": "all"} " |
| 整数值 | RabbitMQ 连接重试的最大间隔。默认值为 30 秒。 |
| 字符串值 | RabbitMQ 登录方法。 |
| 整数值 | 指定要预先抓取的消息数量。将 设为零可允许无限消息。 |
| 整数值 | 每次消息被重新设计为消费者时,计数器都会递增。当重新传送计数超过交付限制后,消息将被丢弃或死信(如果配置了 DLX 交换)仅在启用 rabbit_quorum_queue 时使用,默认 0 代表没有设置限制。 |
| 整数值 | 默认情况下,如果仲裁队列增加,则所有消息都会在内存中维护,这会给集群造成内存压力。这个选项可以限制仲裁队列使用的内存字节数。仅在启用 rabbit_quorum_queue 时使用,默认 0 代表 dont 设置限制。 |
| 整数值 | 默认情况下,如果仲裁队列增加,则所有消息都会在内存中维护,这会给集群造成内存压力。这个选项可以限制仲裁队列中的消息数量。仅在启用 rabbit_quorum_queue 时使用,默认 0 代表 dont 设置限制。 |
| 布尔值 |
在 RabbitMQ 中使用仲裁队列(x-queue-type: quorum)。仲裁队列是基于 Raft 共识算法的 RabbitMQ 实施持久复制 FIFO 队列的现代队列类型。它从 RabbitMQ 3.8.0 开始提供。如果设置此选项将与 HA 队列( |
| 整数值 | 连接到 RabbitMQ 时,在重试之间会多长时间进行 backoff。 |
| 整数值 | 使用 RabbitMQ 重试连接的频率。 |
| 整数值 | 正整数,代表队列 TTL (x-expires)的持续时间(以秒为单位)。TTL 期间未使用的队列将自动删除。参数仅影响回复和 fanout 队列。 |
| 布尔值 | 通过 SSL 连接。 |
`ssl_ca_file = ` | 字符串值 | SSL 证书颁发机构文件(仅在启用 SSL 时才评估)。 |
`ssl_cert_file = ` | 字符串值 | SSL 证书文件(仅在启用 SSL 时才评估)。 |
| 布尔值 | 强制 OpenSSL FIPS 模式的全局切换。此功能需要 Python 支持。这在所有环境中的 Python 3.9 中都可用,并可能已向后移植到所选环境中的旧的 Python 版本。如果使用的 Python 可执行文件不支持 OpenSSL FIPS 模式,则会引发异常。 |
`ssl_key_file = ` | 字符串值 | SSL 密钥文件(仅在启用 SSL 时才评估)。 |
`ssl_version = ` | 字符串值 | 要使用的 SSL 版本(仅在启用 SSL 时验证)。有效值为 TLSv1 和 SSLv23。在某些发行版中可能会提供 SSLv2、SSLv3、TLSv1_1 和 TLSv1_2。 |
7.1.29. oslo_middleware
下表概述了 /etc/keystone/keystone.conf
文件中的 [oslo_middleware]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 布尔值 | 应用程序是否位于代理后面。这决定了中间件是否应该解析标头。 |
| 字符串值 | HTTP 基本身份验证密码文件。 |
| 整数值 | 每个请求的最大正文大小,以字节为单位。 |
| 字符串值 | 用于确定原始请求协议方案的 HTTP 标头,即使它已被 SSL 终止代理隐藏。 |
7.1.30. oslo_policy
下表概述了 /etc/keystone/keystone.conf
文件中的 [oslo_policy]
组下可用的选项。
配置选项 = 默认值 | 类型 | 描述 |
---|---|---|
| 布尔值 |
这个选项控制在评估策略时是否使用旧的已弃用默认值。如果为 |
| 布尔值 |
此选项控制在评估策略时是否强制执行范围。如果为 |
| 字符串值 | 默认规则。未找到请求的规则时强制执行。 |
| 多值 | 存储策略配置文件的目录。它们可以相对于 config_dir 选项定义的搜索路径中的任何目录,也可以是绝对路径。必须存在由 policy_file 定义的文件,才能搜索这些目录。缺失或空目录将被忽略。 |
| 字符串值 | 文件相对或绝对路径,用于将角色映射到给定服务的权限。必须根据配置文件设置此选项指定相对路径。 |
| 字符串值 | 用于发送和接收基于 REST 策略检查的数据的内容类型 |
| 字符串值 | 基于 REST 的策略检查的 ca 证书文件的绝对路径 |
| 字符串值 | 基于 REST 的策略检查的客户端证书的绝对路径 |
| 字符串值 | 绝对路径客户端密钥文件 REST 基于策略检查 |
| 布尔值 | 基于 REST 策略检查的服务器身份验证 |
7.1.31. policy
下表概述了 /etc/keystone/keystone.conf
文件中的 [policy]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
|
| 整数值 | 政策集合中返回的最大实体数。 |
7.1.32. profiler
下表概述了 /etc/keystone/keystone.conf
文件中的 [profiler]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 | 通知程序后端的连接字符串。
默认值为 可能的值示例:
|
| 布尔值 | 启用此节点上所有服务的性能分析。 默认值为 False (完全禁用性能分析功能)。 可能的值:
|
| 字符串值 | elasticsearch 中通知索引的文档类型。 |
| 整数值 | Elasticsearch 批量分割大型请求。此参数定义每个批处理的最大大小(例如: es_scroll_size=10000)。 |
| 字符串值 | 此参数是一个时间值参数(例如: es_scroll_time=2m),指定参与搜索的节点将保持相关资源的时间长度,以便继续和支持它。 |
| 布尔值 | 启用包含 error/exception 到分开的位置的过滤器追踪。 默认值为 False。 可能的值:
|
| 字符串值 | 用于加密性能分析上下文数据的 secret 密钥。 这个字符串值应该具有以下格式: <key1>[,<key2>,…<keyn>],其中每个键是一些随机字符串。通过 REST API 触发性能分析的用户必须在 REST API 调用的标头中设置其中一个密钥,以包含此特定项目的此节点的性能分析结果。 "enabled"标志和"hmac_keys"配置选项都应设置为启用性能分析。此外,要在所有服务中生成正确的性能分析信息,至少需要在 OpenStack 项目之间保持一致。这样可确保可以从客户端使用它来生成 trace,其中包含来自所有可能的资源的信息。 |
| 字符串值 |
Redissentinel 使用服务名称来识别 master redis 服务。此参数定义名称(例如: send |
| 浮点值 | Redissentinel 在连接上提供了一个 timeout 选项。此参数定义该超时(例如: socket_timeout=0.1)。 |
| 布尔值 | 在服务中启用 SQL 请求性能分析。 默认值为 False (SQL 请求不会被追踪)。 可能的值:
|
7.1.33. receipt
下表概述了 /etc/keystone/keystone.conf
文件中的 [receipt]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 布尔值 | 启用存储发布的接收数据以接收验证缓存,以便第一次接收验证不会实际造成完整的验证周期。除非启用了全局缓存和接收缓存,否则此选项无效。 |
| 整数值 |
缓存接收创建和验证数据的秒数。除非启用了全局和 |
| 布尔值 | 切换缓存接收创建和验证数据。除非启用了全局缓存,或者禁用了 cache_on_issue,或者禁用了 cache_on_issue,否则这无效。 |
| 整数值 | 重新接收的时间应保持有效(以秒为单位)。这个值应该始终比较短,因为它代表了在缺少 auth 方法时,用户需要重新尝试 auth 方法的时长。 |
| 字符串值 |
|
7.1.34. resource
下表概述了 /etc/keystone/keystone.conf
文件中的 [resource]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
拥有 |
| 字符串值 |
这是一个特殊的项目,代表服务间的云级管理员特权。特定于此项目的令牌将包含一个 true |
| 整数值 | 以秒为单位缓存资源数据的时间。除非启用了全局缓存,否则这无效。 |
| 布尔值 | 资源缓存的切换。除非启用了全局缓存,否则这无效。 |
| 字符串值 |
这控制了域的名称是否限制为包含 URL-reserved 字符。如果设置为 |
| 字符串值 |
|
| 整数值 | 在资源集合中返回的最大实体数。 |
| 字符串值 |
这控制项目名称是否仅限于包含 URL-reserved 字符。如果设置为 |
7.1.35. revoke
下表概述了 /etc/keystone/keystone.conf
文件中的 [revoke]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 |
缓存撤销列表和吊销事件的时间(以秒为单位)。除非同时启用了全局和 |
| 布尔值 | 切换撤销事件缓存。除非启用了全局缓存,否则这无效。 |
| 字符串值 |
|
| 整数值 | 令牌过期后的秒数,然后可能会从后端清除对应的撤销事件。 |
7.1.36. role
下表概述了 /etc/keystone/keystone.conf
文件中的 [role]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 |
缓存角色数据的时间(以秒为单位)。除非启用了全局缓存和 |
| 布尔值 | 切换角色缓存。除非启用了全局缓存,否则这无效。在典型的部署中,不需要禁用此功能。 |
| 字符串值 |
|
| 整数值 | 角色集合中返回的最大实体数。如果您在部署中有大量离散角色,这可能非常有用。 |
7.1.37. saml
下表概述了 /etc/keystone/keystone.conf
文件中的 [saml]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 |
使用 |
| 字符串值 |
用于 SAML 签名的公共证书文件的绝对路径。该值不能包含逗号( |
| 字符串值 | 这是身份提供程序联系人员的公司名称。 |
| 字符串值 | 这是身份提供程序联系人员的电子邮件地址。 |
| 字符串值 | 这是身份提供程序联系人的指定名称。 |
| 字符串值 | 这是身份提供程序联系人员的姓氏。 |
| 字符串值 | 这是身份提供程序联系人的电话号码。 |
| 字符串值 | 这是最能描述身份提供程序的联系人类型。 |
| URI 值 |
这是生成 SAML 断言时使用的身份提供程序(keystone)的唯一实体标识符。生成身份提供程序元数据需要这个值,且必须是 URI (建议 URL)。例如: |
| 字符串值 | 这是身份提供程序的组织使用的语言。 |
| 字符串值 |
身份提供程序元数据文件的绝对路径。此文件应使用 |
| 字符串值 | 这是要显示的身份提供程序的组织的名称。 |
| 字符串值 | 这是身份提供程序的组织的名称。 |
| URI 值 | 这是身份提供程序机构的 URL。这里引用的 URL 对于人类有用。 |
| URI 值 |
这是接受 HTTP POST 请求的身份提供程序的单点登录(SSO)服务位置。生成身份提供程序元数据需要一个值。例如: |
| 字符串值 |
用于 SAML 签名的私钥文件的绝对路径。该值不能包含逗号( |
| 字符串值 | 生成增强客户端和代理(ECP)断言时使用的 RelayState SAML 属性的前缀。在典型的部署中,不需要更改此值。 |
| 字符串值 |
到 XML 签名的二进制文件的名称或绝对路径。虽然只支持 XML 安全库( |
7.1.38. security_compliance
下表概述了 /etc/keystone/keystone.conf
文件中的 [security_compliance]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 布尔值 |
启用此选项要求用户在创建用户时或管理重置时更改密码。在访问任何服务之前,受影响的用户必须更改其密码。要忽略特定用户(如服务用户)的这个要求,请通过更新用户 API 为所需的用户设置 |
| 整数值 |
在被视为"主动"并自动禁用(锁定)前,用户可以经过验证的最大天数。此功能默认为禁用;将任何值设置为启用它。此功能取决于 |
| 整数值 |
超过用户帐户的最大失败尝试次数(如 |
| 整数值 |
在用户帐户被 |
| 整数值 |
在用户可以更改密码之前必须使用密码的天数。这可防止用户立即更改密码,以擦除密码历史记录并重复使用旧密码。此功能不会阻止管理员手动重置密码。它默认为禁用,并允许立即更改密码。此功能取决于 |
| 整数值 |
在要求更改密码之前,密码被视为有效的天数。此功能默认为禁用。如果启用,新密码更改将具有过期日期,但现有密码不会受到影响。此功能取决于 |
| 字符串值 |
用于验证密码强度要求的正则表达式。默认情况下,正则表达式将匹配任何密码。以下是一个模式示例,它至少需要 1 个字母(1 位),且最小长度为 7 个字符: ^(?=.\\d) (?=.[a-zA-Z]).{7,}$ 此功能依赖于 |
| 字符串值 | 以人员使用的语言描述您的密码正则表达式。如果密码无法与正则表达式匹配,则此配置变量的内容将返回到用户,以解释其请求的密码不足的原因。 |
| 整数值 |
这将控制在历史记录中保留的之前用户密码迭代的数量,以便强制新创建的密码是唯一的。包含新密码的总数不应大于或等于这个值。将值设为 0 (默认值)将禁用此功能。因此,要启用此功能,值必须大于 0。此功能取决于 |
7.1.39. shadow_users
下表概述了 /etc/keystone/keystone.conf
文件中的 [shadow_users]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 |
keystone. |
7.1.40. token
下表概述了 /etc/keystone/keystone.conf
文件中的 [token]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 | 这控制了检索令牌超出内置过期时间的秒数。这允许长时间运行的操作成功。默认为 2 天。 |
| 布尔值 | 这会切换有作用域令牌是否可以到新项目或域,从而防止用户为任何其他令牌交换有作用域令牌(包括具有默认项目范围)。这会强制用户对无作用域令牌进行身份验证(稍后交换具有更具体范围的令牌的无作用域令牌)或者为每个令牌提供凭证,以避免完全被重新处理。 |
| 布尔值 |
启用将发布的令牌数据存储到令牌验证缓存中,以便第一个令牌验证实际上不会造成完整的验证周期。除非启用了全局缓存,否则此选项无效,即使 *reason:*Keystone 已公开一个用于缓存令牌的配置选项。在签发令牌时,使用单独的配置选项缓存令牌,并不必要复杂,如果令牌缓存被禁用,则误导,因为令牌在发布时仍会被预缓存。在发出时,预缓存令牌的功能将完全依赖 ''keystone.conf [token] cache' 选项。 |
| 整数值 |
缓存令牌创建和验证数据的秒数。除非启用了 global 和 |
| 布尔值 | 切换缓存令牌创建和验证数据。除非启用了全局缓存,否则这无效。 |
| 整数值 | 令牌应保持有效的时间(以秒为单位)。大幅降低这个值可能会破坏涉及多个服务协调的"长时间运行"操作,并强制用户更频繁地使用 keystone 进行身份验证。显著增加这个值将增加同时有效的令牌数量。Keystone 令牌也是 bearer 令牌,因此较短的持续时间也会降低已入侵令牌的潜在安全影响。 |
| 字符串值 |
|
| 布尔值 |
这会切换支持根据令牌标识符撤销单个令牌,因此各种令牌枚举操作(如列出向特定用户发布的所有令牌)。这些操作用于确定要考虑撤销的令牌列表。如果您使用 |
7.1.41. tokenless_auth
下表概述了 /etc/keystone/keystone.conf
文件中的 [tokenless_auth]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 字符串值 | 用于将客户端证书签发者传递给 keystone 的 WSGI 环境变量名称。此属性用作 X.509 无令牌授权的身份提供程序 ID 以及协议来查找其对应的映射。在典型的部署中,不需要更改此值。 |
| 字符串值 |
用于代表 X.509 无令牌授权的联邦协议 ID。这与 |
| 多值 |
识别允许使用 X.509 无令牌授权的客户端证书可信签发者的列表。如果没有该选项,则不被允许证书。可区分名称(DN)的值的格式必须用逗号分开,且不包含空格。此外,由于单个 DN 可能包含逗号,因此此配置选项可能会重复多次来代表多个值。例如,keystone.conf 将包含两个连续行,以信任两个不同的 DN,如 |
7.1.42. totp
下表概述了 /etc/keystone/keystone.conf
文件中的 [totp]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 | 处理 TOTP 透传码时要检查的前一个窗口数量。 |
7.1.43. trust
下表概述了 /etc/keystone/keystone.conf
文件中的 [trust]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 布尔值 |
允许从一个用户将授权重新分配给另一个用户,从而有效地将信任链接在一起。禁用后,信任的 |
| 字符串值 |
|
| 整数值 | 在信任链中,授权可以从一个用户重新分配给另一个用户的最大次数。对于特定信任,可以进一步减少这个数量。 |
7.1.44. unified_limit
下表概述了 /etc/keystone/keystone.conf
文件中的 [unified_limit]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 整数值 |
缓存统一限制数据的时间(以秒为单位)。除非启用了全局缓存和 |
| 布尔值 | 为统一限制缓存切换。除非启用了全局缓存,否则这无效。在典型的部署中,不需要禁用此功能。 |
| 字符串值 |
|
| 字符串值 | 验证与项目关联的限制时使用的强制模型。强制模型根据现有限制的不同而有所不同,这可能会导致在运行的部署中切换模型时向后兼容的更改。 |
| 整数值 | 在统一限制集合中返回的最大实体数。如果您在部署中有大量统一限制,这可能非常有用。 |
7.1.45. wsgi
下表概述了 /etc/keystone/keystone.conf
文件中的 [wsgi]
组下可用的选项。
配置选项 = 默认值 | 类型 | Description |
---|---|---|
| 布尔值 | 如果设置为 true,这将在 Keystone 中启用 oslo 调试中间件。此中间件打印有关请求和响应的大量信息。它可用于获取线(解码)上数据并传递给 WSGI 应用程序管道。此中间件对配置文件的 [DEFAULT] 部分中的"调试"设置没有影响,或者将 Keystone 的日志级别设置为"DEBUG";它专门用于调试 WSGI 数据,因为它输入并保留了 Keystone (特定的请求相关的数据)。此选项用于在 web 服务器(apache、nginx 等)和 Keystone 之间在请求和响应数据上内省。此中间件插入为中间件链中的第一个元素,并将显示与线线最接近的数据。警告:不应在生产环境中使用。此中间件可以并发出敏感/特权数据。 |