lib/keystone
d81a0274
 # lib/keystone
 # Functions to control the configuration and operation of **Keystone**
 
 # Dependencies:
 # ``functions`` file
 # ``BASE_SQL_CONN``
c83a7e12
 # ``SERVICE_HOST``, ``SERVICE_PROTOCOL``
d81a0274
 # ``SERVICE_TOKEN``
 # ``S3_SERVICE_PORT`` (template backend only)
91b8d13e
 # ``STACK_USER``
d81a0274
 
 # ``stack.sh`` calls the entry points in this order:
 #
 # install_keystone
 # configure_keystone
 # init_keystone
 # start_keystone
d835de89
 # create_keystone_accounts
d81a0274
 # stop_keystone
 # cleanup_keystone
 
7903b795
 # Save trace setting
 XTRACE=$(set +o | grep xtrace)
 set +o xtrace
d81a0274
 
 
 # Defaults
 # --------
 
 # Set up default directories
 KEYSTONE_DIR=$DEST/keystone
 KEYSTONE_CONF_DIR=${KEYSTONE_CONF_DIR:-/etc/keystone}
 KEYSTONE_CONF=$KEYSTONE_CONF_DIR/keystone.conf
e0bb4472
 KEYSTONE_PASTE_INI=${KEYSTONE_PASTE_INI:-$KEYSTONE_CONF_DIR/keystone-paste.ini}
bc071bce
 KEYSTONE_AUTH_CACHE_DIR=${KEYSTONE_AUTH_CACHE_DIR:-/var/cache/keystone}
d81a0274
 
 KEYSTONECLIENT_DIR=$DEST/python-keystoneclient
 
bc071bce
 # Select the backend for Keystone's service catalog
b80379c3
 KEYSTONE_CATALOG_BACKEND=${KEYSTONE_CATALOG_BACKEND:-sql}
d81a0274
 KEYSTONE_CATALOG=$KEYSTONE_CONF_DIR/default_catalog.templates
 
5bd96f96
 # Select the backend for Tokens
 KEYSTONE_TOKEN_BACKEND=${KEYSTONE_TOKEN_BACKEND:-sql}
 
bc071bce
 # Select Keystone's token format
 # Choose from 'UUID' and 'PKI'
 KEYSTONE_TOKEN_FORMAT=${KEYSTONE_TOKEN_FORMAT:-PKI}
 
d81a0274
 # Set Keystone interface configuration
 KEYSTONE_AUTH_HOST=${KEYSTONE_AUTH_HOST:-$SERVICE_HOST}
 KEYSTONE_AUTH_PORT=${KEYSTONE_AUTH_PORT:-35357}
c83a7e12
 KEYSTONE_AUTH_PORT_INT=${KEYSTONE_AUTH_PORT_INT:-35358}
 KEYSTONE_AUTH_PROTOCOL=${KEYSTONE_AUTH_PROTOCOL:-$SERVICE_PROTOCOL}
 
 # Public facing bits
d81a0274
 KEYSTONE_SERVICE_HOST=${KEYSTONE_SERVICE_HOST:-$SERVICE_HOST}
 KEYSTONE_SERVICE_PORT=${KEYSTONE_SERVICE_PORT:-5000}
c83a7e12
 KEYSTONE_SERVICE_PORT_INT=${KEYSTONE_SERVICE_PORT_INT:-5001}
 KEYSTONE_SERVICE_PROTOCOL=${KEYSTONE_SERVICE_PROTOCOL:-$SERVICE_PROTOCOL}
d81a0274
 
b7490da9
 # Set the tenant for service accounts in Keystone
 SERVICE_TENANT_NAME=${SERVICE_TENANT_NAME:-service}
 
d81a0274
 
cc6b4435
 # Functions
 # ---------
d81a0274
 
 # cleanup_keystone() - Remove residual data files, anything left over from previous
 # runs that a clean run would need to clean up
 function cleanup_keystone() {
     # kill instances (nova)
     # delete image files (glance)
     # This function intentionally left blank
     :
 }
 
 # configure_keystone() - Set config files, create data dirs, etc
 function configure_keystone() {
     if [[ ! -d $KEYSTONE_CONF_DIR ]]; then
         sudo mkdir -p $KEYSTONE_CONF_DIR
     fi
91b8d13e
     sudo chown $STACK_USER $KEYSTONE_CONF_DIR
d81a0274
 
     if [[ "$KEYSTONE_CONF_DIR" != "$KEYSTONE_DIR/etc" ]]; then
         cp -p $KEYSTONE_DIR/etc/keystone.conf.sample $KEYSTONE_CONF
         cp -p $KEYSTONE_DIR/etc/policy.json $KEYSTONE_CONF_DIR
e0bb4472
         if [[ -f "$KEYSTONE_DIR/etc/keystone-paste.ini" ]]; then
             cp -p "$KEYSTONE_DIR/etc/keystone-paste.ini" "$KEYSTONE_PASTE_INI"
         fi
     fi
     if [[ -f "$KEYSTONE_PASTE_INI" ]]; then
         iniset "$KEYSTONE_CONF" paste_deploy config_file "$KEYSTONE_PASTE_INI"
     else
         # compatibility with mixed cfg and paste.deploy configuration
         KEYSTONE_PASTE_INI="$KEYSTONE_CONF"
d81a0274
     fi
 
     # Rewrite stock ``keystone.conf``
c83a7e12
 
f127e2f3
     if is_service_enabled ldap; then
         #Set all needed ldap values
         iniset $KEYSTONE_CONF ldap password  $LDAP_PASSWORD
         iniset $KEYSTONE_CONF ldap user "dc=Manager,dc=openstack,dc=org"
         iniset $KEYSTONE_CONF ldap suffix "dc=openstack,dc=org"
f41024e4
         iniset $KEYSTONE_CONF ldap use_dumb_member "True"
         iniset $KEYSTONE_CONF ldap user_attribute_ignore "enabled,email,tenants,tenantId"
         iniset $KEYSTONE_CONF ldap tenant_attribute_ignore "enabled"
         iniset $KEYSTONE_CONF ldap tenant_domain_id_attribute "businessCategory"
         iniset $KEYSTONE_CONF ldap tenant_desc_attribute "description"
         iniset $KEYSTONE_CONF ldap tenant_tree_dn "ou=Projects,dc=openstack,dc=org"
         iniset $KEYSTONE_CONF ldap user_domain_id_attribute "businessCategory"
         iniset $KEYSTONE_CONF ldap user_tree_dn "ou=Users,dc=openstack,dc=org"
         iniset $KEYSTONE_CONF DEFAULT member_role_id "9fe2ff9ee4384b1894a90878d3e92bab"
         iniset $KEYSTONE_CONF DEFAULT member_role_name "_member_"
f127e2f3
     fi
 
     if [[  "$KEYSTONE_IDENTITY_BACKEND" == "ldap"  ]]; then
         iniset $KEYSTONE_CONF identity driver "keystone.identity.backends.ldap.Identity"
     fi
 
c83a7e12
     if is_service_enabled tls-proxy; then
         # Set the service ports for a proxy to take the originals
         iniset $KEYSTONE_CONF DEFAULT public_port $KEYSTONE_SERVICE_PORT_INT
         iniset $KEYSTONE_CONF DEFAULT admin_port $KEYSTONE_AUTH_PORT_INT
     fi
 
d81a0274
     iniset $KEYSTONE_CONF DEFAULT admin_token "$SERVICE_TOKEN"
4de55e9b
     iniset $KEYSTONE_CONF signing token_format "$KEYSTONE_TOKEN_FORMAT"
7e79d913
     iniset $KEYSTONE_CONF sql connection `database_connection_url keystone`
d81a0274
     iniset $KEYSTONE_CONF ec2 driver "keystone.contrib.ec2.backends.sql.Ec2"
 
5bd96f96
     if [[ "$KEYSTONE_TOKEN_BACKEND" = "sql" ]]; then
         iniset $KEYSTONE_CONF token driver keystone.token.backends.sql.Token
     else
         iniset $KEYSTONE_CONF token driver keystone.token.backends.kvs.Token
     fi
 
d81a0274
     if [[ "$KEYSTONE_CATALOG_BACKEND" = "sql" ]]; then
         # Configure ``keystone.conf`` to use sql
         iniset $KEYSTONE_CONF catalog driver keystone.catalog.backends.sql.Catalog
         inicomment $KEYSTONE_CONF catalog template_file
     else
         cp -p $FILES/default_catalog.templates $KEYSTONE_CATALOG
 
         # Add swift endpoints to service catalog if swift is enabled
0c3a5584
         if is_service_enabled s-proxy; then
d81a0274
             echo "catalog.RegionOne.object_store.publicURL = http://%SERVICE_HOST%:8080/v1/AUTH_\$(tenant_id)s" >> $KEYSTONE_CATALOG
             echo "catalog.RegionOne.object_store.adminURL = http://%SERVICE_HOST%:8080/" >> $KEYSTONE_CATALOG
             echo "catalog.RegionOne.object_store.internalURL = http://%SERVICE_HOST%:8080/v1/AUTH_\$(tenant_id)s" >> $KEYSTONE_CATALOG
             echo "catalog.RegionOne.object_store.name = Swift Service" >> $KEYSTONE_CATALOG
         fi
 
         # Add quantum endpoints to service catalog if quantum is enabled
         if is_service_enabled quantum; then
             echo "catalog.RegionOne.network.publicURL = http://%SERVICE_HOST%:$Q_PORT/" >> $KEYSTONE_CATALOG
             echo "catalog.RegionOne.network.adminURL = http://%SERVICE_HOST%:$Q_PORT/" >> $KEYSTONE_CATALOG
             echo "catalog.RegionOne.network.internalURL = http://%SERVICE_HOST%:$Q_PORT/" >> $KEYSTONE_CATALOG
             echo "catalog.RegionOne.network.name = Quantum Service" >> $KEYSTONE_CATALOG
         fi
 
7e86dbe1
         sed -e "
d81a0274
             s,%SERVICE_HOST%,$SERVICE_HOST,g;
             s,%S3_SERVICE_PORT%,$S3_SERVICE_PORT,g;
         " -i $KEYSTONE_CATALOG
 
         # Configure ``keystone.conf`` to use templates
         iniset $KEYSTONE_CONF catalog driver "keystone.catalog.backends.templated.TemplatedCatalog"
         iniset $KEYSTONE_CONF catalog template_file "$KEYSTONE_CATALOG"
     fi
 
     # Set up logging
     LOGGING_ROOT="devel"
     if [ "$SYSLOG" != "False" ]; then
         LOGGING_ROOT="$LOGGING_ROOT,production"
     fi
     KEYSTONE_LOG_CONFIG="--log-config $KEYSTONE_CONF_DIR/logging.conf"
     cp $KEYSTONE_DIR/etc/logging.conf.sample $KEYSTONE_CONF_DIR/logging.conf
     iniset $KEYSTONE_CONF_DIR/logging.conf logger_root level "DEBUG"
     iniset $KEYSTONE_CONF_DIR/logging.conf logger_root handlers "devel,production"
 
 }
 
d835de89
 # create_keystone_accounts() - Sets up common required keystone accounts
 
 # Tenant               User       Roles
 # ------------------------------------------------------------------
 # service              --         --
 # --                   --         Member
 # admin                admin      admin
 # demo                 admin      admin
 # demo                 demo       Member, anotherrole
 # invisible_to_admin   demo       Member
 
 # Migrated from keystone_data.sh
 create_keystone_accounts() {
 
     # admin
     ADMIN_TENANT=$(keystone tenant-create \
         --name admin \
         | grep " id " | get_field 2)
     ADMIN_USER=$(keystone user-create \
         --name admin \
         --pass "$ADMIN_PASSWORD" \
         --email admin@example.com \
         | grep " id " | get_field 2)
     ADMIN_ROLE=$(keystone role-create \
         --name admin \
         | grep " id " | get_field 2)
     keystone user-role-add \
         --user_id $ADMIN_USER \
         --role_id $ADMIN_ROLE \
         --tenant_id $ADMIN_TENANT
 
     # service
     SERVICE_TENANT=$(keystone tenant-create \
         --name $SERVICE_TENANT_NAME \
         | grep " id " | get_field 2)
 
     # The Member role is used by Horizon and Swift so we need to keep it:
     MEMBER_ROLE=$(keystone role-create --name=Member | grep " id " | get_field 2)
     # ANOTHER_ROLE demonstrates that an arbitrary role may be created and used
     # TODO(sleepsonthefloor): show how this can be used for rbac in the future!
     ANOTHER_ROLE=$(keystone role-create --name=anotherrole | grep " id " | get_field 2)
 
     # invisible tenant - admin can't see this one
     INVIS_TENANT=$(keystone tenant-create --name=invisible_to_admin | grep " id " | get_field 2)
 
     # demo
     DEMO_TENANT=$(keystone tenant-create \
         --name=demo \
         | grep " id " | get_field 2)
     DEMO_USER=$(keystone user-create \
         --name demo \
         --pass "$ADMIN_PASSWORD" \
         --email demo@example.com \
         | grep " id " | get_field 2)
     keystone user-role-add --user_id $DEMO_USER --role_id $MEMBER_ROLE --tenant_id $DEMO_TENANT
     keystone user-role-add --user_id $ADMIN_USER --role_id $ADMIN_ROLE --tenant_id $DEMO_TENANT
     keystone user-role-add --user_id $DEMO_USER --role_id $ANOTHER_ROLE --tenant_id $DEMO_TENANT
     keystone user-role-add --user_id $DEMO_USER --role_id $MEMBER_ROLE --tenant_id $INVIS_TENANT
 
     # Keystone
     if [[ "$KEYSTONE_CATALOG_BACKEND" = 'sql' ]]; then
         KEYSTONE_SERVICE=$(keystone service-create \
             --name keystone \
             --type identity \
             --description "Keystone Identity Service" \
             | grep " id " | get_field 2)
         keystone endpoint-create \
             --region RegionOne \
             --service_id $KEYSTONE_SERVICE \
c83a7e12
             --publicurl "$KEYSTONE_SERVICE_PROTOCOL://$KEYSTONE_SERVICE_HOST:$KEYSTONE_SERVICE_PORT/v2.0" \
             --adminurl "$KEYSTONE_AUTH_PROTOCOL://$KEYSTONE_AUTH_HOST:$KEYSTONE_AUTH_PORT/v2.0" \
             --internalurl "$KEYSTONE_SERVICE_PROTOCOL://$KEYSTONE_SERVICE_HOST:$KEYSTONE_SERVICE_PORT/v2.0"
d835de89
     fi
 
     # TODO(dtroyer): This is part of a series of changes...remove these when
     #                complete if they are really unused
 #    KEYSTONEADMIN_ROLE=$(keystone role-create \
 #        --name KeystoneAdmin \
 #        | grep " id " | get_field 2)
 #    KEYSTONESERVICE_ROLE=$(keystone role-create \
 #        --name KeystoneServiceAdmin \
 #        | grep " id " | get_field 2)
 
     # TODO(termie): these two might be dubious
 #    keystone user-role-add \
 #        --user_id $ADMIN_USER \
 #        --role_id $KEYSTONEADMIN_ROLE \
 #        --tenant_id $ADMIN_TENANT
 #    keystone user-role-add \
 #        --user_id $ADMIN_USER \
 #        --role_id $KEYSTONESERVICE_ROLE \
 #        --tenant_id $ADMIN_TENANT
 }
 
d81a0274
 # init_keystone() - Initialize databases, etc.
 function init_keystone() {
     # (Re)create keystone database
428af5a2
     recreate_database keystone utf8
d81a0274
 
     # Initialize keystone database
     $KEYSTONE_DIR/bin/keystone-manage db_sync
 
bc071bce
     if [[ "$KEYSTONE_TOKEN_FORMAT" == "PKI" ]]; then
         # Set up certificates
23431f35
         rm -rf $KEYSTONE_CONF_DIR/ssl
bc071bce
         $KEYSTONE_DIR/bin/keystone-manage pki_setup
 
         # Create cache dir
         sudo mkdir -p $KEYSTONE_AUTH_CACHE_DIR
91b8d13e
         sudo chown $STACK_USER $KEYSTONE_AUTH_CACHE_DIR
23431f35
         rm -f $KEYSTONE_AUTH_CACHE_DIR/*
bc071bce
     fi
d81a0274
 }
 
 # install_keystoneclient() - Collect source and prepare
 function install_keystoneclient() {
     git_clone $KEYSTONECLIENT_REPO $KEYSTONECLIENT_DIR $KEYSTONECLIENT_BRANCH
1b4b4be7
     setup_develop $KEYSTONECLIENT_DIR
d81a0274
 }
 
 # install_keystone() - Collect source and prepare
 function install_keystone() {
f127e2f3
     # only install ldap if the service has been enabled
     if is_service_enabled ldap; then
         install_ldap
     fi
d81a0274
     git_clone $KEYSTONE_REPO $KEYSTONE_DIR $KEYSTONE_BRANCH
1b4b4be7
     setup_develop $KEYSTONE_DIR
d81a0274
 }
 
 # start_keystone() - Start running processes, including screen
 function start_keystone() {
c83a7e12
     # Get right service port for testing
     local service_port=$KEYSTONE_SERVICE_PORT
     if is_service_enabled tls-proxy; then
         service_port=$KEYSTONE_SERVICE_PORT_INT
     fi
 
d81a0274
     # Start Keystone in a screen window
     screen_it key "cd $KEYSTONE_DIR && $KEYSTONE_DIR/bin/keystone-all --config-file $KEYSTONE_CONF $KEYSTONE_LOG_CONFIG -d --debug"
d835de89
     echo "Waiting for keystone to start..."
c83a7e12
     if ! timeout $SERVICE_TIMEOUT sh -c "while ! http_proxy= curl -s http://$SERVICE_HOST:$service_port/v2.0/ >/dev/null; do sleep 1; done"; then
07115eb5
       die $LINENO "keystone did not start"
d835de89
     fi
c83a7e12
 
     # Start proxies if enabled
     if is_service_enabled tls-proxy; then
         start_tls_proxy '*' $KEYSTONE_SERVICE_PORT $KEYSTONE_SERVICE_HOST $KEYSTONE_SERVICE_PORT_INT &
         start_tls_proxy '*' $KEYSTONE_AUTH_PORT $KEYSTONE_AUTH_HOST $KEYSTONE_AUTH_PORT_INT &
     fi
d81a0274
 }
 
 # stop_keystone() - Stop running processes
 function stop_keystone() {
     # Kill the Keystone screen window
     screen -S $SCREEN_NAME -p key -X kill
 }
7903b795
 
 # Restore xtrace
 $XTRACE
584d90ec
 
 # Local variables:
 # mode: shell-script
 # End: