Аутентификация в API VMware Cloud Director
Для работы с API необходимо:
добавить полученный токен во все запросы сессии.
Запрос версий API
Получите актуальную версию API и URL для создание сессии.
- Запрос
Отправьте GET-запрос на https://{SITE}/api/versions.
{SITE} — зависит от региона, в котором размещается ваш виртуальный ЦОД. Он отображается в ссылке на VMware Cloud Director https://{SITE}/tenant/my-tenant/. Ее мы отправляем при подключении услуги. Например, для региона PD01 параметр {SITE} принимает значение vcd01-01.cloud.ru, для PD11 — vcd11-01.cloud.ru.
curl -k --request GET "https://{SITE}/api/versions"
Создание сессии
Ниже рассмотрен способ создания сессии с помощью указания логина и пароля для доступа к тенанту. Вы также можете сгенерировать специальный токен API, чтобы не вводить учетные данные каждый раз при создании сессии. Подробнее — API Token.
Чтобы создать сессию и получить токен необходимо знать:
{VERSION} — номер версии API из предыдущего шага.
{LOGINURL} — URL для создания сессии из предыдущего шага.
tenant_name — название тенанта, которое можно посмотреть в URL-адресе для входа в VMware Cloud Director https://vcd01-01.cloud.ru/tenant/{tenant_name}.
user — логин для входа в VMware Cloud Director.
password — пароль для входа в VMware Cloud Director.
Данные для входа в VMware Cloud Director мы отправляем при подключении услуги.
- Запрос
Basic / Basic Auth — тип аутентификации.
{CREDENTIALS} — учетные данные для доступа к VMware Cloud Director в формате user@tenant_name:password в кодировке MIME Base64.
Чтобы получить {CREDENTIALS} вы можете воспользоваться любым инструментом для перевода из текстового формата в MIME Base64.
В поле Type выберите «Basic Auth».
В поле Username укажите логин и название тенанта в формате user@tenant_name.
В поле Password укажите пароль.
Отправьте POST-запрос на {LOGINURL}.
curl --location --request POST '{LOGINURL}' --header 'Accept: application/json;version={VERSION}' --header 'Authorization: {CREDENTIALS}'
Для формирования заголовка Authorization удобно использовать Postman, поскольку не нужно отдельно переводить данные в формат MIME Base64. На вкладке Authorization:
Чтобы скопировать полученный заголовок Authorization, откройте код запроса.