keystone.resource package

Subpackages

• keystone.resource.V8_backends package
  • Submodules
  • keystone.resource.V8_backends.sql module
  • Module contents
• keystone.resource.backends package
  • Submodules
  • keystone.resource.backends.base module
  • keystone.resource.backends.sql module
  • Module contents
• keystone.resource.config_backends package
  • Submodules
  • keystone.resource.config_backends.base module
  • keystone.resource.config_backends.sql module
  • Module contents

Submodules

keystone.resource.controllers module

Workflow Logic the Resource service.

class keystone.resource.controllers.DomainConfigV3(*args, **kwargs)

Bases: keystone.common.controller.V3Controller

create_domain_config(request, *args, **kwargs)

delete_domain_config(request, *args, **kwargs)

get_domain_config(request, *args, **kwargs)

get_domain_config_default(request, *args, **kwargs)

member_name = 'config'

update_domain_config(request, *args, **kwargs)

update_domain_config_group(context, domain_id, group, config)

update_domain_config_only(context, domain_id, config)

class keystone.resource.controllers.DomainV3

Bases: keystone.common.controller.V3Controller

collection_name = 'domains'

create_domain(request, *args, **kwargs)

delete_domain(request, *args, **kwargs)

get_domain(request, *args, **kwargs)

list_domains(request, **kwargs)

member_name = 'domain'

update_domain(request, *args, **kwargs)

class keystone.resource.controllers.ProjectV3

Bases: keystone.common.controller.V3Controller

collection_name = 'projects'

create_project(request, *args, **kwargs)

delete_project(request, *args, **kwargs)

get_project(request, *args, **kwargs)

list_projects(request, **kwargs)

member_name = 'project'

update_project(request, *args, **kwargs)

class keystone.resource.controllers.Tenant(*args, **kwargs)

Bases: keystone.common.controller.V2Controller

create_project(*args, **kwargs)

delete_project(*args, **kwargs)

get_all_projects(*args, **kwargs)

Get a list of all tenants for an admin user.

get_project(*args, **kwargs)

update_project(*args, **kwargs)

keystone.resource.core module

Main entry point into the Resource service.

class keystone.resource.core.DomainConfigDriverV8(*args, **kwargs)

Bases: keystone.resource.config_backends.base.DomainConfigDriverV8

class keystone.resource.core.DomainConfigManager(*args, **kwargs)

Bases: keystone.common.manager.Manager

Default pivot point for the Domain Config backend.

create_config(*args, **kwargs)

Create config for a domain.

Parameters:

• domain_id – the domain in question
• config – the dict of config groups/options to assign to the domain

Creates a new config, overwriting any previous config (no Conflict error will be generated).

Returns:a dict of group dicts containing the options, with any that are sensitive removed Raises keystone.exception.InvalidDomainConfig:  when the config contains options we do not support

delete_config(*args, **kwargs)

Delete config, or partial config, for the domain.

Parameters:

• domain_id – the domain in question
• group – an optional specific group of options
• option – an optional specific option within the group

If group and option are None, then the entire config for the domain is deleted. If group is not None, then just that group of options will be deleted. If group and option are both specified, then just that option is deleted.

Raises keystone.exception.InvalidDomainConfig:  when group/option parameters specify an option we do not support or one that does not exist in the original config.

driver_namespace = 'keystone.resource.domain_config'

get_config(*args, **kwargs)

Get config, or partial config, for a domain.

Parameters:

• domain_id – the domain in question
• group – an optional specific group of options
• option – an optional specific option within the group

Returns:

a dict of group dicts containing the whitelisted options, filtered by group and option specified

Raises:

• keystone.exception.DomainConfigNotFound – when no config found that matches domain_id, group and option specified
• keystone.exception.InvalidDomainConfig – when the config and group/option parameters specify an option we do not support

An example response:

{
    'ldap': {
        'url': 'myurl'
        'user_tree_dn': 'OU=myou'},
    'identity': {
        'driver': 'ldap'}

}

get_config_default(*args, **kwargs)

Get default config, or partial default config.

Parameters:

• group – an optional specific group of options
• option – an optional specific option within the group

Returns:

a dict of group dicts containing the default options, filtered by group and option if specified

Raises keystone.exception.InvalidDomainConfig:  

when the config and group/option parameters specify an option we do not support (or one that is not whitelisted).

An example response:

{
    'ldap': {
        'url': 'myurl',
        'user_tree_dn': 'OU=myou',
        ....},
    'identity': {
        'driver': 'ldap'}

}

get_config_with_sensitive_info(*args, **kwargs)

Get config for a domain with sensitive info included.

This method is not exposed via the public API, but is used by the identity manager to initialize a domain with the fully formed config options.

sensitive_options = {'ldap': ['password'], 'identity': []}

update_config(*args, **kwargs)

Update config, or partial config, for a domain.

Parameters:

• domain_id – the domain in question
• config – the config dict containing and groups/options being updated
• group – an optional specific group of options, which if specified must appear in config, with no other groups
• option – an optional specific option within the group, which if specified must appear in config, with no other options

The contents of the supplied config will be merged with the existing config for this domain, updating or creating new options if these did not previously exist. If group or option is specified, then the update will be limited to those specified items and the inclusion of other options in the supplied config will raise an exception, as will the situation when those options do not already exist in the current config.

Returns:a dict of groups containing all whitelisted options Raises keystone.exception.InvalidDomainConfig:  when the config and group/option parameters specify an option we do not support or one that does not exist in the original config

whitelisted_options = {'ldap': ['url', 'user', 'suffix', 'use_dumb_member', 'dumb_member', 'allow_subtree_delete', 'query_scope', 'page_size', 'alias_dereferencing', 'debug_level', 'chase_referrals', 'user_tree_dn', 'user_filter', 'user_objectclass', 'user_id_attribute', 'user_name_attribute', 'user_mail_attribute', 'user_description_attribute', 'user_pass_attribute', 'user_enabled_attribute', 'user_enabled_invert', 'user_enabled_mask', 'user_enabled_default', 'user_attribute_ignore', 'user_default_project_id_attribute', 'user_allow_create', 'user_allow_update', 'user_allow_delete', 'user_enabled_emulation', 'user_enabled_emulation_dn', 'user_enabled_emulation_use_group_config', 'user_additional_attribute_mapping', 'group_tree_dn', 'group_filter', 'group_objectclass', 'group_id_attribute', 'group_name_attribute', 'group_member_attribute', 'group_desc_attribute', 'group_attribute_ignore', 'group_allow_create', 'group_allow_update', 'group_allow_delete', 'group_additional_attribute_mapping', 'tls_cacertfile', 'tls_cacertdir', 'use_tls', 'tls_req_cert', 'use_pool', 'pool_size', 'pool_retry_max', 'pool_retry_delay', 'pool_connection_timeout', 'pool_connection_lifetime', 'use_auth_pool', 'auth_pool_size', 'auth_pool_connection_lifetime'], 'identity': ['driver', 'list_limit']}

class keystone.resource.core.Manager(*args, **kwargs)

Bases: keystone.common.manager.Manager

Default pivot point for the Resource backend.

See keystone.common.manager.Manager for more details on how this dynamically calls the backend.

assert_domain_enabled(*args, **kwargs)

Assert the Domain is enabled.

Raises AssertionError:  if domain is disabled.

assert_domain_not_federated(*args, **kwargs)

Assert the Domain’s name and id do not match the reserved keyword.

Note that the reserved keyword is defined in the configuration file, by default, it is ‘Federated’, it is also case insensitive. If config’s option is empty the default hardcoded value ‘Federated’ will be used.

Raises AssertionError:  if domain named match the value in the config.

assert_project_enabled(*args, **kwargs)

Assert the project is enabled and its associated domain is enabled.

Raises AssertionError:  if the project or domain is disabled.

create_domain(*args, **kwargs)

create_project(*args, **kwargs)

delete_domain(*args, **kwargs)

delete_project(*args, **kwargs)

Delete one project or a subtree.

Parameters:

cascade (boolean) – If true, the specified project and all its sub-projects are deleted. Otherwise, only the specified project is deleted.

Raises:

• keystone.exception.ValidationError – if project is a domain
• keystone.exception.Forbidden – if project is not a leaf

driver_namespace = 'keystone.resource'

ensure_default_domain_exists(*args, **kwargs)

Create the default domain if it doesn’t exist.

This is only used for the v2 API and can go away when V2 does.

get_domain(*args, **kwargs)

get_domain_by_name(*args, **kwargs)

get_project(*args, **kwargs)

get_project_by_name(*args, **kwargs)

get_project_parents_as_ids(*args, **kwargs)

Get the IDs from the parents from a given project.

The project IDs are returned as a structured dictionary traversing up the hierarchy to the top level project. For example, considering the following project hierarchy:

  A
  |
+-B-+
|   |
C   D

If we query for project C parents, the expected return is the following dictionary:

'parents': {
    B['id']: {
        A['id']: None
    }
}

get_projects_in_subtree_as_ids(*args, **kwargs)

Get the IDs from the projects in the subtree from a given project.

The project IDs are returned as a structured dictionary representing their hierarchy. For example, considering the following project hierarchy:

  A
  |
+-B-+
|   |
C   D

If we query for project A subtree, the expected return is the following dictionary:

'subtree': {
    B['id']: {
        C['id']: None,
        D['id']: None
    }
}

list_domains(*args, **kwargs)

list_domains_from_ids(*args, **kwargs)

List domains for the provided list of ids.

Parameters:domain_ids – list of ids Returns:a list of domain_refs.

This method is used internally by the assignment manager to bulk read a set of domains given their ids.

list_project_parents(*args, **kwargs)

list_projects(*args, **kwargs)

list_projects_acting_as_domain(*args, **kwargs)

list_projects_in_domain(*args, **kwargs)

list_projects_in_subtree(*args, **kwargs)

update_domain(*args, **kwargs)

update_project(*args, **kwargs)

class keystone.resource.core.ResourceDriverBase(*args, **kwargs)

Bases: keystone.resource.backends.base.ResourceDriverBase

class keystone.resource.core.ResourceDriverV8(*args, **kwargs)

Bases: keystone.resource.backends.base.ResourceDriverV8

class keystone.resource.core.ResourceDriverV9(*args, **kwargs)

Bases: keystone.resource.backends.base.ResourceDriverV9

class keystone.resource.core.V9ResourceWrapperForV8Driver(*args, **kwargs)

Bases: keystone.resource.backends.base.V9ResourceWrapperForV8Driver

keystone.resource.routers module

WSGI Routers for the Resource service.

class keystone.resource.routers.Admin(mapper=None)

Bases: keystone.common.wsgi.ComposableRouter

add_routes(mapper)

class keystone.resource.routers.Routers

Bases: keystone.common.wsgi.RoutersBase

append_v3_routers(mapper, routers)

keystone.resource.schema module

Module contents