Merge pull request #1511 from jbnance/add-token_to_use-support

Issue #1510 - Initial support for ICR's 'token_to_use' feature

Author: f5-rahm

docs/userguide/connections.rst

@@ -19,6 +19,7 @@ You can, however, supply one or more of the following kwargs (defaults listed):
     port             443
     icontrol_version ''
     token            False
+    token_to_use     None
     verify           False
     auth_provider    None
     ================ =====
@@ -30,6 +31,13 @@ You can, however, supply one or more of the following kwargs (defaults listed):
         >>> from f5.bigip import ManagementRoot
         >>> mgmt = ManagementRoot('192.168.1.1.', 'user', 'pass', port=4443, token=True)
 
+.. topic:: Example: Use existing authentication token
+
+    .. code-block:: python
+
+        >>> from f5.bigip import ManagementRoot
+        >>> mgmt = ManagementRoot('192.168.1.1', 'user', 'pass', token=True, token_to_use='2PXGGMT4QR3Y3PAQEEURAPB5DJ')
+
 .. topic:: Example: Enable cert verification
 
     .. code-block:: python

f5/bigip/__init__.py

@@ -64,6 +64,7 @@ def parse_arguments(self, *args, **kwargs):
             port=kwargs.pop('port', 443),
             icontrol_version=kwargs.pop('icontrol_version', ''),
             token=kwargs.pop('token', False),
+            token_to_use=kwargs.pop('token_to_use', None),
             verify=kwargs.pop('verify', False),
             auth_provider=kwargs.pop('auth_provider', None),
             debug=kwargs.pop('debug', False)
@@ -82,7 +83,8 @@ def _get_icr_session(self, *args, **kwargs):
             username=kwargs['username'],
             password=kwargs['password'],
             timeout=kwargs['timeout'],
-            verify=kwargs['verify']
+            verify=kwargs['verify'],
+            token_to_use=kwargs['token_to_use']
         )
         if kwargs['auth_provider']:
             params['auth_provider'] = kwargs['auth_provider']