Configuration

The provisioner attempts to read its configuration first from /etc/txamqpprovisioners/provisioners.cfg, then from $HOME/.txamqpprovisionersrc/provisioners.cfg, and finally from any configuration specified on the command line. Settings from files specified on the command line override any settings found in homedir settings, which override any system settings.

In this manner, common settings can be specified for all provisioners on a particular system, and individual configurations can add or override settings for specific provisioners.

The configuration sections and options are below.

• APPLICATION

  • log_level: Set the global log level for the service. May be overriden in other sections.

  • provisioner: The tag used to identify the provisioner back end to use. Possible backends include:

    • kiki: The PDS provisioner.
    • ldap: The LDAP provisioner backend.
    • o365_provisioner: Microsoft Office 365 REST provisioner.

• AMQP

  • log_level
  • endpoint: Client endpoint connection string. See Twisted endpoints for clients Examples: tcp:host=localhost:port=5672, tls:host=grouper.example.edu:port=5671:trustRoots=/etc/grouper/ssl/ca:endpoint=tcp:localhost:5671
  • vhost: The virtual host on the AMQP service to which this service connects.
  • user: The username credential used to access the AMQP service.
  • passwd: The password credential used to access the AMQP service.
  • queue: The queue from which the provisioner reads messages.

• SSH

  • endpoint: Service endpoint string for SSH admin service. E.g. tcp:2023.
  • group: Local group an account must belong to in order to access the administrative interface.

• PROVISIONER (see below)

Provisioner Back Ends

The selected provisioner is configured under the PROVISIONER section. The options vary depending on the provisioner.