Configuring Credentials

Credentials are stored at ~/.apigee-secure/credentials.yml. A template file is created that includes commented out attributes as placeholders for values that could be needed.

Credentials Location

The credentials.yml file has been placed in your user home which is typically referenced by ~/.apigee. This location has been selected because of the security it affords the user. Please note that the scripts expect to find the credentials.yml file in the folder ~/.apigee.

Required Credentials

The following table depicts those credentials that are required to complete an Apigee installation. If these are not provided, then the apigee installation scripts will prompt you for them. Given that this is an automated framework that will orchestrate your Apigee installation it is necessary to provide these attributes ahead of time in the ~/.apigee-secure/credentials.yml file.

Required AttributeValueDescription
apigee_repo_userAPIGEE_REPOSITORY_USERNAMEThe customer login to the software.apigee.com
apigee_repo_passwordAPIGEE_REPOSITORY_PASSWORDThe login password to software.apigee.com
opdk_user_nameapigeeThe Apigee administrator username and operating system username
opdk_group_nameapigeeThe operating system group name
opdk_user_emailAPIGEE_ADMIN_EMAILThe email address for the Apigee administrator
opdk_user_passAPIGEE_ADMIN_PASSWORDThe password used by the Apigee Administrator
opdk_cass_usernamecassandraThe Cassandra username
opdk_cass_passwordcassandraThe Cassandra password
opdk_ldap_passAPIGEE_LDAP_PASSWORDThe Apigee LDAP password
pg_useradminThe Postgres database administrator username
pg_passpostgresThe Postgres database administrator password

Optional Credentials

The following table depicts those credentials that are not a part of the Apigee installation. These can be provided here or they may be provided by any of the other mechanisms that Ansible uses to accept parameters such as vars_files, -e ATTRIBUTE_NAME=ATTRIBUTE_VALUE, an inventory file or a group or host variable files.

Optional AttributeValueDescription
service_account_authorization_token“Basic BASE64_ENCODED_USERNAME_PASSWORD”Authorization header value to be used when registering the instance with Cyberark
aws_access_keyAWS_ACCESS_KEYAWS access key
aws_secret_keyAWS_SECRETAWS secret
aws_regionAWS_REGIONAWS region
security_groupAWS_SECURITY_GROUP_NAMEAWS security group name
key_nameAWS_KEY_PAIR_NAMEAWS key pair name used for access
grafana_usernameGRAFANA_USERNAMEUsed if installing the Apigee monitoring dashboard
grafana_passwordGRAFANA_PASSWORDUsed if installing the Apigee monitoring dashboard
opdk_smtp_userSMTP_USERNAMEUsername of the SMTP server that Edge will use to send notifications to developers
opdk_smtp_passwordSMTP_PasswordPassword for the SMTP server that Edge will use to send notifications to developers
baas_admin_nameBAAS_ADMIN_NAMEThe Apigee Baas administrator username, please note that baas_admin_email cannot be the same as baas_superuser_email
baas_admin_passwordBAAS_ADMIN_PASSWORDThe Apigee Baas administrator password
baas_admin_emailBAAS_ADMIN_EMAILThe Apigee Baas administrator email
baas_admin_passBAAS_ADMIN_PASSThe Apigee Baas administrator email password
baas_superuser_emailBAAS_SUPERUSER_EMAILEmail of the Baas Superuser, please note that baas_superuser_email cannot be the same as baas_admin_email
baas_superuser_nameBAAS_SUPERUSER_NAMEName of the Baas Superuser
baas_superuser_passBAAS_SUPERUSER_PASSWORDPassword of the Baas Superuser
baas_smtp_userBAAS_SMTP_USERUsername of the SMTP server that Baas will use to send notifications to developers
baas_smtp_user_passBAAS_SMTP_USER_PASSPassword for the SMTP server that Baas will use to send notification to developers