ansible/docs/docsite/rst/scenario_guides/vmware_rest_scenarios/authentication.rst
Gonéri Le Bouder c72e2ee675
import of the vmware_rest documentation (#72090)
Co-authored-by: Jill R <4121322+jillr@users.noreply.github.com>
2020-10-07 11:33:55 -04:00

47 lines
1.1 KiB
ReStructuredText

.. _vmware_rest_authentication:
*******************************************
How to configure the vmware_rest collection
*******************************************
.. contents::
:local:
Introduction
============
The vcenter_rest modules need to be authenticated. There are two different
Environment variables
=====================
.. note::
This solution requires that you call the modules from the local machine.
You need to export some environment variables in your shell before you call the modules.
.. code-block:: shell
$ export VMWARE_HOST=vcenter.test
$ export VMWARE_USER=myvcenter-user
$ export VMWARE_password=mypassword
$ ansible-playbook my-playbook.yaml
Module parameters
=================
All the vcenter_rest modules accept the following arguments:
- ``vcenter_host``
- ``vcenter_username``
- ``vcenter_password``
Ignore SSL certificate error
============================
It's common to run a test environment without a proper SSL certificate configuration.
To ignore the SSL error, you can use the ``vcenter_validate_certs: no`` argument or
``export VMWARE_VALIDATE_CERTS=no`` to set the environment variable.