3.4. OAuth 身份验证概述

作为基本身份验证的替代选择，您可以使用有限的 OAuth 1.0 身份验证。这有时被称为协议 1.0a 中的1分支 OAuth。

要查看 Satellite Web UI 中的 OAuth 设置，请导航至 Administer > Settings > Authentication。OAuth 使用者密钥是 供所有 OAuth 客户端使用的令牌。

Satellite 将 OAuth 设置存储在 /etc/foreman/settings.yaml 文件中。使用 satellite-installer 脚本配置这些设置，因为 Satellite 在升级时会覆盖对此文件的任何手动更改。

3.4.1. 配置 OAuth

要更改 OAuth 设置，请使用所需选项输入 satellite-installer。输入以下命令列出所有 OAuth 相关安装程序选项： 

# satellite-installer --full-help | grep oauth

启用 OAuth 映射

默认情况下，Satellite 将所有 OAuth API 请求授权为内置的匿名 API 管理员帐户。因此，API 响应包括所有 Satellite 数据。但是，您也可以指定Foreman 用户发出请求并限制对该用户的数据访问。

要启用 OAuth 用户映射，请输入以下命令： 

# satellite-installer --foreman-oauth-map-users true
重要

卫星没有为 OAuth 请求中的标头签名。具有有效使用者键的任何人都可以模拟任何 Foreman 用户。

3.4.2. OAuth 请求格式

每个 OAuth API 请求都需要一个带有现有 Foreman 用户的登录和 Authorization 标头的 FOREMAN-USER 标头，格式为： 

--header 'FOREMAN-USER: sat_username' \
--header 'Authorization: OAuth oauth_version="1.0",oauth_consumer_key="secretkey",oauth_signature_method="hmac-sha1",oauth_timestamp=timestamp,oauth_signature=signature'
重要

使用 OAuth 客户端库构建所有 OAuth 参数。有关使用 requests_oauthlib Python 模块的示例，请参阅红帽知识库中的 如何通过 Red Hat Satellite 6 中的 python 脚本使用 OAuth 身份验证方法执行 API 调用。

示例

本例列出了使用 OAuth 进行身份验证的架构。请求在 FOREMAN-USER 标头中使用 sat_username 用户名。当 --foreman-oauth-map-users 被设置为 true 时，响应仅包含用户有权访问的构架。签名反映了每个参数、HTTP 方法和 URI 更改。

请求示例： 

$ curl 'https://satellite.example.com/api/architectures' \
--header 'Content-Type: application/json' \
--header 'Accept:application/json' \
--header 'FOREMAN-USER: sat_username' \
--header 'Authorization: OAuth oauth_version="1.0",oauth_consumer_key="secretkey",oauth_signature_method="hmac-sha1",oauth_timestamp=1321473112,oauth_signature=Il8hR8/ogj/XVuOqMPB9qNjSy6E='

其他资源