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
136 lines
4.8 KiB
Python
136 lines
4.8 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.
|
|
|
|
from keystoneauth1.loading import base
|
|
from keystoneauth1.loading import opts
|
|
|
|
_AUTH_TYPE_OPT = opts.Opt('auth_type',
|
|
deprecated=[opts.Opt('auth_plugin')],
|
|
help='Authentication type to load')
|
|
|
|
_section_help = 'Config Section from which to load plugin specific options'
|
|
_AUTH_SECTION_OPT = opts.Opt('auth_section', help=_section_help)
|
|
|
|
|
|
__all__ = ('get_common_conf_options',
|
|
'get_plugin_conf_options',
|
|
'register_conf_options',
|
|
'load_from_conf_options')
|
|
|
|
|
|
def get_common_conf_options():
|
|
"""Get the oslo_config options common for all auth plugins.
|
|
|
|
These may be useful without being registered for config file generation
|
|
or to manipulate the options before registering them yourself.
|
|
|
|
The options that are set are:
|
|
:auth_type: The name of the pluign to load.
|
|
:auth_section: The config file section to load options from.
|
|
|
|
:returns: A list of oslo_config options.
|
|
"""
|
|
return [_AUTH_TYPE_OPT._to_oslo_opt(), _AUTH_SECTION_OPT._to_oslo_opt()]
|
|
|
|
|
|
def get_plugin_conf_options(plugin):
|
|
"""Get the oslo_config options for a specific plugin.
|
|
|
|
This will be the list of config options that is registered and loaded by
|
|
the specified plugin.
|
|
|
|
:param plugin: The name of the plugin loader or a plugin loader object
|
|
:type plugin: str or keystoneauth1._loading.BaseLoader
|
|
|
|
:returns: A list of oslo_config options.
|
|
"""
|
|
try:
|
|
getter = plugin.get_options
|
|
except AttributeError:
|
|
opts = base.get_plugin_options(plugin)
|
|
else:
|
|
opts = getter()
|
|
|
|
return [o._to_oslo_opt() for o in opts]
|
|
|
|
|
|
def register_conf_options(conf, group):
|
|
"""Register the oslo_config options that are needed for a plugin.
|
|
|
|
This only registers the basic options shared by all plugins. Options that
|
|
are specific to a plugin are loaded just before they are read.
|
|
|
|
The defined options are:
|
|
|
|
- auth_type: the name of the auth plugin that will be used for
|
|
authentication.
|
|
- auth_section: the group from which further auth plugin options should be
|
|
taken. If section is not provided then the auth plugin options will be
|
|
taken from the same group as provided in the parameters.
|
|
|
|
:param conf: config object to register with.
|
|
:type conf: oslo_config.cfg.ConfigOpts
|
|
:param string group: The ini group to register options in.
|
|
"""
|
|
conf.register_opt(_AUTH_SECTION_OPT._to_oslo_opt(), group=group)
|
|
|
|
# NOTE(jamielennox): plugins are allowed to specify a 'section' which is
|
|
# the group that auth options should be taken from. If not present they
|
|
# come from the same as the base options were registered in. If present
|
|
# then the auth_plugin option may be read from that section so add that
|
|
# option.
|
|
if conf[group].auth_section:
|
|
group = conf[group].auth_section
|
|
|
|
conf.register_opt(_AUTH_TYPE_OPT._to_oslo_opt(), group=group)
|
|
|
|
|
|
def load_from_conf_options(conf, group, **kwargs):
|
|
"""Load a plugin from an oslo_config CONF object.
|
|
|
|
Each plugin will register their own required options and so there is no
|
|
standard list and the plugin should be consulted.
|
|
|
|
The base options should have been registered with register_conf_options
|
|
before this function is called.
|
|
|
|
:param conf: A conf object.
|
|
:type conf: oslo_config.cfg.ConfigOpts
|
|
:param str group: The group name that options should be read from.
|
|
|
|
:returns: An authentication Plugin or None if a name is not provided
|
|
:rtype: :class:`keystoneauth1.plugin.BaseAuthPlugin`
|
|
|
|
:raises keystoneauth1.exceptions.auth_plugins.NoMatchingPlugin:
|
|
if a plugin cannot be created.
|
|
"""
|
|
# NOTE(jamielennox): plugins are allowed to specify a 'section' which is
|
|
# the group that auth options should be taken from. If not present they
|
|
# come from the same as the base options were registered in.
|
|
if conf[group].auth_section:
|
|
group = conf[group].auth_section
|
|
|
|
name = conf[group].auth_type
|
|
if not name:
|
|
return None
|
|
|
|
plugin = base.get_plugin_loader(name)
|
|
plugin_opts = plugin.get_options()
|
|
oslo_opts = [o._to_oslo_opt() for o in plugin_opts]
|
|
|
|
conf.register_opts(oslo_opts, group=group)
|
|
|
|
def _getter(opt):
|
|
return conf[group][opt.dest]
|
|
|
|
return plugin.load_from_options_getter(_getter, **kwargs)
|