'''

Created on Sep 18, 2009

@author: sgallagh

'''

import os

import gettext

import exceptions

from ipachangeconf import SSSDChangeConf

# Exceptions

class SSSDConfigException(Exception): pass

class ParsingError(Exception): pass

class AlreadyInitializedError(SSSDConfigException): pass

class NotInitializedError(SSSDConfigException): pass

class NoOutputFileError(SSSDConfigException): pass

class NoServiceError(SSSDConfigException): pass

class NoSectionError(SSSDConfigException): pass

class NoOptionError(SSSDConfigException): pass

class ServiceNotRecognizedError(SSSDConfigException): pass

class ServiceAlreadyExists(SSSDConfigException): pass

class NoDomainError(SSSDConfigException): pass

class DomainNotRecognized(SSSDConfigException): pass

class DomainAlreadyExistsError(SSSDConfigException): pass

class NoSuchProviderError(SSSDConfigException): pass

class NoSuchProviderSubtypeError(SSSDConfigException): pass

class ProviderSubtypeInUse(SSSDConfigException): pass

PACKAGE = 'sss_daemon'

LOCALEDIR = '/usr/share/locale'

translation = gettext.translation(PACKAGE, LOCALEDIR, fallback=True)

_ = translation.ugettext

# TODO: This needs to be made external

option_strings = {

# [service]

'debug_level' : _('Set the verbosity of the debug logging'),

'debug_timestamps' : _('Include timestamps in debug logs'),

'debug_microseconds' : _('Include microseconds in timestamps in debug logs'),

'debug_to_files' : _('Write debug messages to logfiles'),

'timeout' : _('Ping timeout before restarting service'),

'force_timeout' : _('Timeout between three failed ping checks and forcibly killing the service'),

'command' : _('Command to start service'),

'reconnection_retries' : _('Number of times to attempt connection to Data Providers'),

'fd_limit' : _('The number of file descriptors that may be opened by this responder'),

'client_idle_timeout' : _('Idle time before automatic disconnection of a client'),

# [sssd]

'services' : _('SSSD Services to start'),

'domains' : _('SSSD Domains to start'),

'sbus_timeout' : _('Timeout for messages sent over the SBUS'),

're_expression' : _('Regex to parse username and domain'),

'full_name_format' : _('Printf-compatible format for displaying fully-qualified names'),

'krb5_rcache_dir' : _('Directory on the filesystem where SSSD should store Kerberos replay cache files.'),

'default_domain_suffix' : _('Domain to add to names without a domain component.'),

# [nss]

'enum_cache_timeout' : _('Enumeration cache timeout length (seconds)'),

'entry_cache_no_wait_timeout' : _('Entry cache background update timeout length (seconds)'),

'entry_negative_timeout' : _('Negative cache timeout length (seconds)'),

'filter_users' : _('Users that SSSD should explicitly ignore'),

'filter_groups' : _('Groups that SSSD should explicitly ignore'),

'filter_users_in_groups' : _('Should filtered users appear in groups'),

'pwfield' : _('The value of the password field the NSS provider should return'),

'override_homedir' : _('Override homedir value from the identity provider with this value'),

'fallback_homedir' : _('Substitute empty homedir value from the identity provider with this value'),

'override_shell': _('Override shell value from the identity provider with this value'),

'allowed_shells' : _('The list of shells users are allowed to log in with'),

'vetoed_shells' : _('The list of shells that will be vetoed, and replaced with the fallback shell'),

'shell_fallback' : _('If a shell stored in central directory is allowed but not available, use this fallback'),

'default_shell': _('Shell to use if the provider does not list one'),

'memcache_timeout': _('How long will be in-memory cache records valid'),

# [pam]

'offline_credentials_expiration' : _('How long to allow cached logins between online logins (days)'),

'offline_failed_login_attempts' : _('How many failed logins attempts are allowed when offline'),

'offline_failed_login_delay' : _('How long (minutes) to deny login after offline_failed_login_attempts has been reached'),

'pam_verbosity' : _('What kind of messages are displayed to the user during authentication'),

'pam_id_timeout' : _('How many seconds to keep identity information cached for PAM requests'),

'pam_pwd_expiration_warning' : _('How many days before password expiration a warning should be displayed'),

# [sudo]

'sudo_timed' : _('Whether to evaluate the time-based attributes in sudo rules'),

# [autofs]

'autofs_negative_timeout' : _('Negative cache timeout length (seconds)'),

# [ssh]

'ssh_hash_known_hosts': _('Whether to hash host names and addresses in the known_hosts file'),

'ssh_known_hosts_timeout': _('How many seconds to keep a host in the known_hosts file after its host keys were requested'),

# [pac]

'allowed_uids': _('List of UIDs or user names allowed to access the PAC responder'),

# [provider]

'id_provider' : _('Identity provider'),

'auth_provider' : _('Authentication provider'),

'access_provider' : _('Access control provider'),

'chpass_provider' : _('Password change provider'),

'sudo_provider' : _('SUDO provider'),

'autofs_provider' : _('Autofs provider'),

'session_provider' : _('Session-loading provider'),

'hostid_provider' : _('Host identity provider'),

# [domain]

'min_id' : _('Minimum user ID'),

'max_id' : _('Maximum user ID'),

'enumerate' : _('Enable enumerating all users/groups'),

'cache_credentials' : _('Cache credentials for offline login'),

'store_legacy_passwords' : _('Store password hashes'),

'use_fully_qualified_names' : _('Display users/groups in fully-qualified form'),

'ignore_group_members' : _('Don\'t include group members in group lookups'),

'entry_cache_timeout' : _('Entry cache timeout length (seconds)'),

'lookup_family_order' : _('Restrict or prefer a specific address family when performing DNS lookups'),

'account_cache_expiration' : _('How long to keep cached entries after last successful login (days)'),

'dns_resolver_timeout' : _('How long to wait for replies from DNS when resolving servers (seconds)'),

'dns_discovery_domain' : _('The domain part of service discovery DNS query'),

'override_gid' : _('Override GID value from the identity provider with this value'),

'case_sensitive' : _('Treat usernames as case sensitive'),

'entry_cache_user_timeout' : _('Entry cache timeout length (seconds)'),

'entry_cache_group_timeout' : _('Entry cache timeout length (seconds)'),

'entry_cache_netgroup_timeout' : _('Entry cache timeout length (seconds)'),

'entry_cache_service_timeout' : _('Entry cache timeout length (seconds)'),

'entry_cache_autofs_timeout' : _('Entry cache timeout length (seconds)'),

'entry_cache_sudo_timeout' : _('Entry cache timeout length (seconds)'),

'refresh_expired_interval' : _('How often should expired entries be refreshed in background'),

'dyndns_update' : _("Whether to automatically update the client's DNS entry"),

'dyndns_ttl' : _("The TTL to apply to the client's DNS entry after updating it"),

'dyndns_iface' : _("The interface whose IP should be used for dynamic DNS updates"),

'dyndns_refresh_interval' : _("How often to periodically update the client's DNS entry"),

'dyndns_update_ptr' : _("Whether the provider should explicitly update the PTR record as well"),

'dyndns_force_tcp' : _("Whether the nsupdate utility should default to using TCP"),

'dyndns_auth' : _("What kind of authentication should be used to perform the DNS update"),

# [provider/ipa]

'ipa_domain' : _('IPA domain'),

'ipa_server' : _('IPA server address'),

'ipa_backup_server' : _('Address of backup IPA server'),

'ipa_hostname' : _('IPA client hostname'),

'ipa_dyndns_update' : _("Whether to automatically update the client's DNS entry in FreeIPA"),

'ipa_dyndns_ttl' : _("The TTL to apply to the client's DNS entry after updating it"),

'ipa_dyndns_iface' : _("The interface whose IP should be used for dynamic DNS updates"),

'ipa_hbac_search_base' : _("Search base for HBAC related objects"),

'ipa_hbac_refresh' : _("The amount of time between lookups of the HBAC rules against the IPA server"),

'ipa_selinux_refresh' : _("The amount of time in seconds between lookups of the SELinux maps against the IPA server"),

'ipa_hbac_treat_deny_as' : _("If DENY rules are present, either DENY_ALL or IGNORE"),

'ipa_hbac_support_srchost' : _("If set to false, host argument given by PAM will be ignored"),

'ipa_automount_location' : _("The automounter location this IPA client is using"),

'ipa_master_domain_search_base': _("Search base for object containing info about IPA domain"),

'ipa_ranges_search_base': _("Search base for objects containing info about ID ranges"),

'ipa_enable_dns_sites': _("Enable DNS sites - location based service discovery"),

# [provider/ad]

'ad_domain' : _('Active Directory domain'),

'ad_server' : _('Active Directory server address'),

'ad_backup_server' : _('Active Directory backup server address'),

'ad_hostname' : _('Active Directory client hostname'),

'ad_enable_dns_sites' : _('Enable DNS sites - location based service discovery'),

# [provider/krb5]

'krb5_kdcip' : _('Kerberos server address'),

'krb5_server' : _('Kerberos server address'),

'krb5_backup_server' : _('Kerberos backup server address'),

'krb5_realm' : _('Kerberos realm'),

'krb5_auth_timeout' : _('Authentication timeout'),

'krb5_use_kdcinfo' : _('Whether to create kdcinfo files'),

# [provider/krb5/auth]

'krb5_ccachedir' : _('Directory to store credential caches'),

'krb5_ccname_template' : _("Location of the user's credential cache"),

'krb5_keytab' : _("Location of the keytab to validate credentials"),

'krb5_validate' : _("Enable credential validation"),

'krb5_store_password_if_offline' : _("Store password if offline for later online authentication"),

'krb5_renewable_lifetime' : _("Renewable lifetime of the TGT"),

'krb5_lifetime' : _("Lifetime of the TGT"),

'krb5_renew_interval' : _("Time between two checks for renewal"),

'krb5_use_fast' : _("Enables FAST"),

'krb5_fast_principal' : _("Selects the principal to use for FAST"),

'krb5_canonicalize' : _("Enables principal canonicalization"),

'krb5_use_enterprise_principal' : _("Enables enterprise principals"),

# [provider/krb5/chpass]

'krb5_kpasswd' : _('Server where the change password service is running if not on the KDC'),

'krb5_backup_kpasswd' : _('Server where the change password service is running if not on the KDC'),

# [provider/ldap]

'ldap_uri' : _('ldap_uri, The URI of the LDAP server'),

'ldap_backup_uri' : _('ldap_backup_uri, The URI of the LDAP server'),

'ldap_search_base' : _('The default base DN'),

'ldap_schema' : _('The Schema Type in use on the LDAP server, rfc2307'),

'ldap_default_bind_dn' : _('The default bind DN'),

'ldap_default_authtok_type' : _('The type of the authentication token of the default bind DN'),

'ldap_default_authtok' : _('The authentication token of the default bind DN'),

'ldap_network_timeout' : _('Length of time to attempt connection'),

'ldap_opt_timeout' : _('Length of time to attempt synchronous LDAP operations'),

'ldap_offline_timeout' : _('Length of time between attempts to reconnect while offline'),

'ldap_force_upper_case_realm' : _('Use only the upper case for realm names'),

'ldap_tls_cacert' : _('File that contains CA certificates'),

'ldap_tls_cacertdir' : _('Path to CA certificate directory'),

'ldap_tls_cert' : _('File that contains the client certificate'),

'ldap_tls_key' :_('File that contains the client key'),

'ldap_tls_cipher_suite' :_('List of possible ciphers suites'),

'ldap_tls_reqcert' : _('Require TLS certificate verification'),

'ldap_sasl_mech' : _('Specify the sasl mechanism to use'),

'ldap_sasl_authid' : _('Specify the sasl authorization id to use'),

'ldap_sasl_realm' : _('Specify the sasl authorization realm to use'),

'ldap_sasl_minssf' : _('Specify the minimal SSF for LDAP sasl authorization'),

'ldap_krb5_keytab' : _('Kerberos service keytab'),

'ldap_krb5_init_creds' : _('Use Kerberos auth for LDAP connection'),

'ldap_referrals' : _('Follow LDAP referrals'),

'ldap_krb5_ticket_lifetime' : _('Lifetime of TGT for LDAP connection'),

'ldap_deref' : _('How to dereference aliases'),

'ldap_dns_service_name' : _('Service name for DNS service lookups'),

'ldap_page_size' : _('The number of records to retrieve in a single LDAP query'),

'ldap_deref_threshold' : _('The number of members that must be missing to trigger a full deref'),

'ldap_sasl_canonicalize' : _('Whether the LDAP library should perform a reverse lookup to canonicalize the host name during a SASL bind'),

'ldap_entry_usn' : _('entryUSN attribute'),

'ldap_rootdse_last_usn' : _('lastUSN attribute'),

'ldap_connection_expiration_timeout' : _('How long to retain a connection to the LDAP server before disconnecting'),

'ldap_disable_paging' : _('Disable the LDAP paging control'),

'ldap_disable_range_retrieval' : _('Disable Active Directory range retrieval'),

# [provider/ldap/id]

'ldap_search_timeout' : _('Length of time to wait for a search request'),

'ldap_enumeration_search_timeout' : _('Length of time to wait for a enumeration request'),

'ldap_enumeration_refresh_timeout' : _('Length of time between enumeration updates'),

'ldap_purge_cache_timeout' : _('Length of time between cache cleanups'),

'ldap_id_use_start_tls' : _('Require TLS for ID lookups'),

'ldap_id_mapping' : _('Use ID-mapping of objectSID instead of pre-set IDs'),

'ldap_user_search_base' : _('Base DN for user lookups'),

'ldap_user_search_scope' : _('Scope of user lookups'),

'ldap_user_search_filter' : _('Filter for user lookups'),

'ldap_user_object_class' : _('Objectclass for users'),

'ldap_user_name' : _('Username attribute'),

#not used # 'ldap_user_pwd' :_('Password attribute'),

'ldap_user_uid_number' : _('UID attribute'),

'ldap_user_gid_number' : _('Primary GID attribute'),

'ldap_user_gecos' : _('GECOS attribute'),

'ldap_user_home_directory' : _('Home directory attribute'),

'ldap_user_shell' : _('Shell attribute'),

'ldap_user_uuid' : _('UUID attribute'),

'ldap_user_objectsid' : _("objectSID attribute"),

'ldap_user_primary_group' : _('Active Directory primary group attribute for ID-mapping'),

'ldap_user_principal' : _('User principal attribute (for Kerberos)'),

'ldap_user_fullname' : _('Full Name'),

'ldap_user_member_of' : _('memberOf attribute'),

'ldap_user_modify_timestamp' : _('Modification time attribute'),

#replaced by ldap_entry_usn# 'ldap_user_entry_usn' : _('entryUSN attribute'),

'ldap_user_shadow_last_change' : _('shadowLastChange attribute'),

'ldap_user_shadow_min' : _('shadowMin attribute'),

'ldap_user_shadow_max' : _('shadowMax attribute'),

'ldap_user_shadow_warning' : _('shadowWarning attribute'),

'ldap_user_shadow_inactive' : _('shadowInactive attribute'),

'ldap_user_shadow_expire' : _('shadowExpire attribute'),

'ldap_user_shadow_flag' : _('shadowFlag attribute'),

'ldap_user_authorized_service' : _('Attribute listing authorized PAM services'),

'ldap_user_authorized_host' : _('Attribute listing authorized server hosts'),

'ldap_user_krb_last_pwd_change' : _('krbLastPwdChange attribute'),

'ldap_user_krb_password_expiration' : _('krbPasswordExpiration attribute'),

'ldap_pwd_attribute' : _('Attribute indicating that server side password policies are active'),

'ldap_user_ad_account_expires' : _('accountExpires attribute of AD'),

'ldap_user_ad_user_account_control' : _('userAccountControl attribute of AD'),

'ldap_ns_account_lock' : _('nsAccountLock attribute'),

'ldap_user_nds_login_disabled' : _('loginDisabled attribute of NDS'),

'ldap_user_nds_login_expiration_time' : _('loginExpirationTime attribute of NDS'),

'ldap_user_nds_login_allowed_time_map' : _('loginAllowedTimeMap attribute of NDS'),

'ldap_user_ssh_public_key' : _('SSH public key attribute'),

'ldap_group_search_base' : _('Base DN for group lookups'),

# not used # 'ldap_group_search_scope' : _('Scope of group lookups'),

# not used # 'ldap_group_search_filter' : _('Filter for group lookups'),

'ldap_group_object_class' : _('Objectclass for groups'),

'ldap_group_name' : _('Group name'),

'ldap_group_pwd' : _('Group password'),

'ldap_group_gid_number' : _('GID attribute'),

'ldap_group_member' : _('Group member attribute'),

'ldap_group_uuid' : _('Group UUID attribute'),

'ldap_group_objectsid' : _("objectSID attribute"),

'ldap_group_modify_timestamp' : _('Modification time attribute for groups'),

#replaced by ldap_entry_usn# 'ldap_group_entry_usn' : _('entryUSN attribute'),

'ldap_group_nesting_level' : _('Maximum nesting level SSSd will follow'),

'ldap_netgroup_search_base' : _('Base DN for netgroup lookups'),

'ldap_netgroup_object_class' : _('Objectclass for netgroups'),

'ldap_netgroup_name' : _('Netgroup name'),

'ldap_netgroup_member' : _('Netgroups members attribute'),

'ldap_netgroup_triple' : _('Netgroup triple attribute'),

'ldap_netgroup_uuid' : _('Netgroup UUID attribute'),

'ldap_netgroup_modify_timestamp' : _('Modification time attribute for netgroups'),

'ldap_service_search_base' : _('Base DN for service lookups'),

'ldap_service_object_class' : _('Objectclass for services'),

'ldap_service_name' : _('Service name attribute'),

'ldap_service_port' : _('Service port attribute'),

'ldap_service_proto' : _('Service protocol attribute'),

#replaced by ldap_entry_usn# 'ldap_service_entry_usn' : _('Service entryUSN attribute'),

'ldap_idmap_range_min' : _('Lower bound for ID-mapping'),

'ldap_idmap_range_max' : _('Upper bound for ID-mapping'),

'ldap_idmap_range_size' : _('Number of IDs for each slice when ID-mapping'),

'ldap_idmap_autorid_compat' : _('Use autorid-compatible algorithm for ID-mapping'),

'ldap_idmap_default_domain' : _('Name of the default domain for ID-mapping'),

'ldap_idmap_default_domain_sid' : _('SID of the default domain for ID-mapping'),

'ldap_groups_use_matching_rule_in_chain' : _('Use LDAP_MATCHING_RULE_IN_CHAIN for group lookups'),

'ldap_initgroups_use_matching_rule_in_chain' : _('Use LDAP_MATCHING_RULE_IN_CHAIN for initgroup lookups'),

# [provider/ldap/auth]

'ldap_pwd_policy' : _('Policy to evaluate the password expiration'),

# [provider/ldap/access]

'ldap_access_filter' : _('LDAP filter to determine access privileges'),

'ldap_account_expire_policy' : _('Which attributes shall be used to evaluate if an account is expired'),

'ldap_access_order' : _('Which rules should be used to evaluate access control'),

# [provider/ldap/chpass]

'ldap_chpass_uri' : _('URI of an LDAP server where password changes are allowed'),

'ldap_chpass_backup_uri' : _('URI of a backup LDAP server where password changes are allowed'),

'ldap_chpass_dns_service_name' : _('DNS service name for LDAP password change server'),

'ldap_chpass_update_last_change' : _('Whether to update the ldap_user_shadow_last_change attribute after a password change'),

# [provider/ldap/sudo]

'ldap_sudo_search_base' : _('Base DN for sudo rules lookups'),

'ldap_sudo_full_refresh_interval' : _('Automatic full refresh period'),

'ldap_sudo_smart_refresh_interval' : _('Automatic smart refresh period'),

'ldap_sudo_use_host_filter' : _('Whether to filter rules by hostname, IP addresses and network'),

'ldap_sudo_hostnames' : _('Hostnames and/or fully qualified domain names of this machine to filter sudo rules'),

'ldap_sudo_ip' : _('IPv4 or IPv6 addresses or network of this machine to filter sudo rules'),

'ldap_sudo_include_netgroups' : _('Whether to include rules that contains netgroup in host attribute'),

'ldap_sudo_include_regexp' : _('Whether to include rules that contains regular expression in host attribute'),

'ldap_sudorule_object_class' : _('Object class for sudo rules'),

'ldap_sudorule_name' : _('Sudo rule name'),

'ldap_sudorule_command' : _('Sudo rule command attribute'),

'ldap_sudorule_host' : _('Sudo rule host attribute'),

'ldap_sudorule_user' : _('Sudo rule user attribute'),

'ldap_sudorule_option' : _('Sudo rule option attribute'),

'ldap_sudorule_runasuser' : _('Sudo rule runasuser attribute'),

'ldap_sudorule_runasgroup' : _('Sudo rule runasgroup attribute'),

'ldap_sudorule_notbefore' : _('Sudo rule notbefore attribute'),

'ldap_sudorule_notafter' : _('Sudo rule notafter attribute'),

'ldap_sudorule_order' : _('Sudo rule order attribute'),

# [provider/ldap/autofs]

'ldap_autofs_map_object_class' : _('Object class for automounter maps'),

'ldap_autofs_map_name' : _('Automounter map name attribute'),

'ldap_autofs_entry_object_class' : _('Object class for automounter map entries'),

'ldap_autofs_entry_key' : _('Automounter map entry key attribute'),

'ldap_autofs_entry_value' : _('Automounter map entry value attribute'),

'ldap_autofs_search_base' : _('Base DN for automounter map lookups'),

# [provider/simple/access]

'simple_allow_users' : _('Comma separated list of allowed users'),

'simple_deny_users' : _('Comma separated list of prohibited users'),

# [provider/local/id]

'default_shell' : _('Default shell, /bin/bash'),

'base_directory' : _('Base for home directories'),

# [provider/proxy/id]

'proxy_lib_name' : _('The name of the NSS library to use'),

'proxy_fast_alias' : _('Whether to look up canonical group name from cache if possible'),

# [provider/proxy/auth]

'proxy_pam_target' : _('PAM stack to use')

}

def striplist(l):

return([x.strip() for x in l])

def options_overlap(options1, options2):

overlap = []

for option in options1:

if option in options2:

overlap.append(option)

return overlap

class SSSDConfigSchema(SSSDChangeConf):

def __init__(self, schemafile, schemaplugindir):

SSSDChangeConf.__init__(self)

#TODO: get these from a global setting

if not schemafile:

schemafile = '@datadir@/sssd/sssd.api.conf'

if not schemaplugindir:

schemaplugindir = '@datadir@/sssd/sssd.api.d'

try:

#Read the primary config file

fd = open(schemafile, 'r')

self.readfp(fd)

fd.close()

# Read in the provider files

for file in os.listdir(schemaplugindir):

fd = open(schemaplugindir+ "/" + file)

self.readfp(fd)

fd.close()

except IOError:

raise

except SyntaxError: # can be raised with readfp

raise ParsingError

# Set up lookup table for types

self.type_lookup = {

'bool' : bool,

'int' : int,

'long' : long,

'float': float,

'str' : str,

'list' : list,

'None' : None

}

# Lookup table for acceptable boolean values

self.bool_lookup = {

'false' : False,

'true' : True,

}

def get_options(self, section):

if not self.has_section(section):

raise NoSectionError

options = self.options(section)

# Indexes

PRIMARY_TYPE = 0

SUBTYPE = 1

MANDATORY = 2

DEFAULT = 3

# Parse values

parsed_options = {}

for option in self.strip_comments_empty(options):

unparsed_option = option['value']

split_option = striplist(unparsed_option.split(','))

optionlen = len(split_option)

primarytype = self.type_lookup[split_option[PRIMARY_TYPE]]

subtype = self.type_lookup[split_option[SUBTYPE]]

mandatory = self.bool_lookup[split_option[MANDATORY]]

if option_strings.has_key(option['name']):

desc = option_strings[option['name']]

else:

desc = None

if optionlen == 3:

# This option has no defaults

parsed_options[option['name']] = \

(primarytype,

subtype,

mandatory,

desc,

None)

elif optionlen == 4:

if type(split_option[DEFAULT]) == primarytype:

parsed_options[option['name']] = \

(primarytype,

subtype,

mandatory,

desc,

split_option[DEFAULT])

elif primarytype == list:

if (type(split_option[DEFAULT]) == subtype):

parsed_options[option['name']] = \

(primarytype,

subtype,

mandatory,

desc,

[split_option[DEFAULT]])

else:

try:

if subtype == bool and \

type(split_option[DEFAULT]) == str:

parsed_options[option['name']] = \

(primarytype,

subtype,

mandatory,

desc,

[self.bool_lookup[split_option[DEFAULT].lower()]])

else:

parsed_options[option['name']] = \

(primarytype,

subtype,

mandatory,

desc,

[subtype(split_option[DEFAULT])])

except ValueError, KeyError:

raise ParsingError

else:

try:

if primarytype == bool and \

type(split_option[DEFAULT]) == str:

parsed_options[option['name']] = \

(primarytype,

subtype,

mandatory,

desc,

self.bool_lookup[split_option[DEFAULT].lower()])

else:

parsed_options[option['name']] = \

(primarytype,

subtype,

mandatory,

desc,

primarytype(split_option[DEFAULT]))

except ValueError, KeyError:

raise ParsingError

elif optionlen > 4:

if (primarytype != list):

raise ParsingError

fixed_options = []

for x in split_option[DEFAULT:]:

if type(x) != subtype:

try:

if (subtype == bool and type(x) == str):

newvalue = self.bool_lookup[x.lower()]

else:

newvalue = subtype(x)

fixed_options.extend([newvalue])

except ValueError, KeyError:

raise ParsingError

else:

fixed_options.extend([x])

parsed_options[option['name']] = \

(primarytype,

subtype,

mandatory,

desc,

fixed_options)

else:

# Bad config file

raise ParsingError

return parsed_options

def get_option(self, section, option):

if not self.has_section(section):

raise NoSectionError(section)

if not self.has_option(section, option):

raise NoOptionError("Section [%s] has no option [%s]" %

(section, option))

return self.get_options(section)[option]

def get_defaults(self, section):

if not self.has_section(section):

raise NoSectionError(section)

schema_options = self.get_options(section)

defaults = dict([(x,schema_options[x][4])

for x in schema_options.keys()

if schema_options[x][4] != None])

return defaults

def get_services(self):

service_list = [x['name'] for x in self.sections()

if x['name'] != 'service' and

not x['name'].startswith('domain') and

not x['name'].startswith('provider')]

return service_list

def get_providers(self):

providers = {}

for section in self.sections():

splitsection = section['name'].split('/')

if (splitsection[0] == 'provider'):

if(len(splitsection) == 3):

if not providers.has_key(splitsection[1]):

providers[splitsection[1]] = []

providers[splitsection[1]].extend([splitsection[2]])

for key in providers.keys():

providers[key] = tuple(providers[key])

return providers

class SSSDConfigObject(object):

def __init__(self):

self.name = None

self.options = {}

def get_name(self):

"""

Return the name of the this object

=== Returns ===

The domain name

=== Errors ===

No errors

"""

return self.name

def get_option(self, optionname):

"""

Return the value of an service option

optionname:

The option to get.

=== Returns ===

The value for the requested option.

=== Errors ===

NoOptionError:

The specified option was not listed in the service

"""

if optionname in self.options.keys():

return self.options[optionname]

raise NoOptionError(optionname)

def get_all_options(self):

"""

Return a dictionary of name/value pairs for this object

=== Returns ===

A dictionary of name/value pairs currently in use for this object

=== Errors ===

No errors

"""

return self.options

def remove_option(self, optionname):

"""

Remove an option from the object. If the option does not exist, it is ignored.

=== Returns ===

No return value.

=== Errors ===

No errors

"""

if self.options.has_key(optionname):

del self.options[optionname]

class SSSDService(SSSDConfigObject):

'''

Object to manipulate SSSD service options

'''

def __init__(self, servicename, apischema):

"""

Create a new SSSDService, setting its defaults to those found in the

schema. This constructor should not be used directly. Use

SSSDConfig.new_service() instead.

name:

The service name

apischema:

An SSSDConfigSchema? object created by SSSDConfig.__init__()

=== Returns ===

The newly-created SSSDService object.

=== Errors ===

TypeError:

The API schema passed in was unusable or the name was not a string.

ServiceNotRecognizedError:

The service was not listed in the schema

"""

SSSDConfigObject.__init__(self)

if not isinstance(apischema, SSSDConfigSchema) or type(servicename) != str:

raise TypeError

if not apischema.has_section(servicename):

raise ServiceNotRecognizedError(servicename)

self.name = servicename

self.schema = apischema

# Set up the service object with any known defaults

self.options = {}

# Include a list of hidden options

self.hidden_options = []

# Set up default options for all services

self.options.update(self.schema.get_defaults('service'))

# Set up default options for this service

self.options.update(self.schema.get_defaults(self.name))

# For the [sssd] service, force the config file version

if servicename == 'sssd':

self.options['config_file_version'] = 2

self.hidden_options.append('config_file_version')

def list_options_with_mandatory(self):

"""

List options for the service, including the mandatory flag.

=== Returns ===

A dictionary of configurable options. This dictionary is keyed on the

option name with a tuple of the variable type, subtype ('None' if the

type is not a collection type), whether it is mandatory, the

translated option description, and the default value (or 'None') as

the value.

Example:

{ 'enumerate' :

(bool, None, False, u'Enable enumerating all users/groups', True) }

=== Errors ===

No errors

"""

options = {}

# Get the list of available options for all services

schema_options = self.schema.get_options('service')

options.update(schema_options)

schema_options = self.schema.get_options(self.name)

options.update(schema_options)

return options

def list_options(self):

"""

List all options that apply to this service

=== Returns ===

A dictionary of configurable options. This dictionary is keyed on the

option name with a tuple of the variable type, subtype ('None' if the

type is not a collection type), the translated option description, and

the default value (or 'None') as the value.

Example:

{ 'services' :

(list, str, u'SSSD Services to start', ['nss', 'pam']) }

=== Errors ===

No Errors

"""

options = self.list_options_with_mandatory()

# Filter out the mandatory field to maintain compatibility

# with older versions of the API

filtered_options = {}

for key in options.keys():

filtered_options[key] = (options[key][0], options[key][1], options[key][3], options[key][4])

return filtered_options

def list_mandatory_options(self):

"""

List all mandatory options that apply to this service

=== Returns ===

A dictionary of configurable options. This dictionary is keyed on the

option name with a tuple of the variable type, subtype ('None' if the

type is not a collection type), the translated option description, and

the default value (or 'None') as the value.

Example:

{ 'services' :

(list, str, u'SSSD Services to start', ['nss', 'pam']) }

=== Errors ===

No Errors

"""

options = self.list_options_with_mandatory()

# Filter out the mandatory field to maintain compatibility

# with older versions of the API

filtered_options = {}

for key in options.keys():

if options[key][2]:

filtered_options[key] = (options[key][0], options[key][1], options[key][3], options[key][4])

return filtered_options

def set_option(self, optionname, value):

"""

Set a service option to the specified value (or values)

optionname:

The option to change

value:

The value to set. This may be a single value or a list of values. If

it is set to None, it resets the option to its default.

=== Returns ===

No return value

=== Errors ===

NoOptionError:

The specified option is not listed in the schema

TypeError:

The value specified was not of the expected type

"""

if self.schema.has_option(self.name, optionname):

option_schema = self.schema.get_option(self.name, optionname)

elif self.schema.has_option('service', optionname):

option_schema = self.schema.get_option('service', optionname)

elif optionname in self.hidden_options:

# Set this option and do not add it to the list of changeable values

self.options[optionname] = value

return

else:

raise NoOptionError('Section [%s] has no option [%s]' % (self.name, optionname))

if value == None:

self.remove_option(optionname)

return

raise_error = False

# If we were expecting a list and didn't get one,

# Create a list with a single entry. If it's the

# wrong subtype, it will fail below

if option_schema[0] == list and type(value) != list:

if type(value) == str:

value = striplist(value.split(','))

else:

value = [value]

if type(value) != option_schema[0]:

# If it's possible to convert it, do so

try:

if option_schema[0] == bool and \

type(value) == str:

value = self.schema.bool_lookup[value.lower()]

else:

value = option_schema[0](value)

except ValueError:

raise_error = True

except KeyError:

raise_error = True

if raise_error:

raise TypeError('Expected %s for %s, received %s' %

(option_schema[0], optionname, type(value)))

if type(value) == list:

# Iterate through the list an ensure that all members

# are of the appropriate subtype

try:

newvalue = []

for x in value:

if option_schema[1] == bool and \

type(x) == str:

newvalue.extend([self.schema.bool_lookup[x.lower()]])

else:

newvalue.extend([option_schema[1](x)])

except ValueError:

raise_error = True

except KeyError:

raise_error = True

if raise_error:

raise TypeError('Expected %s' % option_schema[1])

value = newvalue

self.options[optionname] = value

class SSSDDomain(SSSDConfigObject):

"""

Object to manipulate SSSD domain options

"""

def __init__(self, domainname, apischema):

"""

Creates a new, empty SSSDDomain. This domain is inactive by default.

This constructor should not be used directly. Use

SSSDConfig.new_domain() instead.

name:

The domain name.

apischema:

An SSSDConfigSchema object created by SSSDConfig.__init__()

=== Returns ===

The newly-created SSSDDomain object.

=== Errors ===

TypeError:

apischema was not an SSSDConfigSchema object or domainname was not

a string

"""

SSSDConfigObject.__init__(self)

if not isinstance(apischema, SSSDConfigSchema) or type(domainname) != str:

raise TypeError

self.name = domainname

self.schema = apischema

self.active = False

self.oldname = None

self.providers = []

# Set up the domain object with any known defaults

self.options = {}

# Set up default options for all domains

self.options.update(self.schema.get_defaults('provider'))

self.options.update(self.schema.get_defaults('domain'))

def set_active(self, active):

"""

Enable or disable this domain

active:

Boolean value. If True, this domain will be added to the active

domains list when it is saved. If False, it will be removed from the

active domains list when it is saved.

=== Returns ===

No return value

=== Errors ===

No errors

"""

self.active = bool(active)

def list_options_with_mandatory(self):

"""

List options for the currently-configured providers, including the

mandatory flag

=== Returns ===

A dictionary of configurable options. This dictionary is keyed on the

option name with a tuple of the variable type, subtype ('None' if the

type is not a collection type), whether it is mandatory, the

translated option description, and the default value (or 'None') as

the value.

Example:

{ 'enumerate' :

(bool, None, False, u'Enable enumerating all users/groups', True) }

=== Errors ===

No errors

"""

options = {}

# Get the list of available options for all domains

options.update(self.schema.get_options('provider'))

options.update(self.schema.get_options('domain'))

# Candidate for future optimization: will update primary type

# for each subtype

for (provider, providertype) in self.providers:

schema_options = self.schema.get_options('provider/%s'

% provider)

options.update(schema_options)

schema_options = self.schema.get_options('provider/%s/%s'

% (provider, providertype))

options.update(schema_options)

return options

def list_options(self):

"""

List options available for the currently-configured providers.

=== Returns ===

A dictionary of configurable options. This dictionary is keyed on the

option name with a tuple of the variable type, subtype ('None' if the

type is not a collection type), the translated option description, and

the default value (or 'None') as the value.

Example:

{ 'enumerate' :

(bool, None, u'Enable enumerating all users/groups', True) }

=== Errors ===

No errors

"""

options = self.list_options_with_mandatory()

# Filter out the mandatory field to maintain compatibility

# with older versions of the API

filtered_options = {}

for key in options.keys():

filtered_options[key] = (options[key][0], options[key][1], options[key][3], options[key][4])

return filtered_options

def list_mandatory_options(self):

"""

List mandatory options for the currently-configured providers.

=== Returns ===

A dictionary of configurable options. This dictionary is keyed on the

option name with a tuple of the variable type, subtype ('None' if the

type is not a collection type), the translated option description, and

the default value (or 'None') as the value.

Example:

{ 'enumerate' :

(bool, None, u'Enable enumerating all users/groups', True) }

=== Errors ===

No errors

"""

options = self.list_options_with_mandatory()

# Filter out the mandatory field to maintain compatibility

# with older versions of the API

filtered_options = {}

for key in options.keys():

if options[key][2]:

filtered_options[key] = (options[key][0], options[key][1], options[key][3], options[key][4])

return filtered_options

def list_provider_options(self, provider, provider_type=None):

"""

If provider_type is specified, list all options applicable to that

target, otherwise list all possible options available for a provider.

type:

Provider backend type. (e.g. local, ldap, krb5, etc.)

provider_type:

Subtype of the backend type. (e.g. id, auth, access, chpass)

=== Returns ===

A dictionary of configurable options for the specified provider type.

This dictionary is keyed on the option name with a tuple of the

variable type, subtype ('None' if the type is not a collection type),

the translated option description, and the default value (or 'None')

as the value.

=== Errors ===

NoSuchProviderError:

The specified provider is not listed in the schema or plugins

NoSuchProviderSubtypeError:

The specified provider subtype is not listed in the schema

"""

#TODO section checking

options = self.schema.get_options('provider/%s' % provider)

if(provider_type):

options.update(self.schema.get_options('provider/%s/%s' %

(provider, provider_type)))

else:

# Add options from all provider subtypes

known_providers = self.list_providers()

for provider_type in known_providers[provider]:

options.update(self.list_provider_options(provider,

provider_type))

return options

def list_providers(self):

"""

Return a dictionary of providers.

=== Returns ===

Returns a dictionary of providers, keyed on the primary type, with the

value being a tuple of the subtypes it supports.

Example:

{ 'ldap' : ('id', 'auth', 'chpass') }

=== Errors ===

No Errors

"""

return self.schema.get_providers()

def set_option(self, option, value):

"""

Set a domain option to the specified value (or values)

option:

The option to change.

value:

The value to set. This may be a single value or a list of values.

If it is set to None, it resets the option to its default.

=== Returns ===

No return value.

=== Errors ===

NoOptionError:

The specified option is not listed in the schema

TypeError:

The value specified was not of the expected type

"""

options = self.list_options()

if (option not in options.keys()):

raise NoOptionError('Section [%s] has no option [%s]' %

(self.name, option))

if value == None:

self.remove_option(option)

return

option_schema = options[option]

raise_error = False

# If we were expecting a list and didn't get one,

# Create a list with a single entry. If it's the

# wrong subtype, it will fail below

if option_schema[0] == list and type(value) != list:

if type(value) == str:

value = striplist(value.split(','))

else:

value = [value]

if type(value) != option_schema[0]:

# If it's possible to convert it, do so

try:

if option_schema[0] == bool and \

type(value) == str:

value = self.schema.bool_lookup[value.lower()]

elif option_schema[0] == int and type(value) == str:

# Make sure we handle any reasonable base

value = int(value, 0)

else:

value = option_schema[0](value)

except ValueError:

raise_error = True

except KeyError:

raise_error = True

if raise_error:

raise TypeError('Expected %s for %s, received %s' %

(option_schema[0], option, type(value)))

if type(value) == list:

# Iterate through the list an ensure that all members

# are of the appropriate subtype

try:

newvalue = []

for x in value:

if option_schema[1] == bool and \

type(x) == str:

newvalue.extend([self.schema.bool_lookup[x.lower()]])

else:

newvalue.extend([option_schema[1](x)])

except ValueError:

raise_error = True

except KeyError:

raise_error = True

if raise_error:

raise TypeError('Expected %s' % option_schema[1])

value = newvalue

# Check whether we're adding a provider entry.

is_provider = option.rfind('_provider')

if (is_provider > 0):

provider = option[:is_provider]

try:

self.add_provider(value, provider)

except NoSuchProviderError:

raise NoOptionError

else:

self.options[option] = value

def set_name(self, newname):

"""

Change the name of the domain

newname:

New name for this domain

=== Returns ===

No return value.

=== Errors ===

TypeError:

newname was not a string

"""

if type(newname) != str:

raise TypeError

if not self.oldname:

# Only set the oldname once

self.oldname = self.name

self.name = newname

def add_provider(self, provider, provider_type):

"""

Add a new provider type to the domain

type:

Provider backend type. (e.g. local, ldap, krb5, etc.)

subtype:

Subtype of the backend type. (e.g. id, auth, chpass)

=== Returns ===

No return value.

=== Errors ===

ProviderSubtypeInUse:

Another backend is already providing this subtype

NoSuchProviderError:

The specified provider is not listed in the schema or plugins

NoSuchProviderSubtypeError:

The specified provider subtype is not listed in the schema

"""

# Check that provider and provider_type are valid

configured_providers = self.list_providers()

if provider in configured_providers.keys():

if provider_type not in configured_providers[provider]:

raise NoSuchProviderSubtypeError(provider_type)

else:

raise NoSuchProviderError

# Don't add a provider twice

with_this_type = [x for x in self.providers if x[1] == provider_type]

if len(with_this_type) > 1:

# This should never happen!

raise ProviderSubtypeInUse

if len(with_this_type) == 1:

if with_this_type[0][0] != provider:

raise ProviderSubtypeInUse(with_this_type[0][0])

else:

self.providers.extend([(provider, provider_type)])

option_name = '%s_provider' % provider_type

self.options[option_name] = provider

# Add defaults for this provider

self.options.update(self.schema.get_defaults('provider/%s' %

provider))

self.options.update(self.schema.get_defaults('provider/%s/%s' %

(provider,

provider_type)))

def remove_provider(self, provider_type):

"""

Remove a provider from the domain. If the provider is not present, it

is ignored.

provider_type:

Subtype of the backend type. (e.g. id, auth, chpass)

=== Returns ===

No return value.

=== Errors ===

No Errors

"""

provider = None

for (provider, ptype) in self.providers:

if ptype == provider_type:

break

provider = None

# Check whether the provider_type was found

if not provider:

return

# Remove any unused options when removing the provider.

options = self.list_provider_options(provider, provider_type)

# Trim any options that are used by other providers,

# if that provider is in use

for (prov, ptype) in self.providers:

# Ignore the one being removed

if (prov, ptype) == (provider, provider_type):

continue

provider_options = self.list_provider_options(prov, ptype)

overlap = options_overlap(options.keys(), provider_options.keys())

for opt in overlap:

del options[opt]

# We should now have a list of options used only by this

# provider. So we remove them.

for option in options:

if self.options.has_key(option):

del self.options[option]

# Remove this provider from the option list

option = '%s_provider' % provider_type

if self.options.has_key(option):

del self.options[option]

self.providers.remove((provider, provider_type))

class SSSDConfig(SSSDChangeConf):

"""

class SSSDConfig

Primary class for operating on SSSD configurations

"""

def __init__(self, schemafile=None, schemaplugindir=None):

"""

Initialize the SSSD config parser/editor. This constructor does not

open or create a config file. If the schemafile and schemaplugindir

are not passed, it will use the system defaults.

schemafile:

The path to the api schema config file. Usually

@datadir@/sssd/sssd.api.conf

schemaplugindir:

The path the directory containing the provider schema config files.

Usually @datadir@/sssd/sssd.api.d

=== Returns ===

The newly-created SSSDConfig object.

=== Errors ===

IOError:

Exception raised when the schema file could not be opened for

reading.

ParsingError:

The main schema file or one of those in the plugin directory could

not be parsed.

"""

SSSDChangeConf.__init__(self)

self.schema = SSSDConfigSchema(schemafile, schemaplugindir)

self.configfile = None

self.initialized = False

self.API_VERSION = 2

def import_config(self,configfile=None):

"""

Read in a config file, populating all of the service and domain

objects with the read values.

configfile:

The path to the SSSD config file. If not specified, use the system

default, usually @sysconfdir@/sssd.conf

=== Returns ===

No return value

=== Errors ===

IOError:

Exception raised when the file could not be opened for reading

ParsingError:

Exception raised when errors occur attempting to parse a file.

AlreadyInitializedError:

This SSSDConfig object was already initialized by a call to

import_config() or new_config()

"""

if self.initialized:

raise AlreadyInitializedError

if not configfile:

#TODO: get this from a global setting

configfile = '@sysconfdir@/sssd/sssd.conf'

# open will raise an IOError if it fails

fd = open(configfile, 'r')

try:

self.readfp(fd)

except:

raise ParsingError

fd.close()

self.configfile = configfile

self.initialized = True

try:

if int(self.get('sssd', 'config_file_version')) != self.API_VERSION:

raise ParsingError("Wrong config_file_version")

except:

# Either the 'sssd' section or the 'config_file_version' was not

# present in the config file

raise ParsingError("File contains no config_file_version")

def new_config(self):

"""

Initialize the SSSDConfig object with the defaults from the schema.

=== Returns ===

No return value

=== Errors ===

AlreadyInitializedError:

This SSSDConfig object was already initialized by a call to

import_config() or new_config()

"""

if self.initialized:

raise AlreadyInitializedError

self.initialized = True

#Initialize all services

for servicename in self.schema.get_services():

service = self.new_service(servicename)

def write(self, outputfile=None):

"""

Write out the configuration to a file.

outputfile:

The path to write the new config file. If it is not specified, it

will use the path specified by the import() call.

=== Returns ===

No return value

=== Errors ===

IOError:

Exception raised when the file could not be opened for writing

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

NoOutputFileError:

No outputfile was specified and this SSSDConfig object was not

initialized by import()

"""

if not self.initialized:

raise NotInitializedError

if outputfile == None:

if(self.configfile == None):

raise NoOutputFileError

outputfile = self.configfile

# open() will raise IOError if it fails

old_umask = os.umask(0177)

of = open(outputfile, "wb")

output = self.dump(self.opts)

of.write(output)

of.close()

os.umask(old_umask)

def list_active_services(self):

"""

Return a list of all active services.

=== Returns ===

The list of active services.

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

if (self.has_option('sssd', 'services')):

active_services = striplist(self.get('sssd', 'services').split(','))

service_dict = dict.fromkeys(active_services)

if service_dict.has_key(''):

del service_dict['']

# Remove any entries in this list that don't

# correspond to an active service, for integrity

configured_services = self.list_services()

for srv in service_dict.keys():

if srv not in configured_services:

del service_dict[srv]

active_services = service_dict.keys()

else:

active_services = []

return active_services

def list_inactive_services(self):

"""

Return a list of all disabled services.

=== Returns ===

The list of inactive services.

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

if (self.has_option('sssd', 'services')):

active_services = striplist(self.get('sssd', 'services').split(','))

else:

active_services = []

services = [x for x in self.list_services()

if x not in active_services]

return services

def list_services(self):

"""

Retrieve a list of known services.

=== Returns ===

The list of known services.

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

service_list = [x['name'] for x in self.sections()

if not x['name'].startswith('domain') ]

return service_list

def get_service(self, name):

"""

Get an SSSDService object to edit a service.

name:

The name of the service to return.

=== Returns ===

An SSSDService instance containing the current state of a service in

the SSSDConfig

=== Errors ===

NoServiceError:

There is no such service with the specified name in the SSSDConfig.

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

if not self.has_section(name):

raise NoServiceError

service = SSSDService(name, self.schema)

for opt in self.strip_comments_empty(self.options(name)):

try:

service.set_option(opt['name'], opt['value'])

except NoOptionError:

# If we come across an option that we don't recognize,

# we should just ignore it and continue

pass

return service

def new_service(self, name):

"""

Create a new service from the defaults and return the SSSDService

object for it. This function will also add this service to the list of

active services in the [SSSD] section.

name:

The name of the service to create and return.

=== Returns ===

The newly-created SSSDService object

=== Errors ===

ServiceNotRecognizedError:

There is no such service in the schema.

ServiceAlreadyExistsError:

The service being created already exists in the SSSDConfig object.

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

if (self.has_section(name)):

raise ServiceAlreadyExists(name)

service = SSSDService(name, self.schema)

self.save_service(service)

return service

def activate_service(self, name):

"""

Activate a service

name:

The name of the service to activate

=== Returns ===

No return value

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

NoServiceError:

There is no such service with the specified name in the SSSDConfig.

"""

if not self.initialized:

raise NotInitializedError

if name not in self.list_services():

raise NoServiceError

item = self.get_option_index('sssd', 'services')[1]

if not item:

self.set('sssd','services', name)

return

# Turn the items into a set of dictionary keys

# This guarantees uniqueness and makes it easy

# to add a new value

service_dict = dict.fromkeys(striplist(item['value'].split(',')))

if service_dict.has_key(''):

del service_dict['']

# Add a new key for the service being activated

service_dict[name] = None

# Write out the joined keys

self.set('sssd','services', ", ".join(service_dict.keys()))

def deactivate_service(self, name):

"""

Deactivate a service

name:

The name of the service to deactivate

=== Returns ===

No return value

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

NoServiceError:

There is no such service with the specified name in the SSSDConfig.

"""

if not self.initialized:

raise NotInitializedError

if name not in self.list_services():

raise NoServiceError

item = self.get_option_index('sssd', 'services')[1]

if not item:

self.set('sssd','services', '')

return

# Turn the items into a set of dictionary keys

# This guarantees uniqueness and makes it easy

# to remove the one unwanted value.

service_dict = dict.fromkeys(striplist(item['value'].split(',')))

if service_dict.has_key(''):

del service_dict['']

# Remove the unwanted service from the lest

if service_dict.has_key(name):

del service_dict[name]

# Write out the joined keys

self.set('sssd','services', ", ".join(service_dict.keys()))

def delete_service(self, name):

"""

Remove a service from the SSSDConfig object. This function will also

remove this service from the list of active services in the [SSSD]

section. Has no effect if the service does not exist.

=== Returns ===

No return value

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

self.delete_option('section', name)

def save_service(self, service):

"""

Save the changes made to the service object back to the SSSDConfig

object.

service_object:

The SSSDService object to save to the configuration.

=== Returns ===

No return value

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

TypeError:

service_object was not of the type SSSDService

"""

if not self.initialized:

raise NotInitializedError

if not isinstance(service, SSSDService):

raise TypeError

name = service.get_name()

# Ensure that the existing section is removed

# This way we ensure that we are getting a

# complete copy of the service.

# delete_option() is a noop if the section

# does not exist.

index = self.delete_option('section', name)

addkw = []

for option,value in service.get_all_options().items():

if (type(value) == list):

value = ', '.join(value)

addkw.append( { 'type' : 'option',

'name' : option,

'value' : str(value) } )

self.add_section(name, addkw, index)

def list_active_domains(self):

"""

Return a list of all active domains.

=== Returns ===

The list of configured, active domains.

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

if (self.has_option('sssd', 'domains')):

active_domains = striplist(self.get('sssd', 'domains').split(','))

domain_dict = dict.fromkeys(active_domains)

if domain_dict.has_key(''):

del domain_dict['']

# Remove any entries in this list that don't

# correspond to an active domain, for integrity

configured_domains = self.list_domains()

for dom in domain_dict.keys():

if dom not in configured_domains:

del domain_dict[dom]

active_domains = domain_dict.keys()

else:

active_domains = []

return active_domains

def list_inactive_domains(self):

"""

Return a list of all configured, but disabled domains.

=== Returns ===

The list of configured, inactive domains.

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

if (self.has_option('sssd', 'domains')):

active_domains = striplist(self.get('sssd', 'domains').split(','))

else:

active_domains = []

domains = [x for x in self.list_domains()

if x not in active_domains]

return domains

def list_domains(self):

"""

Return a list of all configured domains, including inactive domains.

=== Returns ===

The list of configured domains, both active and inactive.

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

domains = [x['name'][7:] for x in self.sections() if x['name'].startswith('domain/')]

return domains

def get_domain(self, name):

"""

Get an SSSDDomain object to edit a domain.

name:

The name of the domain to return.

=== Returns ===

An SSSDDomain instance containing the current state of a domain in the

SSSDConfig

=== Errors ===

NoDomainError:

There is no such domain with the specified name in the SSSDConfig.

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

if not self.has_section('domain/%s' % name):

raise NoDomainError(name)

domain = SSSDDomain(name, self.schema)

# Read in the providers first or we may have type

# errors trying to read in their options

providers = [ (x['name'],x['value']) for x in self.strip_comments_empty(self.options('domain/%s' % name))

if x['name'].rfind('_provider') > 0]

for (option, value) in providers:

try:

domain.set_option(option, value)

except NoOptionError:

# If we come across an option that we don't recognize,

# we should just ignore it and continue

pass

# Read in all the options from the configuration

for opt in self.strip_comments_empty(self.options('domain/%s' % name)):

if (opt['name'], opt['value']) not in providers:

try:

domain.set_option(opt['name'], opt['value'])

except NoOptionError:

# If we come across an option that we don't recognize,

# we should just ignore it and continue

pass

# Determine if this domain is currently active

domain.active = self.is_domain_active(name)

return domain

def new_domain(self, name):

"""

Create a new, empty domain and return the SSSDDomain object for it.

name:

The name of the domain to create and return.

=== Returns ===

The newly-created SSSDDomain object

=== Errors ===

DomainAlreadyExistsError:

The service being created already exists in the SSSDConfig object.

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

if self.has_section('domain/%s' % name):

raise DomainAlreadyExistsError

domain = SSSDDomain(name, self.schema)

self.save_domain(domain)

return domain

def is_domain_active(self, name):

"""

Is a particular domain set active

name:

The name of the configured domain to check

=== Returns ===

True if the domain is active, False if it is inactive

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

NoDomainError:

No domain by this name is configured

"""

if not self.initialized:

raise NotInitializedError

if name not in self.list_domains():

raise NoDomainError

return name in self.list_active_domains()

def activate_domain(self, name):

"""

Activate a configured domain

name:

The name of the configured domain to activate

=== Returns ===

No return value

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

NoDomainError:

No domain by this name is configured

"""

if not self.initialized:

raise NotInitializedError

if name not in self.list_domains():

raise NoDomainError

item = self.get_option_index('sssd', 'domains')[1]

if not item:

self.set('sssd','domains', name)

return

# Turn the items into a set of dictionary keys

# This guarantees uniqueness and makes it easy

# to add a new value

domain_dict = dict.fromkeys(striplist(item['value'].split(',')))

if domain_dict.has_key(''):

del domain_dict['']

# Add a new key for the domain being activated

domain_dict[name] = None

# Write out the joined keys

self.set('sssd','domains', ", ".join(domain_dict.keys()))

def deactivate_domain(self, name):

"""

Deactivate a configured domain

name:

The name of the configured domain to deactivate

=== Returns ===

No return value

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

NoDomainError:

No domain by this name is configured

"""

if not self.initialized:

raise NotInitializedError

if name not in self.list_domains():

raise NoDomainError

item = self.get_option_index('sssd', 'domains')[1]

if not item:

self.set('sssd','domains', '')

return

# Turn the items into a set of dictionary keys

# This guarantees uniqueness and makes it easy

# to remove the one unwanted value.

domain_dict = dict.fromkeys(striplist(item['value'].split(',')))

if domain_dict.has_key(''):

del domain_dict['']

# Remove the unwanted domain from the lest

if domain_dict.has_key(name):

del domain_dict[name]

# Write out the joined keys

self.set('sssd','domains', ", ".join(domain_dict.keys()))

def delete_domain(self, name):

"""

Remove a domain from the SSSDConfig object. This function will also

remove this domain from the list of active domains in the [SSSD]

section, if it is there.

=== Returns ===

No return value

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

"""

if not self.initialized:

raise NotInitializedError

# Remove the domain from the active domains list if applicable

self.deactivate_domain(name)

self.delete_option('section', 'domain/%s' % name)

def save_domain(self, domain):

"""

Save the changes made to the domain object back to the SSSDConfig

object. If this domain is marked active, ensure it is present in the

active domain list in the [SSSD] section

domain_object:

The SSSDDomain object to save to the configuration.

=== Returns ===

No return value

=== Errors ===

NotInitializedError:

This SSSDConfig object has not had import_config() or new_config()

run on it yet.

TypeError:

domain_object was not of type SSSDDomain

"""

if not self.initialized:

raise NotInitializedError

if not isinstance(domain, SSSDDomain):

raise TypeError

name = domain.get_name()

oldindex = None

if domain.oldname and domain.oldname != name:

# We are renaming this domain

# Remove the old section

self.deactivate_domain(domain.oldname)

oldindex = self.delete_option('section', 'domain/%s' %

domain.oldname)

# Reset the oldname, in case we're not done with

# this domain object.

domain.oldname = None;

sectionname = 'domain/%s' % name

(no, section_subtree) = self.findOpts(self.opts, 'section', sectionname)

if name not in self.list_domains():

self.add_section(sectionname, []);

for option in self.options(sectionname):

if option['type'] == 'option':

if option['name'] not in domain.get_all_options():

self.delete_option_subtree(section_subtree['value'], 'option', option['name'], True)

for option,value in domain.get_all_options().items():

if (type(value) == list):

value = ', '.join(value)

self.set(sectionname, option, str(value))

if domain.active:

self.activate_domain(name)

else:

self.deactivate_domain(name)