红帽全球峰会2.2. Authentication
具有 Red Hat Virtualization Manager 帐户的任何用户都可以访问该 API。所有请求都必须使用 OAuth 或基本身份验证进行身份验证，如下所述。
2.2.1. OAuth 身份验证
自 Red Hat Virtualization 版本 4.0 起，首选身份验证机制为 OAuth 2.0，如 RFC 6749 所述。
OAuth 是一种复杂的协议，具有多种获取授权和访问令牌的机制。与 Red Hat Virtualization API 一起使用，唯一支持的是 Resource Owner Password Credentials Grant，如 RFC 6749 的 4.3 节所述。
您必须首先获取令牌，将用户名和密码发送到 Red Hat Virtualization Manager 单点登录服务：
POST /ovirt-engine/sso/oauth/token HTTP/1.1 Host: myengine.example.com Content-Type: application/x-www-form-urlencoded Accept: application/json
POST /ovirt-engine/sso/oauth/token HTTP/1.1
Host: myengine.example.com
Content-Type: application/x-www-form-urlencoded
Accept: application/json
请求正文必须包含 grant_type、scope、username 和 password 参数：
| 名称 | 值 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
这些参数必须经过 URL 编码。例如，用户名中的 @ 字符需要编码为 %40。生成的请求正文将类似如下：
grant_type=password&scope=ovirt-app-api&username=admin%40internal&password=mypassword
grant_type=password&scope=ovirt-app-api&username=admin%40internal&password=mypassword
在 OAuth RFC 中，scope 参数被描述为可选，但在将它与 Red Hat Virtualization API 搭配使用时，它的值必须是 ovirt-app-api。
如果用户名和密码有效，Red Hat Virtualization Manager 单点登录服务将使用类似本文档的 JSON 文档进行响应：
出于 API 身份验证目的，唯一相关的名称/值对是 access_token。不要以任何方式操作；使用它与 SSO 服务提供的完全相同。
获取令牌后，它可用于通过在 HTTP 授权 标头中包含和使用 Bearer 方案来对 API 执行请求。例如，要获取虚拟机列表，请发送如下请求：
GET /ovirt-engine/api/vms HTTP/1.1 Host: myengine.example.com Accept: application/xml Authorization: Bearer fqbR1ftzh8wBCviLxJcYuV5oSDI=
GET /ovirt-engine/api/vms HTTP/1.1
Host: myengine.example.com
Accept: application/xml
Authorization: Bearer fqbR1ftzh8wBCviLxJcYuV5oSDI=该令牌可以多次用于多个请求，但它最终会过期。当它过期时，服务器将使用 401 HTTP 响应代码拒绝请求：
HTTP/1.1 401 Unauthorized
HTTP/1.1 401 Unauthorized当发生这种情况时，需要一个新的令牌，因为 Red Hat Virtualization Manager 单点登录服务目前不支持刷新令牌。可以使用上述相同方法请求新的令牌。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}