417f2238ae
Several of these docstrings were referring to classes that didn't exist. For example, they referenced keystonauth which doesn't exist and is supposed to be keystoneauth1. Change-Id: I070d32937c11b111f1821c466e8dfe55caadd748
182 lines
7.1 KiB
Python
182 lines
7.1 KiB
Python
# Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
# not use this file except in compliance with the License. You may obtain
|
|
# a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
# License for the specific language governing permissions and limitations
|
|
# under the License.
|
|
|
|
import abc
|
|
|
|
import six
|
|
import six.moves.urllib.parse as urlparse
|
|
|
|
from keystoneauth1 import _utils as utils
|
|
from keystoneauth1 import discover
|
|
from keystoneauth1 import exceptions
|
|
from keystoneauth1.identity import base
|
|
|
|
|
|
LOG = utils.get_logger(__name__)
|
|
|
|
|
|
@six.add_metaclass(abc.ABCMeta)
|
|
class BaseGenericPlugin(base.BaseIdentityPlugin):
|
|
"""An identity plugin that is not version dependant.
|
|
|
|
Internally we will construct a version dependant plugin with the resolved
|
|
URL and then proxy all calls from the base plugin to the versioned one.
|
|
"""
|
|
|
|
def __init__(self, auth_url,
|
|
tenant_id=None,
|
|
tenant_name=None,
|
|
project_id=None,
|
|
project_name=None,
|
|
project_domain_id=None,
|
|
project_domain_name=None,
|
|
domain_id=None,
|
|
domain_name=None,
|
|
trust_id=None,
|
|
default_domain_id=None,
|
|
default_domain_name=None):
|
|
super(BaseGenericPlugin, self).__init__(auth_url=auth_url)
|
|
|
|
self._project_id = project_id or tenant_id
|
|
self._project_name = project_name or tenant_name
|
|
self._project_domain_id = project_domain_id
|
|
self._project_domain_name = project_domain_name
|
|
self._domain_id = domain_id
|
|
self._domain_name = domain_name
|
|
self._trust_id = trust_id
|
|
self._default_domain_id = default_domain_id
|
|
self._default_domain_name = default_domain_name
|
|
|
|
self._plugin = None
|
|
|
|
@abc.abstractmethod
|
|
def create_plugin(self, session, version, url, raw_status=None):
|
|
"""Create a plugin from the given parameters.
|
|
|
|
This function will be called multiple times with the version and url
|
|
of a potential endpoint. If a plugin can be constructed that fits the
|
|
params then it should return it. If not return None and then another
|
|
call will be made with other available URLs.
|
|
|
|
:param session: A session object.
|
|
:type session: keystoneauth1.session.Session
|
|
:param tuple version: A tuple of the API version at the URL.
|
|
:param str url: The base URL for this version.
|
|
:param str raw_status: The status that was in the discovery field.
|
|
|
|
:returns: A plugin that can match the parameters or None if nothing.
|
|
"""
|
|
return None
|
|
|
|
@property
|
|
def _has_domain_scope(self):
|
|
"""Are there domain parameters.
|
|
|
|
Domain parameters are v3 only so returns if any are set.
|
|
|
|
:returns: True if a domain parameter is set, false otherwise.
|
|
"""
|
|
return any([self._domain_id, self._domain_name,
|
|
self._project_domain_id, self._project_domain_name])
|
|
|
|
@property
|
|
def _v2_params(self):
|
|
"""Parameters that are common to v2 plugins."""
|
|
return {'trust_id': self._trust_id,
|
|
'tenant_id': self._project_id,
|
|
'tenant_name': self._project_name}
|
|
|
|
@property
|
|
def _v3_params(self):
|
|
"""Parameters that are common to v3 plugins."""
|
|
pr_domain_id = self._project_domain_id or self._default_domain_id
|
|
pr_domain_name = self._project_domain_name or self._default_domain_name
|
|
|
|
return {'trust_id': self._trust_id,
|
|
'project_id': self._project_id,
|
|
'project_name': self._project_name,
|
|
'project_domain_id': pr_domain_id,
|
|
'project_domain_name': pr_domain_name,
|
|
'domain_id': self._domain_id,
|
|
'domain_name': self._domain_name}
|
|
|
|
def _do_create_plugin(self, session):
|
|
plugin = None
|
|
|
|
try:
|
|
disc = self.get_discovery(session,
|
|
self.auth_url,
|
|
authenticated=False)
|
|
except (exceptions.DiscoveryFailure,
|
|
exceptions.HttpError,
|
|
exceptions.ConnectionError):
|
|
LOG.warning('Discovering versions from the identity service '
|
|
'failed when creating the password plugin. '
|
|
'Attempting to determine version from URL.')
|
|
|
|
url_parts = urlparse.urlparse(self.auth_url)
|
|
path = url_parts.path.lower()
|
|
|
|
if path.startswith('/v2.0'):
|
|
if self._has_domain_scope:
|
|
raise exceptions.DiscoveryFailure(
|
|
'Cannot use v2 authentication with domain scope')
|
|
plugin = self.create_plugin(session, (2, 0), self.auth_url)
|
|
elif path.startswith('/v3'):
|
|
plugin = self.create_plugin(session, (3, 0), self.auth_url)
|
|
|
|
else:
|
|
# NOTE(jamielennox): version_data is always in oldest to newest
|
|
# order. This is fine normally because we explicitly skip v2 below
|
|
# if there is domain data present. With default_domain params
|
|
# though we want a v3 plugin if available and fall back to v2 so we
|
|
# have to process in reverse order. FIXME(jamielennox): if we ever
|
|
# go for another version we should reverse this logic as we always
|
|
# want to favour the newest available version.
|
|
reverse = self._default_domain_id or self._default_domain_name
|
|
disc_data = disc.version_data(reverse=bool(reverse))
|
|
|
|
v2_with_domain_scope = False
|
|
for data in disc_data:
|
|
version = data['version']
|
|
|
|
if (discover.version_match((2,), version) and
|
|
self._has_domain_scope):
|
|
# NOTE(jamielennox): if there are domain parameters there
|
|
# is no point even trying against v2 APIs.
|
|
v2_with_domain_scope = True
|
|
continue
|
|
|
|
plugin = self.create_plugin(session,
|
|
version,
|
|
data['url'],
|
|
raw_status=data['raw_status'])
|
|
|
|
if plugin:
|
|
break
|
|
if not plugin and v2_with_domain_scope:
|
|
raise exceptions.DiscoveryFailure(
|
|
'Cannot use v2 authentication with domain scope')
|
|
|
|
if plugin:
|
|
return plugin
|
|
|
|
# so there were no URLs that i could use for auth of any version.
|
|
raise exceptions.DiscoveryFailure('Could not determine a suitable URL '
|
|
'for the plugin')
|
|
|
|
def get_auth_ref(self, session, **kwargs):
|
|
if not self._plugin:
|
|
self._plugin = self._do_create_plugin(session)
|
|
|
|
return self._plugin.get_auth_ref(session, **kwargs)
|